BitmapAsset

パッケージ	mx.core
クラス	public class BitmapAsset
継承	BitmapAsset FlexBitmap Bitmap DisplayObject EventDispatcher Object
実装	IFlexAsset, IFlexDisplayObject, ILayoutDirectionElement

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

BitmapAsset は、Flex アプリケーションに埋め込まれたビットマップイメージを表す flash.display.Bitmap クラスのサブクラスです。これにより IFlexDisplayObject インターフェイスが実装され、埋め込まれたビットマップイメージを Image コントロールで表示すること、またはコンテナの背景やコンポーネントスキンとして使用することが可能になります。

JPEG、GIF、PNG ファイルのビットマップイメージを埋め込むことができます。Flash によって作成された SWF ファイルのビットマップイメージを埋め込むこともできます。いずれの場合も、MXML コンパイラーは、埋め込まれたビットマップイメージを表すように BitmapAsset を拡張するクラスを自動生成します。

通常は、Flex アプリケーションを作成するときに BitmapAsset クラスを直接使用する必要はありません。例えば、次のように記述すると、GIF ファイルを埋め込み、Image コントロールにイメージを表示することができます。

  <mx:Image id="logo" source="@Embed(source='Logo.gif')"/>

または、次のように記述することにより、CSS シンタックスの中でアプリケーションの背景イメージとして使用できます。

  <fx:Style>
      @namespace mx "library://ns.adobe.com/flex/mx"
      mx|Application {
          backgroundImage: Embed(source="Logo.gif")
      }
  <fx:Style/>

MXML コンパイラーによって BitmapAsset のサブクラスが作成されたことを認識しておく必要はありません。

ただし、ActionScript レベルで何が行われているのかを理解しておくことは有益です。ビットマップイメージを ActionScript に埋め込むには、Class 型の変数を宣言し、この変数の前に [Embed] メタデータを挿入します。例えば、次のようにして GIF ファイルを埋め込みます。

  [Bindable]
  [Embed(source="Logo.gif")]
  private var logoClass:Class;

MXML コンパイラーは、拡張子 .gif を確認し、GIF データを Player が使用するビットマップ形式にトランスコードして、BitmapAsset クラスのサブクラスを自動生成し、この自動生成されたクラスへの参照を変数に設定します。これにより、このクラス参照を使用して new 演算子で BitmapAsset のインスタンスを作成し、作成したインスタンスで BitmapAsset クラスの API を使用できるようになります。

  var logo:BitmapAsset = BitmapAsset(new logoClass());
  logo.bitmapData.noise(4);

ただし、BitmapAsset インスタンスを自分で作成する必要はほとんどありません。イメージ関連のプロパティおよびスタイルをイメージ生成クラスに設定すると、コンポーネントが必要に応じてイメージインスタンスを作成します。例えば、このイメージを Image コントロールに表示するために、Image の source プロパティを logoClass に設定することができます。 MXML では、次のようにします。

  <mx:Image id="logo" source="{logoClass}"/>

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		accessibilityProperties : AccessibilityProperties この表示オブジェクトの現在のアクセシビリティオプションです。	DisplayObject
		alpha : Number 指定されたオブジェクトのアルファ透明度値を示します。	DisplayObject
		bitmapData : BitmapData BitmapData オブジェクトが参照されます。	Bitmap
		blendMode : String 使用するブレンドモードを指定する BlendMode クラスの値です。	DisplayObject
		blendShader : Shader [書き込み専用] 前景と背景のブレンドに使用するシェーダーを設定します。	DisplayObject
		cacheAsBitmap : Boolean true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash ランタイムにキャッシュされます。	DisplayObject
		cacheAsBitmapMatrix : Matrix null 以外の場合、この Matrix オブジェクトは、cacheAsBitmap を true に設定したときの表示オブジェクトのレンダリング方法を定義します。	DisplayObject
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		filters : Array 表示オブジェクトに現在関連付けられている各フィルターオブジェクトが格納されているインデックス付きの配列です。	DisplayObject
		height : Number 表示オブジェクトの高さを示します（ピクセル単位）。	DisplayObject
		layoutDirection : String エレメントの任意のレイアウト方向を指定します。LayoutDirection.LTR（左から右）、LayoutDirection.RTL（右から左）または null（継承する）のいずれかを指定します。	BitmapAsset
		loaderInfo : LoaderInfo [読み取り専用] この表示オブジェクトが属するファイルの読み込み情報を含む LoaderInfo オブジェクトを返します。	DisplayObject
		mask : DisplayObject 呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。	DisplayObject
		measuredHeight : Number [読み取り専用] このオブジェクトの測定した高さです。	BitmapAsset
		measuredWidth : Number [読み取り専用] このオブジェクトの測定した幅です。	BitmapAsset
		metaData : Object メタデータが PlaceObject4 タグによってこの DisplayObject のインスタンスと一緒に SWF ファイル内に保存されている場合に、DisplayObject インスタンスのメタデータオブジェクトを取得します。	DisplayObject
		mouseX : Number [読み取り専用] マウスまたはユーザー入力デバイスの x 軸の位置をピクセルで示します。	DisplayObject
		mouseY : Number [読み取り専用] マウスまたはユーザー入力デバイスの y 軸の位置をピクセルで示します。	DisplayObject
		name : String DisplayObject のインスタンス名を示します。	DisplayObject
		opaqueBackground : Object 表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。	DisplayObject
		parent : DisplayObjectContainer [読み取り専用] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。	DisplayObject
		pixelSnapping : String Bitmap オブジェクトが最も近いピクセルに吸着されるかどうかを指定します。	Bitmap
		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 オブジェクトの基準点から適用されるオブジェクトの垂直スケール（パーセンテージ）を示します。	DisplayObject
		scaleZ : Number オブジェクトの基準点から適用されるオブジェクトの奥行きスケール（パーセンテージ）を示します。	DisplayObject
		scrollRect : Rectangle 表示オブジェクトのスクロール矩形の境界です。	DisplayObject
		smoothing : Boolean ビットマップを拡大 / 縮小するときにスムージングするかどうかを指定します。	Bitmap
		stage : Stage [読み取り専用] 表示オブジェクトのステージです。	DisplayObject
		transform : flash.geom:Transform 表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。	DisplayObject
		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

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false) コンストラクターです。	BitmapAsset
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle シェイプ上の線を除き、targetCoordinateSpace パラメーターによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。	DisplayObject
		globalToLocal(point:Point):Point point オブジェクトをステージ（グローバル）座標から表示オブジェクトの（ローカル）座標に変換します。	DisplayObject
		globalToLocal3D(point:Point):Vector3D ステージ（グローバル）座標の 2 次元のポイントを 3 次元の表示オブジェクトの（ローカル）座標に変換します。	DisplayObject
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		hitTestObject(obj:DisplayObject):Boolean 表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 表示オブジェクトを評価して、x および y パラメーターで指定されたポイントと重複または交差するかどうかを調べます。	DisplayObject
		invalidateLayoutDirection():void エレメントの layoutDirection を変更する場合、または親エレメントの layoutDirection を変更する場合は、エレメントでこのメソッドを呼び出す必要があります。	BitmapAsset
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		local3DToGlobal(point3d:Vector3D):Point 3 次元の表示オブジェクトの（ローカル）座標の 3 次元のポイントをステージ（グローバル）座標の 2 次元のポイントに変換します。	DisplayObject
		localToGlobal(point:Point):Point point オブジェクトを表示オブジェクトの（ローカル）座標からステージ（グローバル）座標に変換します。	DisplayObject
		move(x:Number, y:Number):void このオブジェクトを指定の x および y 座標に移動します。	BitmapAsset
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setActualSize(newWidth:Number, newHeight:Number):void このオブジェクトの実際のサイズを設定します。	BitmapAsset
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String [オーバーライド] アプリケーションの DisplayObject の階層におけるこのオブジェクトの位置を示すストリングを返します。	FlexBitmap
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
added	表示オブジェクトが表示リストに追加されたときに送出されます。	DisplayObject
addedToStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。	DisplayObject
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
enterFrame	[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。	DisplayObject
exitFrame	[ブロードキャストイベント] 再生ヘッドが現在のフレームを終了するときに送出されます。	DisplayObject
frameConstructed	[ブロードキャストイベント] フレーム表示オブジェクトのコンストラクターが実行した後で、かつフレームスクリプトが実行される前に送出されます。	DisplayObject
removed	表示オブジェクトが表示リストから削除されようとしているときに送出されます。	DisplayObject
removedFromStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。	DisplayObject
render	[ブロードキャストイベント] 表示リストが更新およびレンダリングされようとしているときに送出されます。	DisplayObject

プロパティの詳細

layoutDirection

プロパティ

layoutDirection:String

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4.1

ランタイムバージョン:

Flash Player 10, AIR 1.5

エレメントの任意のレイアウト方向を指定します。LayoutDirection.LTR（左から右）、LayoutDirection.RTL（右から左）または null（継承する）のいずれかを指定します。通常、このプロパティには、継承されたスタイルが返されます。null の場合、layoutDirection スタイルは undefined に設定されます。GraphicElement のように、ILayoutDirectionElement が実装されていてもスタイルがサポートされていないクラスでは、このプロパティの null 値を追加サポートして、layoutDirection が親エレメントから継承されるように処理する必要があります。

実装
public function get layoutDirection():String
public function set layoutDirection(value:String):void

measuredHeight

プロパティ

measuredHeight:Number [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このオブジェクトの測定した高さです。

この数字は単なるグラフィックのピクセル数であるため、グラフィカルスキンの場合、これは通常ハードコードになります。コードスキンの場合も、一定のサイズで描画する場合はハードコードにできます。プロパティに応じてサイズが変わる場合は、ILayoutManagerClient により、適切なタイミングで measure() メソッドを呼び出して、measuredHeight を計算することもできます。

実装
public function get measuredHeight():Number

measuredWidth

プロパティ

measuredWidth:Number [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このオブジェクトの測定した幅です。

実装
public function get measuredWidth():Number

コンストラクターの詳細

()

コンストラクター

public function BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

コンストラクターです。

パラメーター

	`bitmapData:BitmapData` (default = `null`) — ビットマップイメージのデータです。

	`pixelSnapping:String` (default = "`auto`") — ビットマップが最も近いピクセルに吸着されるかどうかを示します。

	`smoothing:Boolean` (default = `false`) — ビットマップを拡大／縮小するときにスムージングするかどうかを示します。

メソッドの詳細

invalidateLayoutDirection

()

メソッド

public function invalidateLayoutDirection():void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4.1

ランタイムバージョン:

Flash Player 10, AIR 1.5

エレメントの layoutDirection を変更する場合、または親エレメントの layoutDirection を変更する場合は、エレメントでこのメソッドを呼び出す必要があります。これらが異なっている場合、このメソッドによって、ミラーされた座標系が下位要素に継承されるよう、エレメントの内容のミラーとエレメントのレイアウト後の変換の更新が処理されます。IVisualElement では、通常、postLayoutTransformOffsets を使用して、X 軸を -1 でスケール設定し、原点の x 座標をエレメントの幅分、平行移動することでミラーを実装します。この「ミラー」変換の最終的な結果は、親エレメントの原点を基準とするエレメントの相対的な位置を変更しないで、X 軸の増加方向を逆転したものになります。

move

()

メソッド

public function move(x:Number, y:Number):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このオブジェクトを指定の x および y 座標に移動します。

パラメーター

	`x:Number` — このオブジェクトの新しい x 位置です。

	`y:Number` — このオブジェクトの新しい y 位置です。

setActualSize

()

メソッド

public function setActualSize(newWidth:Number, newHeight:Number):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このオブジェクトの実際のサイズを設定します。

このメソッドは主に updateDisplayList() メソッドの実装に使用されます。ここでオブジェクトの実際のサイズを、その明示的サイズ、親との相対（％）サイズ、および測定されたサイズに基づいて計算します。次に setActualSize() を呼び出して、この実際のサイズをオブジェクトに適用します。

その他の状況では、このメソッドを呼び出す代わりに、width、height、percentWidth、percentHeight などのプロパティを設定することになります。

パラメーター

	`newWidth:Number` — このオブジェクトの新しい幅です。

	`newHeight:Number` — このオブジェクトの新しい高さです。

法律上の注意 | プライバシーポリシー

BitmapAsset - AS3 Flex

クラス x

layoutDirection

measuredHeight

measuredWidth

BitmapAsset

invalidateLayoutDirection

move

setActualSize