| パッケージ | spark.layouts |
| クラス | public class TileLayout |
| 継承 | TileLayout  LayoutBase OnDemandEventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
エレメントごとにサポートされる制約は、percentWidth と percentHeight です。エレメントの最小サイズと最大サイズは、必ず順守されます。可能な場合、エレメントのサイズは、セルのサイズ以下に制限されます。
明示的に設定しない場合、columnWidth プロパティは、すべてのエレメントの最大推奨境界幅として計算され、columnHeight プロパティは、すべてのエレメントの最大推奨境界高さとして計算されます。
明示的に設定しない場合、columnCount プロパティと rowCount プロパティは、レイアウトターゲットの明示的な幅と高さの設定と、columnWidth および columnHeight から計算されます。何も指定しない場合は、columnCount と rowCount の値が選択され、生成されるピクセル領域が可能なかぎり正方形になります。
測定サイズは、columnCount、rowCount、columnWidth、rowHeight プロパティおよび間隔のサイズから計算されます。
プロパティが明示的に設定されていない場合、デフォルトの測定サイズは、可能なかぎり正方形に近く、すべてのエレメントを収めるのに十分な大きさになります。
場合によっては、測定サイズの大きさが不十分で、すべてのエレメントが収まらないことがあります。例えば、columnCount と rowCount の両方に明示的に値が設定されていて、columnCount に rowCount を乗算した値がエレメント数より小さい場合です。
最小の測定サイズは、測定サイズと同様に計算されます。ただし、短軸に沿って行と列が十分に含まれているので、すべてのエレメントが収まることが保証されます。
MXML シンタックス
MXML シンタックスを表示
MXML シンタックスを隠すThe <s:TileLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:TileLayout
Properties
columnAlign="left"
columnWidth="NaN"
horizontalAlign="justify"
horizontalGap="6"
orientation="rows"
requestedColumnCount="-1"
requestedRowCount="-1"
rowAlign="top"
rowCount="-1"
rowHeight="NaN"
verticalAlign="justify"
verticalGap="6"
/>
さらに例を参照
Setting the layout of a Spark container
Setting the padding and gap of a layout
Setting the alignment of a layout
Setting the row height or column width of a layout
| プロパティ | 定義元 | ||
|---|---|---|---|
 | clipAndEnableScrolling : Boolean
true の場合、ビューポートの境界に子をクリッピングするように指定します。 | LayoutBase | |
| columnAlign : String
列を完全に表示させた状態でコンテナの幅に揃える方法を指定します。 | TileLayout | ||
| columnCount : int [読み取り専用]
列の実際の数を含みます。 | TileLayout | ||
| columnWidth : Number
列の実際の幅（ピクセル単位）を含みます。 | TileLayout | ||
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| dropIndicator : DisplayObject
このレイアウトがドラッグ＆ドロップ操作の間にドロップインジケーターに対して使用する DisplayObject です。 | LayoutBase | |
| horizontalAlign : String
セル内のエレメントを水平方向に整列させる方法を指定します。 | TileLayout | ||
| horizontalGap : Number
列間の水平方向の間隔（ピクセル単位）です。 | TileLayout | ||
| horizontalScrollPosition : Number
コンポーネントの座標系における、ビューポートの原点の x 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。 | LayoutBase | |
| orientation : String
エレメントを行ごとに配置するのか、列ごとに配置するのかを指定します。 | TileLayout | ||
| paddingBottom : Number
コンテナの下端と最後のレイアウトエレメントの下端との間にあるピクセルの数です。 | TileLayout | ||
| paddingLeft : Number
コンテナの左端とレイアウトエレメントの左端との間にあるピクセルの最少数です。 | TileLayout | ||
| paddingRight : Number
コンテナの右端とレイアウトエレメントの右端との間にあるピクセルの最少数です。 | TileLayout | ||
| paddingTop : Number
コンテナの上端と最初のレイアウトエレメントの上端との間にあるピクセルの数です。 | TileLayout | ||
| requestedColumnCount : int
表示する列数です。 | TileLayout | ||
| requestedRowCount : int
表示する行の数です。 | TileLayout | ||
| rowAlign : String
行を完全に表示させた状態でコンテナの高さに揃える方法を指定します。 | TileLayout | ||
| rowCount : int [読み取り専用]
行数です。 | TileLayout | ||
| rowHeight : Number
ピクセル単位で表した行の高さです。 | TileLayout | ||
| target : GroupBase
このレイアウトによってエレメントが測定され、そのサイズと位置が設定される GroupBase コンテナです。 | LayoutBase | |
| typicalLayoutElement : ILayoutElement
固定の行 / 列サイズが要求されたときに、特定のサイズが指定されていない場合、レイアウトによって使用されます。 | LayoutBase | |
| useVirtualLayout : Boolean
1 つのコンテナには任意の数の子を追加できます。 | LayoutBase | |
| verticalAlign : String
セル内のエレメントを垂直方向に整列させる方法を指定します。 | TileLayout | ||
| verticalGap : Number
行間の垂直方向の間隔（ピクセル単位）です。 | TileLayout | ||
| verticalScrollPosition : Number
コンポーネントの座標系における、ビューポートの原点の y 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。 | LayoutBase | |
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | TileLayout | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | OnDemandEventDispatcher | |
|
指定した dragEvent に対するドロップターゲットのデータプロバイダー内でのドロップ位置を計算します。 | LayoutBase | |
|
useVirtualLayout が true の場合、レイアウトターゲットが変化するときにターゲットでこのメソッドを使用すると、キャッシュされているレイアウト情報をクリアできます。 | LayoutBase | |
|
イベントをイベントフローに送出します。 | OnDemandEventDispatcher | |
|
レイアウトエレメントが追加されてからターゲットのサイズと表示リストが検証されるまでの間に、ターゲットで呼び出されます。 | LayoutBase | |
|
このメソッドは、レイアウトエレメントが削除されてからターゲットのサイズと表示リストが検証されるまでの間に、ターゲットで呼び出されます。 | LayoutBase | |
|
指定されたエレメントのレイアウト境界を矩形として返します。インデックスが無効の場合、対応するエレメントが null の場合、includeInLayout=false の場合、またはこのレイアウトの target プロパティが null の場合は、null を返します。 | LayoutBase | |
|
異なるスクロールオプションを処理するために、水平スクロール位置に対する変更を返します。 | LayoutBase | |
| getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
フォーカスを持っている現在のアイテムと NavigationUnit に関するユーザー入力に基づいてナビゲート先のアイテムを決定する委譲メソッドです。 | LayoutBase | |
|
指定したインデックスにあるエレメントをビュー内にスクロールするために必要な verticalScrollPosition デルタと horizontalScrollPosition デルタを計算します。 | LayoutBase | |
|
異なるスクロールオプションを処理するために、垂直スクロール位置に対する変更を返します。 | LayoutBase | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | OnDemandEventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
showDropIndicator() メソッドによって作成されて、以前に表示したドロップインジケーターを非表示にし、表示リストから削除して、ドラッグスクロールも停止します。 | LayoutBase | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
ターゲットのデフォルトサイズをそのコンテンツに基づいて測定します。また、必要に応じて、ターゲットのデフォルト最小サイズを測定します。 | LayoutBase | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | OnDemandEventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
指定したドロップ位置に基づいて、ドロップインジケーターのサイズ、位置、親を設定します。 | LayoutBase | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
ターゲットのエレメントのサイズと位置を設定します。 | LayoutBase | |
|
レイアウトで scrollRect を更新するために、updateDisplayList の最後にターゲットによって呼び出されます。 | LayoutBase | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | OnDemandEventDispatcher | |
| メソッド | 定義元 | ||
|---|---|---|---|
|
ドラッグ＆ドロップ動作中の指定された dropLocation までのスクロール距離を計算します。 | LayoutBase | |
[オーバーライド]
ドラッグ＆ドロップ動作中にユーザーが指定された座標でマウスを離した場合に、新しいアイテムを挿入するインデックスを返します。 | TileLayout | ||
[オーバーライド]
ドラッグ＆ドロップ動作の終了時にアイテムが挿入される位置をユーザーに対して視覚的にフィードバックするドロップインジケーターの境界を計算します。 | TileLayout | ||
|
scrollRect の上端にまたがっているか、その上にある最初のレイアウトエレメントの境界を返します。 | LayoutBase | |
|
scrollRect の下端にまたがっているか、その下にある最初のレイアウトエレメントの境界を返します。 | LayoutBase | |
|
scrollRect の左端にまたがっているか、その左にある最初のレイアウトエレメントの境界を返します。 | LayoutBase | |
|
scrollRect の右端にまたがっているか、その右にある最初のレイアウトエレメントの境界を返します。 | LayoutBase | |
|
レイアウト座標のターゲットのスクロール矩形の境界を返します。 | LayoutBase | |
|
verticalScrollPosition プロパティまたは horizontalScrollPosition プロパティの変更時に呼び出されます。 | LayoutBase | |
columnAlign | プロパティ |
columnAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
列を完全に表示させた状態でコンテナの幅に揃える方法を指定します。ActionScript の値には、ColumnAlign.LEFT、ColumnAlign.JUSTIFY_USING_GAP および ColumnAlign.JUSTIFY_USING_WIDTH を指定できます。MXML の値には、"left"、"justifyUsingGap" および "justifyUsingWidth" を指定できます。
ColumnAlign.LEFT に設定すると、列の位置揃えがオフになります。その場合、列の一部が表示されないことや、最後の列とコンテナの右端の間に空白ができることがあります。これがデフォルト値です。
ColumnAlign.JUSTIFY_USING_GAP に設定した場合は、horizontalGap の実際の値が増加し、最後の列の右端が完全に表示された状態でコンテナの右端に揃えられます。完全に表示できる列が 1 つしかない場合は、horizontalGap の実際の値が増加し、部分的にしか表示されないすべての列はコンテナの右端からはみ出します。horizontalGap プロパティを明示的に設定しても、位置揃えはオフになりません。間隔の初期値のみが決定されます。位置揃えによってこの値が大きくなる場合があります。
ColumnAlign.JUSTIFY_USING_WIDTH に設定した場合は、columnWidth の実際の値が増加し、最後の列の右端が完全に表示された状態でコンテナの右端に揃えられます。columnWidth プロパティを明示的に設定しても、位置揃えはオフになりません。列幅の初期値のみが決定されます。位置揃えによってこの値が大きくなる場合があります。
デフォルト値： ColumnAlign.LEFT。
実装
public function get columnAlign():String public function set columnAlign(value:String):void関連する API エレメント
columnCount | プロパティ |
columnWidth | プロパティ |
columnWidth:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
列の実際の幅（ピクセル単位）を含みます。
明示的に設定しない場合、列の幅は最も広いエレメントの幅に基づいて決定されます。
columnAlign プロパティを「justifyUsingWidth」に設定すると、列の幅が大きくなり、列が完全に表示された状態でコンテナの幅に揃えられます。
デフォルト値： NaN。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。
実装
public function get columnWidth():Number public function set columnWidth(value:Number):void関連する API エレメント
horizontalAlign | プロパティ |
horizontalAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
セル内のエレメントを水平方向に整列させる方法を指定します。サポートされる値は、HorizontalAlign.LEFT、HorizontalAlign.CENTER、HorizontalAlign.RIGHT、HorizontalAlign.JUSTIFY です。
HorizontalAlign.JUSTIFY を設定すると、各エレメントの幅は、columnWidth に設定されます。
デフォルト値： HorizontalAlign.JUSTIFY。
実装
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidhorizontalGap | プロパティ |
horizontalGap:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
列間の水平方向の間隔（ピクセル単位）です。
デフォルト値： 6。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。
実装
public function get horizontalGap():Number public function set horizontalGap(value:Number):void関連する API エレメント
orientation | プロパティ |
orientation:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
エレメントを行ごとに配置するのか、列ごとに配置するのかを指定します。ActionScript の値には、TileOrientation.ROWS と TileOrientation.COLUMNS を指定できます。MXML の値には、"rows" と "columns" を指定できます。
デフォルト値： TileOrientation.ROWS。
実装
public function get orientation():String public function set orientation(value:String):voidpaddingBottom | プロパティ |
paddingLeft | プロパティ |
paddingRight | プロパティ |
paddingTop | プロパティ |
requestedColumnCount | プロパティ |
requestedColumnCount:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
表示する列数です。
-1 を設定すると、TileLayout で自動的に列数が決定されます。
orientation プロパティを TileOrientation.ROWS に設定すると、このプロパティの設定は無視されます。その場合は、rowCount およびコンテナの幅が明示的に設定されます。
デフォルト値： -1。
実装
public function get requestedColumnCount():int public function set requestedColumnCount(value:int):void関連する API エレメント
requestedRowCount | プロパティ |
requestedRowCount:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
表示する行の数です。
-1 を設定すると、明示的なオーバーライドが削除され、TileLayout で自動的に行数が決定されます。
orientation プロパティを TileOrientation.COLUMNS に設定すると、このプロパティの設定は無視されます。その場合は、columnCount およびコンテナの高さが明示的に設定されます。
デフォルト値： -1。
実装
public function get requestedRowCount():int public function set requestedRowCount(value:int):void関連する API エレメント
rowAlign | プロパティ |
rowAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
行を完全に表示させた状態でコンテナの高さに揃える方法を指定します。ActionScript の値には、RowAlign.TOP、RowAlign.JUSTIFY_USING_GAP および RowAlign.JUSTIFY_USING_HEIGHT を指定できます。MXML の値には、"top"、"justifyUsingGap" および "justifyUsingHeight" を指定できます。
RowAlign.TOP に設定すると、列の位置揃えがオフになります。その場合、行の一部が表示されないことや、最後の行とコンテナの下端の間に空白ができることがあります。これがデフォルト値です。
RowAlign.JUSTIFY_USING_GAP を設定した場合は、verticalGap の実際の値が増加し、最後の行の下端が完全に表示された状態でコンテナの下端に揃えられます。完全に表示できる行が 1 つしかない場合は、verticalGap の値が増加し、部分的にしか表示されないすべての行はコンテナの下端からはみ出します。verticalGap を明示的に設定しても、位置揃えはオフにならず、間隔の初期値のみが決定されます。位置揃えによってこの値が大きくなる場合があります。
RowAlign.JUSTIFY_USING_HEIGHT を設定すると、rowHeight の実際の値が増加し、最後の行の下端が完全に表示された状態でコンテナの下端に揃えられます。rowHeight を明示的に設定しても、位置揃えはオフにならず、行の高さの初期値のみが決定されます。位置揃えによってこの値が大きくなる場合があります。
デフォルト値： RowAlign.TOP。
実装
public function get rowAlign():String public function set rowAlign(value:String):void関連する API エレメント
rowCount | プロパティ |
rowHeight | プロパティ |
rowHeight:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ピクセル単位で表した行の高さです。
明示的に設定しない場合、行の高さは、エレメントの高さの最大値から決定されます。
rowAlign に「justifyUsingHeight」を設定した場合は、実際の行の高さが大きくなり、行が完全に表示された状態でコンテナの高さに揃えられます。
デフォルト値： NaN。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。
実装
public function get rowHeight():Number public function set rowHeight(value:Number):void関連する API エレメント
verticalAlign | プロパティ |
verticalAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
セル内のエレメントを垂直方向に整列させる方法を指定します。サポートされる値は、VerticalAlign.TOP、VerticalAlign.MIDDLE、VerticalAlign.BOTTOM、VerticalAlign.JUSTIFY です。
VerticalAlign.JUSTIFY を設定すると、各エレメントの高さは、rowHeight に設定されます。
デフォルト値： VerticalAlign.JUSTIFY。
実装
public function get verticalAlign():String public function set verticalAlign(value:String):voidverticalGap | プロパティ |
verticalGap:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
行間の垂直方向の間隔（ピクセル単位）です。
デフォルト値： 6。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。
実装
public function get verticalGap():Number public function set verticalGap(value:Number):void関連する API エレメント
TileLayout | () | コンストラクター |
public function TileLayout()| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。
calculateDropIndex | () | メソッド |
override protected function calculateDropIndex(x:Number, y:Number):int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ドラッグ＆ドロップ動作中にユーザーが指定された座標でマウスを離した場合に、新しいアイテムを挿入するインデックスを返します。calculatedDropLocation() メソッドによって呼び出されます。
パラメーター
x:Number — ローカル座標系における、ドラッグ＆ドロップ動作の x 座標です。
| |
y:Number — ドロップターゲットのローカル座標系における、ドラッグ＆ドロップ動作の y 座標です。
|
int — ドロップインデックスです。指定された座標でドロップ操作を使用できない場合は -1 です。
|
calculateDropIndicatorBounds | () | メソッド |
override protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ドラッグ＆ドロップ動作の終了時にアイテムが挿入される位置をユーザーに対して視覚的にフィードバックするドロップインジケーターの境界を計算します。showDropIndicator() メソッドによって呼び出されます。
パラメーター
dropLocation:DropLocation — calculateDropLocation() メソッドによって以前に返された有効な DropLocation オブジェクトです。
|
Rectangle — ドロップインジケーターの境界、または null です。
|
Tue Jun 12 2018, 10:34 AM Z