| パッケージ | mx.core |
| クラス | public class SpriteAsset |
| 継承 | SpriteAsset FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 実装 | IFlexAsset, IFlexDisplayObject, IBorder |
| サブクラス | DefaultDragImage |
SVG ファイルのベクターグラフィックイメージを埋め込むことができます。Flash によって作成された SWF ファイルのスプライトシンボルを埋め込むこともできます。いずれの場合も、MXML コンパイラは、埋め込まれたベクターグラフィックイメージを表すように SpriteAsset を拡張するクラスを自動生成します。
通常は、Flex アプリケーションを作成するときに SpriteAsset クラスを直接使用する必要はありません。例えば、次のように記述すると、SWF ファイルからスプライトシンボルを埋め込み、Image コントロールに表示することができます。
<mx:Image id="logo" source="@Embed(source='Assets.swf', symbol='Logo')"/>
または、次のように記述することにより、CSS シンタックスの中でアプリケーションの背景イメージとして使用できます。
<mx:Style>
Application
{
backgroundImage: Embed(source="Assets.swf", symbol='Logo')
}
<mx:Style/>
MXML コンパイラによって BitmapAsset のサブクラスが作成されたことを認識しておく必要はありません。
ただし、ActionScript レベルで何が行われているのかを理解しておくことは有益です。ベクターグラフィックイメージを ActionScript に埋め込むには、Class 型の変数を宣言し、それに [Embed] メタデータを入れます。例えば、次のようにして SWF ファイルからスプライトシンボルを埋め込みます。
[Bindable] [Embed(source="Assets.swf", symbol="Logo")] private var logoClass:Class;
MXML コンパイラは、Assets.swf の Logo シンボルがスプライトであることを確認し、それを表す SpriteAsset クラスのサブクラスを自動生成し、この自動生成されたクラスへの参照を変数に設定します。これにより、このクラス参照を使用して、new 演算子で SpriteAsset のインスタンスを作成できるようになります。また、作成したインスタンスで Sprite クラスの API を使用することもできます。
var logo:SpriteAsset = SpriteAsset(new logoClass()); logo.rotation=45;
ただし、SpriteAsset インスタンスを自分で作成する必要はほとんどありません。イメージ関連のプロパティおよびスタイルをイメージ生成クラスに設定すると、コンポーネントが必要に応じてイメージインスタンスを作成します。 例えば、このベクターグラフィックイメージを Image コントロールに表示するために、Image の source プロパティを logoClass に設定することができます。 MXML では、次のようにします。
<mx:Image id="logo" source="{logoClass}"/>
| プロパティ | 定義元 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。 | DisplayObject | |
![]() | alpha : Number
指定されたオブジェクトのアルファ透明度値を示します。 | DisplayObject | |
![]() | blendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。 | DisplayObject | |
![]() | blendShader : Shader [書き込み専用]
前景と背景のブレンドに使用するシェーダを設定します。 | DisplayObject | |
| borderMetrics : EdgeMetrics [読み取り専用]
left、top、right、bottom の 4 つのプロパティを持つ、境界線の EdgeMetrics オブジェクトを返します。 | SpriteAsset | ||
![]() | buttonMode : Boolean
このスプライトのボタンモードを指定します。 | Sprite | |
![]() | cacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player または Adobe AIR にキャッシュされます。 | DisplayObject | |
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
![]() | contextMenu : NativeMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。 | InteractiveObject | |
![]() | doubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。 | InteractiveObject | |
![]() | dropTarget : DisplayObject [読み取り専用]
スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。 | Sprite | |
![]() | filters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。 | DisplayObject | |
![]() | focusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。 | InteractiveObject | |
![]() | graphics : Graphics [読み取り専用]
ベクターの描画コマンドが発生するこのスプライトに属する Graphics オブジェクトを指定します。 | Sprite | |
![]() | height : Number
表示オブジェクトの高さを示します (ピクセル単位)。 | DisplayObject | |
![]() | hitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。 | Sprite | |
![]() | loaderInfo : LoaderInfo [読み取り専用]
この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。 | DisplayObject | |
![]() | mask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。 | DisplayObject | |
| measuredHeight : Number [読み取り専用]
このオブジェクトの測定した高さです。 | SpriteAsset | ||
| measuredWidth : Number [読み取り専用]
このオブジェクトの測定した幅です。 | SpriteAsset | ||
![]() | mouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。 | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。 | InteractiveObject | |
![]() | mouseX : Number [読み取り専用]
マウス位置の x 座標を示します(ピクセル単位)。 | DisplayObject | |
![]() | mouseY : Number [読み取り専用]
マウス位置の y 座標を示します(ピクセル単位)。 | DisplayObject | |
![]() | name : String
DisplayObject のインスタンス名を示します。 | DisplayObject | |
![]() | numChildren : int [読み取り専用]
このオブジェクトの子の数を返します。 | DisplayObjectContainer | |
![]() | opaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。 | DisplayObject | |
![]() | parent : DisplayObjectContainer [読み取り専用]
この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。 | DisplayObject | |
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
![]() | root : DisplayObject [読み取り専用]
読み込まれた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。 | DisplayObject | |
![]() | rotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。 | DisplayObject | |
![]() | rotationX : Number
DisplayObject インスタンスの 3D 親コンテナを基準にした元の位置からの x 軸の回転角を度単位で示します。 | DisplayObject | |
![]() | rotationY : Number
DisplayObject インスタンスの 3D 親コンテナを基準にした元の位置からの y 軸の回転角を度単位で示します。 | DisplayObject | |
![]() | rotationZ : Number
DisplayObject インスタンスの 3D 親コンテナを基準にした元の位置からの z 軸の回転角を度単位で示します。 | DisplayObject | |
![]() | scale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。 | DisplayObject | |
![]() | scaleX : Number
基準点から適用されるオブジェクトの水平スケール(パーセンテージ)を示します。 | DisplayObject | |
![]() | scaleY : Number
オブジェクトの基準点から適用されるオブジェクトの垂直スケール(percentage)を示します。 | DisplayObject | |
![]() | scaleZ : Number
オブジェクトの基準点から適用されるオブジェクトの奥行きスケール(パーセンテージ)を示します。 | DisplayObject | |
![]() | scrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。 | DisplayObject | |
![]() | soundTransform : SoundTransform
このスプライト内のサウンドを制御します。 | Sprite | |
![]() | stage : Stage [読み取り専用]
表示オブジェクトのステージです。 | DisplayObject | |
![]() | tabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。 | DisplayObjectContainer | |
![]() | tabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。 | InteractiveObject | |
![]() | tabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。 | InteractiveObject | |
![]() | textSnapshot : TextSnapshot [読み取り専用]
この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。 | DisplayObjectContainer | |
![]() | transform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。 | DisplayObject | |
![]() | useHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。 | Sprite | |
![]() | visible : Boolean
表示オブジェクトが可視かどうかを示します。 | DisplayObject | |
![]() | width : Number
表示オブジェクトの幅を示します (ピクセル単位)。 | DisplayObject | |
![]() | x : Number
親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの x 座標を示します。 | DisplayObject | |
![]() | y : Number
親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの y 座標を示します。 | DisplayObject | |
![]() | z : Number
3D 親コンテナを基準にした、DisplayObject インスタンスの z 軸に沿った z 座標位置を示します。 | DisplayObject | |
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクタです。 | SpriteAsset | ||
![]() |
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。 | DisplayObjectContainer | |
![]() |
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。 | DisplayObjectContainer | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
![]() |
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。 | DisplayObjectContainer | |
![]() |
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。 | DisplayObjectContainer | |
![]() |
イベントをイベントフローに送出します。 | EventDispatcher | |
![]() |
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。 | DisplayObject | |
![]() |
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。 | DisplayObjectContainer | |
![]() |
指定された名前に一致する子表示オブジェクトを返します。 | DisplayObjectContainer | |
![]() |
子 DisplayObject インスタンスのインデックス位置を返します。 | DisplayObjectContainer | |
![]() |
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子 (または孫など) であるオブジェクトの配列を返します。 | DisplayObjectContainer | |
![]() |
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。 | DisplayObject | |
![]() |
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。 | DisplayObject | |
![]() |
ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。 | DisplayObject | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。 | DisplayObject | |
![]() |
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。 | DisplayObject | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。 | DisplayObject | |
![]() |
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。 | DisplayObject | |
このオブジェクトを指定の x および y 座標に移動します。 | SpriteAsset | ||
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。 | DisplayObjectContainer | |
![]() |
DisplayObjectContainer の子リストの指定された index 位置から子 DisplayObject を削除します。 | DisplayObjectContainer | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
このオブジェクトの実際のサイズを設定します。 | SpriteAsset | ||
![]() |
表示オブジェクトコンテナの既存の子の位置を変更します。 | DisplayObjectContainer | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
指定されたスプライトをユーザーがドラッグできるようにします。 | Sprite | |
![]() |
startDrag() メソッドを終了します。 | Sprite | |
![]() |
指定された 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。 | DisplayObjectContainer | |
![]() |
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。 | DisplayObjectContainer | |
![]() | [override]
アプリケーションの DisplayObject の階層におけるこのオブジェクトの位置を示すストリングを返します。 | FlexSprite | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| borderMetrics | プロパティ |
borderMetrics:EdgeMetrics [読み取り専用]
left、top、right および bottom の4 つのプロパティを持つ、境界線の EdgeMetrics オブジェクトを返します。各プロパティの値は、境界線の 1 辺の太さをピクセル単位で表したものです。
public function get borderMetrics():EdgeMetrics| measuredHeight | プロパティ |
measuredHeight:Number [読み取り専用] このオブジェクトの測定した高さです。
この数字は単なるグラフィックのピクセル数であるため、グラフィカルスキンの場合、これは通常ハードコードになります。コードスキンの場合も、一定のサイズで描画する場合はハードコードにできます。 プロパティに応じてサイズが変わる場合は、ILayoutManagerClient により、適切なタイミングで measure() メソッドを呼び出して、measuredHeight を計算することもできます。
public function get measuredHeight():Number| measuredWidth | プロパティ |
measuredWidth:Number [読み取り専用] このオブジェクトの測定した幅です。
この数字は単なるグラフィックのピクセル数であるため、グラフィカルスキンの場合、これは通常ハードコードになります。コードスキンの場合も、一定のサイズで描画する場合はハードコードにできます。 プロパティに応じてサイズが変わる場合は、ILayoutManagerClient により、適切なタイミングで measure() メソッドを呼び出して、measuredHeight を計算することもできます。
public function get measuredWidth():Number| SpriteAsset | () | コンストラクタ |
public function SpriteAsset()コンストラクタです。
| move | () | メソッド |
public function move(x:Number, y:Number):voidこのオブジェクトを指定の x および y 座標に移動します。
パラメータ
x:Number — このオブジェクトの新しい x 位置です。
| |
y:Number — このオブジェクトの新しい y 位置です。
|
| setActualSize | () | メソッド |
public function setActualSize(newWidth:Number, newHeight:Number):voidこのオブジェクトの実際のサイズを設定します。
このメタデータは主に updateDisplayList() メソッドの実装に使用されます。ここでオブジェクトの実際のサイズを、その明示的サイズ、親との相対 (%) サイズ、および測定されたサイズに基づいて計算します。次に setActualSize() () を呼び出して、この実際のサイズをオブジェクトに適用します。
その他の状況では、このメソッドを呼び出す代わりに、width、height、percentWidth、percentHeight などのプロパティを設定することになります。
パラメータ
newWidth:Number — このオブジェクトの新しい幅です。
| |
newHeight:Number — このオブジェクトの新しい高さです。
|
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/core/SpriteAsset.html