SpriteVisualElement  - AS3 Flex

アンカーターゲットからコントロールのベースライン位置までの垂直距離（ピクセル単位）です。

デフォルトでは、アンカーターゲットはコンテナのコンテンツ領域の上端です。拡張制約が設定されたレイアウトでは、ターゲットを制約行にできます。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "anchorTargetName:value" という形式で設定します。例えば、"row1:10" のように設定します。

コンポーネントのテキストにおける 1 行目のベースラインの y 座標です。

このプロパティは、baseline 制約スタイルを実装するために使用します。 また、FormItem のラベルを FormItem 内のコントロールに合わせて配置するためにも使用します。

このプロパティは、各コンポーネントによってオーバーライドされます。

使用するブレンドモードを指定する BlendMode クラスの値です。

デフォルト値： auto。

関連する API エレメント

コンポーネントの下端からアンカーターゲットの下端までの垂直距離（ピクセル単位）です。

デフォルトでは、アンカーターゲットはコンテナのコンテンツ領域です。拡張制約が設定されたレイアウトでは、ターゲットを制約行にできます。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "anchorTargetName:value" という形式で設定します。例えば、"row1:10" のように設定します。

コンテナ内のアイテムのレンダリング順序を決定します。Spark コンテナ内のアイテムのレンダリング順序は、depth プロパティに基づいて決定されます。値が最も低い depth のアイテムは背景に配置され、高くなるほど前面に配置されます。奥行き値が同じアイテムは、コンテナに追加された順に表示されます。

このビジュアルエレメントに関連付けるオプションの DesignLayer インスタンスを指定します。

DesignLayer が割り当てられたビジュアルエレメントは、関連の DisplayObject（ある場合）に自身の有効な可視性またはアルファを最終的にコミットする際、親レイヤーの可視性とアルファを考慮する必要があります。

ビジュアルエレメントは、関連付けられている親レイヤーからの layerPropertyChange 通知をリッスンする必要があります。レイヤーの effectiveAlpha または effectiveVisibility が変更された場合、エレメントは自身の有効な可視性（アルファ）を計算して、適宜適用する必要があります。

このプロパティは MXML 内に直接設定することはできません。

designLayer プロパティは z 順序のコントロールには使用できません。depth を参照してください。

エレメントが 3D マトリックスを持つ場合は true です。

エレメントが 2D でも有効なマトリックスが返されるので、getLayoutMatrix3D() を呼び出して戻り値を確認する代わりに、hasLayoutMatrix3D を使用します。

コンポーネントの中心からアンカーターゲットのコンテンツ領域の中心までの水平距離（ピクセル単位）です。

デフォルトのアンカーターゲットはコンテナ自体です。

拡張制約が設定されたレイアウトでは、アンカーターゲットを制約列にできます。この場合、コンテンツ領域は、先行する列（またはコンテナ側）とターゲット列の間隔になります。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "constraintColumnId:value" という形式で設定します。例えば、"col1:10" のように設定します。

コンポーネントの ID です。

このコンポーネントを親コンテナのレイアウトに含めるかどうかを指定します。 true の場合、オブジェクトは、親コンテナのレイアウトに含められます。オブジェクトのサイズと位置は、親コンテナによって、そのレイアウト規則に従って決定されます。false の場合、オブジェクトのサイズと位置は、親コンテナのレイアウトの影響を受けません。

エレメントが 3D の場合は true です。3D 変換プロパティまたは 3D レイアウト後変換オフセット（または両方）がある場合、エレメントは 3D になります。

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

コンポーネントの左端からアンカーターゲットの左端までの水平距離（ピクセル単位）です。

デフォルトでは、アンカーターゲットはコンテナのコンテンツ領域です。拡張制約が設定されたレイアウトでは、ターゲットを制約列にできます。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "anchorTargetName:value" という形式で設定します。例えば、"col1:10" のように設定します。

マスクされたコンテンツを輝度マスクがクリッピングするかどうかを制御するプロパティです。このプロパティが有効になるのは、グラフィックエレメントに MaskType.LUMINOSITY というタイプのマスクが適用されている場合のみです。

輝度マスクによってマスクされているグラフィックエレメントの RGB カラー値の計算を制御するプロパティです。true の場合、ソースコンテンツのピクセルの RGB カラー値が、マスク内の対応する領域によって反転されて乗算されます。false の場合、ソースコンテンツのピクセルの RGB カラー値が直接使用されます。

マスクを設定します。マスクは表示リストに追加されます。マスクは、表示リストにもエレメント配列にも既に存在していない必要があります。

マスクのタイプです。可能な値は、MaskType.CLIP、MaskType.ALPHA または MaskType.LUMINOSITY です。

クリップマスク

クリップモードでマスクを適用すると、クリッピングマスクが 1 ビットに減らされます。つまり、マスクはソースコンテンツのピクセルの不透明度に影響しません。マスクの対応するピクセルのアルファ値がゼロ以外の場合この値は変更されず、マスクのピクセルのアルファ値がゼロの場合は完全に透明になります。

アルファマスク

アルファモードでは、ソースコンテンツの各ピクセルの不透明度に、マスクの対応する領域の不透明度が乗算されます。つまり、不透明度が 1 に設定されたソースコンテンツのピクセルが、不透明度 0.5 の領域でマスクされると、最終的な不透明度は 0.5 になります。不透明度が 0.8 のソースピクセルが不透明度 0.5 の領域でマスクされると、最終的な不透明度は 0.4 になります。

輝度マスキング

"soft mask" と呼ばれることもある輝度マスクは、ソースコンテンツのピクセルの不透明度と RGB カラー値の両方がマスクの対応する領域の不透明度と RGB カラー値で乗算される点以外は、アルファマスクと非常によく似た働きをします。

輝度マスキングは Flash ネイティブではありませんが、Adobe Illustrator や Adobe Photoshop などの Adobe Creative Suite ツールで共通の機能です。Flash でレンダリングされるコンテンツの輝度マスクの視覚効果を実現するために、輝度マスクを指定するグラフィックエレメントでは、Adobe Creative Suite ツールでレンダリングされる輝度マスクの外観表示を模倣するシェーダーフィルターを実際にインスタンス化しています。

輝度マスクによってマスクされているオブジェクトは、RGB カラー値とマスクのクリッピングを制御するプロパティを設定できます。luminosityInvert 属性および luminosityClip 属性を参照してください。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

モジュールファクトリは、埋め込みフォントの使用時や、このコンポーネントのスタイル制御を行うスタイルマネージャーの検出時に、コンテキストとして使用されるものです。

この IVisualElement オブジェクトのオーナーです。デフォルトは、この IVisualElement オブジェクトの親です。ただし、この IVisualElement オブジェクトが、ComboBox コントロールのドロップダウンリストのように、親によってポップアップされた子コンポーネントである場合は、この IVisualElement オブジェクトをポップアップしたコンポーネントがオーナーになります。

このプロパティは、Flex ではなく、各コンポーネントによって管理されます。したがって、PopUpManger.createPopUp() メソッドまたは PopUpManger.addPopUp() メソッドを使用して子コンポーネントをポップアップする場合、子コンポーネントの owner プロパティは、それをポップアップしたコンポーネントに設定する必要があります。

デフォルト値は、parent プロパティの値です。

コンポーネントの高さを親のサイズに対する比率（パーセンテージ）で指定します。指定できる値は 0 ～ 100 です。 height プロパティまたは explicitHeight プロパティを設定すると、このプロパティが NaN にリセットされます。

このプロパティは、前に設定されている場合にのみ数値を返します。コンポーネントの正確なサイズをパーセンテージで示しているわけではありません。

コンポーネントの幅を親のサイズに対する比率（パーセンテージ）で指定します。指定できる値は 0 ～ 100 です。 デフォルト値は NaN です。 width プロパティまたは explicitWidth プロパティを設定すると、このプロパティが NaN にリセットされます。

このプロパティは、前に設定されている場合にのみ数値を返します。コンポーネントの正確なサイズをパーセンテージで示しているわけではありません。

UITextField コントロールの場合、このプロパティは常に NaN に設定されます。

Spark レイアウトで使用した場合、このプロパティは、拡大 / 縮小後および回転後のコンポーネントの境界の幅の計算に使用されます。例えば、コンポーネントを 90°回転する場合、指定されている percentWidth はコンポーネントの高さに影響を与えます。

親のレイアウトに影響を与えない方法で、オブジェクトの変換に適用できる一連の調整を定義します。

例えば、90°回転するオブジェクトに合わせてレイアウトを調整する場合は、オブジェクトの rotation プロパティを設定します。回転するオブジェクトに合わせてレイアウトを調整しない場合は、postLayoutTransformOffsets.rotationZ プロパティを設定します。

コンポーネントの右端からアンカーターゲットの右端までの水平距離（ピクセル単位）です。

デフォルトでは、アンカーターゲットはコンテナのコンテンツ領域です。拡張制約が設定されたレイアウトでは、ターゲットを制約列にできます。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "anchorTargetName:value" という形式で設定します。例えば、"col1:10" のように設定します。

DisplayObject インスタンスの 3D 親コンテナを基準にした元の位置からの x 軸の回転角を度単位で示します。時計回りに回転させる場合は 0 ～ 180 の値を指定します。反時計回りに回転させる場合は 0 ～ -180 の値を指定します。この範囲を超える値は、360 を加算または減算して、範囲内に収まる値になるように調整されます。このプロパティは、Flex の 2D レイアウトによる計算時には無視されます。

DisplayObject インスタンスの 3D 親コンテナを基準にした元の位置からの y 軸の回転角を度単位で示します。時計回りに回転させる場合は 0 ～ 180 の値を指定します。反時計回りに回転させる場合は 0 ～ -180 の値を指定します。この範囲を超える値は、360 を加算または減算して、範囲内に収まる値になるように調整されます。このプロパティは、Flex の 2D レイアウトによる計算時には無視されます。

コンポーネントの上端からアンカーターゲットの上端までの垂直距離（ピクセル単位）です。

デフォルトでは、アンカーターゲットはコンテナのコンテンツ領域です。拡張制約が設定されたレイアウトでは、ターゲットを制約行にできます。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "anchorTargetName:value" という形式で設定します。例えば、"row1:10" のように設定します。

コンポーネントの変換の中心となる x 座標を設定します。

このオブジェクトが Spark 変換エフェクトのターゲットである場合、AnimateTransform.autoCenterTransform プロパティを設定することでこのプロパティをオーバーライドできます。autoCenterTransform が false の場合、変換の中心は、エフェクトターゲットの transformX、transformY および transformZ プロパティで決定されます。autoCenterTransform が true の場合、ターゲットの中心 (width/2, height/2) を中心にしてエフェクトが適用されます。

Spark エフェクトクラスでこのプロパティを設定すると、ターゲットオブジェクトでの設定がオーバーライドされます。

関連する API エレメント

コンポーネントの変換の中心となる y 座標を設定します。

このオブジェクトが Spark 変換エフェクトのターゲットである場合、AnimateTransform.autoCenterTransform プロパティを設定することでこのプロパティをオーバーライドできます。autoCenterTransform が false の場合、変換の中心はエフェクトのターゲットの transformY、transformY、および transformZ プロパティによって決定されます。autoCenterTransform が true の場合、ターゲットの中心 (width/2, height/2) を中心にしてエフェクトが適用されます。

Spark エフェクトクラスでこのプロパティを設定すると、ターゲットオブジェクトでの設定がオーバーライドされます。

関連する API エレメント

コンポーネントの変換の中心となる z 座標を設定します。

このオブジェクトが Spark 変換エフェクトのターゲットである場合、AnimateTransform.autoCenterTransform プロパティを設定することでこのプロパティをオーバーライドできます。autoCenterTransform が false の場合、変換の中心はエフェクトのターゲットの transformZ、transformY、および transformZ プロパティによって決定されます。autoCenterTransform が true の場合、ターゲットの中心 (width/2, height/2) を中心にしてエフェクトが適用されます。

Spark エフェクトクラスでこのプロパティを設定すると、ターゲットオブジェクトでの設定がオーバーライドされます。

関連する API エレメント

コンポーネントの中心からアンカーターゲットのコンテンツ領域の中心までの垂直距離（ピクセル単位）です。

デフォルトのアンカーターゲットはコンテナ自体です。

拡張制約が設定されたレイアウトでは、アンカーターゲットを制約行にできます。この場合、コンテンツ領域は、先行する行（またはコンテナ側）とターゲット行の間隔になります。

このプロパティに数値または「10」のような数値文字列を設定すると、デフォルトのアンカーターゲットの使用方法を指定できます。

アンカーターゲットを指定するには、プロパティ値に文字列を "constraintColumnId:value" という形式で設定します。例えば、"row1:10" のように設定します。

グラフィックがレイアウト内で使用する垂直の空間を定義します。この値を設定した場合、コンテンツは拡大 / 縮小されません。一方、height プロパティの値を指定した場合、コンテンツは拡大 / 縮小されます。

これが便利である場合が 2 つあります。1) コンテンツのナチュラルサイズよりも大きい viewHeight を指定する場合。グラフィックが表示サイズよりも多くの空間を占めるようにこのようにする場合があります。2) コンテンツのナチュラルサイズよりも小さい viewHeight を指定する場合。グラフィックに余分なクロムや、グラフィックの端を超える境界線がある場合に、このようにする場合があります。このシナリオでは、必ずレイアウトでクリッピングを無効にしてください。

グラフィックがレイアウト内で使用する水平の空間を定義します。この値を設定した場合、コンテンツは拡大 / 縮小されません。一方、width プロパティの値を指定した場合、コンテンツは拡大 / 縮小されます。

これが便利である場合が 2 つあります。1) コンテンツのナチュラルサイズよりも大きい viewWidth を指定する場合。グラフィックが表示サイズよりも多くの空間を占めるようにこのようにする場合があります。2) コンテンツのナチュラルサイズよりも小さい viewWidth を指定する場合。グラフィックに余分なクロムや、グラフィックの端を超える境界線がある場合に、このようにする場合があります。このシナリオでは、必ずレイアウトでクリッピングを無効にしてください。

このビジュアルエレメントの可視性を制御します。true の場合、オブジェクトは可視です。

オブジェクトが非表示でも includeInLayout プロパティが true に設定されている場合、オブジェクトは非表示ですがコンテナ内のスペースを占めます。

visible が true に設定されている場合、コンテナクリッピングが有効であるかどうかに関係なく、サイズが原因でオブジェクトが表示されないことがあります。

visible を false に設定すると、コンポーネントはフォーカスを取得できなくなります。

コンストラクターです。

エレメントの境界の x 座標を、指定したエレメントサイズで返します。

このメソッドは通常、エレメントが特定のサイズに変更される場合にエレメントの位置を予測するために、measure() メソッドの呼び出し時にレイアウトによって使用されます。

パラメーター

エレメントの境界の y 座標を、指定したエレメントサイズで返します。このメソッドは通常、エレメントが特定のサイズに変更される場合にエレメントの位置を予測するために、measure() の呼び出し時にレイアウトによって使用されます。

パラメーター

エレメントのレイアウトの高さを返します。これは、画面に描画するためにエレメントで使用するサイズです。

パラメーター

エレメントのレイアウトの幅を返します。これは、画面に描画するためにエレメントで使用するサイズです。

パラメーター

画面に描画するためにエレメントで使用する x 座標を返します。

パラメーター

画面に描画するためにエレメントで使用する y 座標を返します。

パラメーター

兄弟を基準としてコンポーネントのレイアウトを計算するために使用される変換マトリックスを返します。

このマトリックスは通常、コンポーネントの 2D プロパティで定義されます。プロパティには、x、y、rotation、scaleX、scaleY、transformX および transformY などがあります。一部のコンポーネントには、追加の変換プロパティがある場合があります。これらのプロパティは、レイアウトマトリックスの上に適用され、最終的な計算されたマトリックスが決定されます。例えば、UIComponent では offsets プロパティが定義されます。

このエレメントのレイアウト変換 Matrix3D を返します。

このマトリックスは通常、コンポーネントの変換プロパティで定義されます。プロパティには、x、y、z、rotationX、rotationY、rotationZ、scaleX、scaleY、scaleZ、transformX および transformY などがあります。一部のコンポーネントには、追加の変換プロパティがある場合があります。これらのプロパティは、レイアウトマトリックスの上に適用され、最終的な計算されたマトリックスが決定されます。例えば、UIComponent では offsets プロパティが定義されます。

エレメントの最大の高さを返します。

パラメーター

エレメントの最大の幅を返します。

パラメーター

エレメントの最小の高さを返します。

パラメーター

エレメントの最小の幅を返します。

パラメーター

エレメントの推奨高さを返します。

パラメーター

エレメントの推奨幅を返します。

パラメーター

MXML タグを使用して SpriteVisualElement を作成したときに、MXML コンパイラーによって自動的に呼び出されます。ActionScript を使用して SpriteVisualElement を作成する場合は、id プロパティを手動で設定する必要があります。

パラメーター

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

このオブジェクトがレイアウトに影響を与える（includeInLayout が true である）場合に、親のサイズおよび表示リストを無効にします。

画面に描画するためにエレメントで使用する座標を設定します。

setLayoutBoundSize() メソッドを呼び出すと、レイアウトの位置に影響が及ぶ場合があります。そのため、setLayoutBoundSize() を呼び出した後に setLayoutBoundPosition() を呼び出してください。

パラメーター

エレメントのレイアウトサイズを設定します。これは、画面に描画するためにエレメントで使用するサイズです。

width または height パラメーターを未指定（NaN）のままにすると、エレメントのレイアウトサイズは Flex によって推奨される幅または高さに設定されます。

setLayoutBoundSize() メソッドを呼び出すと、レイアウトの位置に影響が及ぶ場合があります。そのため、setLayoutBoundSize() を呼び出した後に setLayoutBoundPosition() を呼び出してください。

パラメーター

兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix を設定します。

このマトリックスは通常、コンポーネントの 2D プロパティで定義されます。プロパティには、x、y、rotation、scaleX、scaleY、transformX および transformY があります。一部のコンポーネントには、追加の変換プロパティがある場合があります。これらのプロパティは、レイアウトマトリックスの上に適用され、最終的な計算されたマトリックスが決定されます。例えば、UIComponent では offsets が定義されます。

レイアウト Matrix は、親の座標での計算時に getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() の各メソッドに反映されます。また、親および子の座標での計算時に getLayoutPosition() に反映されます。変換マトリックスを計算するレイアウトは通常、このメソッドを明示的に呼び出し、子の座標でサイズを処理します。このメソッドを呼び出すレイアウトは、invalidateLayout() メソッドに false を渡して、後続のレイアウトパスがトリガーされないようにします。

パラメーター

兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix3D を設定します。

このマトリックスは通常、コンポーネントの変換プロパティで定義されます。プロパティには、x、y、z、rotationX、rotationY、rotationZ、scaleX、scaleY、scaleZ、transformX および transformY などがあります。一部のコンポーネントには、追加の変換プロパティがある場合があります。これらのプロパティは、レイアウトマトリックスの上に適用され、最終的な計算されたマトリックスが決定されます。例えば、UIComponent では offsets プロパティが定義されます。

レイアウト Matrix3D は、親の座標での計算時に getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() に反映されます。また、親および子の座標での計算時に getLayoutPosition() に反映されます。変換マトリックスを計算するレイアウトは通常、このメソッドを明示的に呼び出し、子の座標でサイズを処理します。このメソッドを呼び出すレイアウトは、invalidateLayout() メソッドに false を渡して、後続のレイアウトパスがトリガーされないようにします。

パラメーター

コンポーネントの独自の座標空間内で指定され、親の座標空間内に固定される、特定のポイントを保持して変換の回転、拡大 / 縮小および平行移動を更新するためのユーティリティメソッドです。この関数は、指定された回転、拡大 / 縮小および平行移動の値を割り当てた後、変換の中心を固定したままにするために、必要に応じて x/y/z プロパティを更新します。

パラメーター

エレメントのサイズを変換します。

このメソッドは、エレメントの幅や高さのプロパティが、渡された値に設定されているかのように、グラフィックエレメントの境界ボックスを計算します。このメソッドは、境界ボックスの高さを返します。

一般に、このメソッドは開発者が使用するためのものではありません。代わりに、ILayoutElement インターフェイスによって定義されたメソッドを実装するかオーバーライドする必要があります。

パラメーター