| パッケージ | spark.layouts |
| クラス | public class VerticalLayout |
| 継承 | VerticalLayout  LayoutBase OnDemandEventDispatcher Object |
| サブクラス | FormLayout |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
エレメントの垂直位置は、最初のエレメントの前のパディングと各エレメント間の間隔を考慮して、垂直方向に上から下の順序でエレメントを配置することにより決定されます。
エレメントの水平位置は、レイアウトの horizontalAlign プロパティによって決定されます。
measure() メソッドの実行中に、コンテナのデフォルトサイズは、エレメントの推奨サイズ（間隔とパディングを含む）を収集することにより計算されます。requestedRowCount を設定すると、最初のエレメントから始めて、指定した数のエレメントのスペースのみが測定されます。
updateDisplayList() メソッドの実行中に、各エレメントの高さは、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小高さと最大高さは、必ず順守されます）。
-
variableRowHeightがfalseの場合は、エレメントの高さをrowHeightプロパティの値に設定します。 - エレメントの
percentHeightが設定されている場合は、percentHeight設定を使用して、使用可能なコンテナの高さをすべてのエレメント間で分配し、エレメントの高さを計算します。使用可能なコンテナの高さは、間隔、パディング、および残りのエレメントが占有しているスペースをコンテナの高さから引いた値に等しくなります。レイアウトが仮想化されている場合は、エレメントのprecentHeightプロパティが無視されます。 - エレメントの高さにその推奨高さを設定します。
各エレメントの幅は、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小幅と最大幅は、必ず順守されます）。
-
horizontalAlignが「justify」の場合は、エレメントの幅をコンテナの幅に設定します。 -
horizontalAlignが「contentJustify」の場合は、コンテナの幅とすべてのエレメントの推奨幅の間の最大値をエレメントの幅に設定します。 - エレメントの
percentWidthが設定されている場合は、エレメントの幅をコンテナの幅に対する割合として計算します。 - エレメントの幅にその推奨幅を設定します。
MXML シンタックスを表示
MXML シンタックスを隠すThe <s:VerticalLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:VerticalLayout
Properties
gap="6"
horizontalAlign="left"
paddingBottom="0"
paddingLeft="0"
paddingRight="0"
paddingTop="0"
requestedMaxRowCount="-1"
requestedMinRowCount="-1"
requestedRowCount="-1"
rowHeight="calculated"
variableRowHeight="true"
verticalAlign="top"
/>
さらに例を参照
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 | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| dropIndicator : DisplayObject
このレイアウトがドラッグ＆ドロップ操作の間にドロップインジケーターに対して使用する DisplayObject です。 | LayoutBase | |
| firstIndexInView : int [読み取り専用]
レイアウトの一部であり、レイアウトターゲットのスクロール矩形内にある最初のレイアウトエレメントのインデックスです。まだ何も表示されていない場合は -1 です。 | VerticalLayout | ||
| gap : int
レイアウトエレメント間の垂直方向の間隔（ピクセル単位）です。 | VerticalLayout | ||
| horizontalAlign : String
レイアウトエレメントの水平方向の配置です。 | VerticalLayout | ||
| horizontalScrollPosition : Number
コンポーネントの座標系における、ビューポートの原点の x 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。 | LayoutBase | |
| lastIndexInView : int [読み取り専用]
レイアウトの一部であり、コンテナのスクロール矩形内にある最後の行のインデックスです。まだ何も表示されていない場合は -1 です。 | VerticalLayout | ||
| paddingBottom : Number
コンテナの下端と最後のレイアウトエレメントの下端との間にあるピクセルの数です。 | VerticalLayout | ||
| paddingLeft : Number
コンテナの左端とレイアウトエレメントの左端との間にあるピクセルの最少数です。 | VerticalLayout | ||
| paddingRight : Number
コンテナの右端とレイアウトエレメントの右端との間にあるピクセルの最少数です。 | VerticalLayout | ||
| paddingTop : Number
コンテナの上端と最初のレイアウトエレメントの上端との間にあるピクセルの数です。 | VerticalLayout | ||
| requestedMaxRowCount : int
このレイアウトの測定された高さは、少なくとも requestedMaxRowCount レイアウトエレメントを表示できるだけの高さになります。 | VerticalLayout | ||
| requestedMinRowCount : int
このレイアウトの測定された高さは、少なくとも requestedMinRowCount レイアウトエレメントを表示できるだけの高さになります。 | VerticalLayout | ||
| requestedRowCount : int
このレイアウトの測定サイズは、最初の requestedRowCount レイアウトエレメントを表示するのに十分な高さです。 | VerticalLayout | ||
| rowCount : int [読み取り専用]
現在表示されているエレメントの数です。 | VerticalLayout | ||
| rowHeight : Number
variableRowHeight が false の場合、このプロパティは、それぞれの子の実際の高さ（ピクセル単位）を指定します。 | VerticalLayout | ||
| target : GroupBase
このレイアウトによってエレメントが測定され、そのサイズと位置が設定される GroupBase コンテナです。 | LayoutBase | |
| typicalLayoutElement : ILayoutElement
固定の行 / 列サイズが要求されたときに、特定のサイズが指定されていない場合、レイアウトによって使用されます。 | LayoutBase | |
| useVirtualLayout : Boolean
1 つのコンテナには任意の数の子を追加できます。 | LayoutBase | |
| variableRowHeight : Boolean
レイアウトエレメントに推奨高さを割り当てるかどうかを示します。 | VerticalLayout | ||
| verticalAlign : String
コンテナの高さを基準にしたコンテンツの垂直方向の配置です。 | VerticalLayout | ||
| verticalScrollPosition : Number
コンポーネントの座標系における、ビューポートの原点の y 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。 | LayoutBase | |
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | VerticalLayout | ||
| 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 | |
指定したインデックスが完全に表示されている場合は 1.0、表示されていない場合は 0.0、部分的に表示されている場合はその割合を表す 0.0 ～ 1.0 の範囲の値を返します。 | VerticalLayout | ||
|
指定されたエレメントのレイアウト境界を矩形として返します。インデックスが無効の場合、対応するエレメントが 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 | |
firstIndexInView | プロパティ |
firstIndexInView:int [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
レイアウトの一部であり、レイアウトターゲットのスクロール矩形内にある最初のレイアウトエレメントのインデックスです。まだ何も表示されていない場合は -1 です。
「レイアウトの一部」とは、エレメントが null 以外であり、その includeInLayout プロパティが true であることを意味します。
レイアウトエレメントは部分的にビューに含まれているだけの場合があることに注意してください。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 indexInViewChanged イベントが送出されます。
実装
public function get firstIndexInView():int関連する API エレメント
gap | プロパティ |
horizontalAlign | プロパティ |
horizontalAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
レイアウトエレメントの水平方向の配置です。値が「left」、「right」、または「center」の場合、レイアウトエレメントはコンテナの contentWidth プロパティを基準にして配置されます。
値が「contentJustify」の場合、レイアウトエレメントの実際の幅はコンテナの contentWidth に設定されます。コンテナの contentWidth は、最も大きいレイアウトエレメントの幅です。すべてのレイアウトエレメントがコンテナの幅より小さい場合は、すべてのレイアウトエレメントの幅をコンテナの幅に設定します。
値が「justify」の場合、レイアウトエレメントの実際の幅は、コンテナの幅に設定されます。
このプロパティは、レイアウトの測定サイズに影響を及ぼしません。
デフォルト値： "left"。
実装
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidlastIndexInView | プロパティ |
lastIndexInView:int [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
レイアウトの一部であり、コンテナのスクロール矩形内にある最後の行のインデックスです。まだ何も表示されていない場合は -1 です。
「レイアウトの一部」とは、子が null 以外であり、その includeInLayout プロパティが true であることを意味します。
行は部分的にビューに含まれているだけの場合があることに注意してください。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 indexInViewChanged イベントが送出されます。
実装
public function get lastIndexInView():int関連する API エレメント
fractionOfElementInView
paddingBottom | プロパティ |
paddingLeft | プロパティ |
paddingRight | プロパティ |
paddingTop | プロパティ |
requestedMaxRowCount | プロパティ |
requestedMaxRowCount:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
このレイアウトの測定された高さは、少なくとも requestedMaxRowCount レイアウトエレメントを表示できるだけの高さになります。
requestedRowCount が設定されている場合、このプロパティは無視されます。
コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。
デフォルト値： -1。
実装
public function get requestedMaxRowCount():int public function set requestedMaxRowCount(value:int):void関連する API エレメント
requestedMinRowCount | プロパティ |
requestedMinRowCount:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
このレイアウトの測定された高さは、少なくとも requestedMinRowCount レイアウトエレメントを表示できるだけの高さになります。
requestedRowCount が設定されている場合、このプロパティは無視されます。
コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。
デフォルト値： -1。
実装
public function get requestedMinRowCount():int public function set requestedMinRowCount(value:int):void関連する API エレメント
requestedRowCount | プロパティ |
requestedRowCount:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このレイアウトの測定サイズは、最初の requestedRowCount レイアウトエレメントを表示するのに十分な高さです。
requestedRowCount が -1 の場合、測定サイズは、すべてのレイアウトエレメントに対して十分な大きさになります。
コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。
デフォルト値： -1。
実装
public function get requestedRowCount():int public function set requestedRowCount(value:int):void関連する API エレメント
rowCount | プロパティ |
rowHeight | プロパティ |
rowHeight:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
variableRowHeight が false の場合、このプロパティは、それぞれの子の実際の高さ（ピクセル単位）を指定します。
variableRowHeight が true（デフォルト）の場合、このプロパティは無視されます。
このプロパティのデフォルト値は、typicalLayoutElement の推奨高さです。
実装
public function get rowHeight():Number public function set rowHeight(value:Number):voidvariableRowHeight | プロパティ |
variableRowHeight:Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
レイアウトエレメントに推奨高さを割り当てるかどうかを示します。このプロパティを false に設定すると、行の高さが固定されます。
false の場合、各レイアウトエレメントの実際の高さは、rowHeight の値になります。このプロパティを false に設定すると、レイアウトエレメントの percentHeight プロパティがレイアウトで無視されます。
デフォルト値： true。
実装
public function get variableRowHeight():Boolean public function set variableRowHeight(value:Boolean):voidverticalAlign | プロパティ |
verticalAlign:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンテナの高さを基準にしたコンテンツの垂直方向の配置です。
値が「bottom」、「middle」、または「top」の場合、レイアウトエレメントはコンテナの contentHeight プロパティを基準にして配置されます。
clipAndEnableScrolling が true であり、contentHeight がコンテナの高さより大きい場合、このプロパティは無視されます。
このプロパティは、レイアウトの測定サイズに影響を及ぼしません。
デフォルト値： "top"。
実装
public function get verticalAlign():String public function set verticalAlign(value:String):voidVerticalLayout | () | コンストラクター |
public function VerticalLayout()| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。
fractionOfElementInView | () | メソッド |
public function fractionOfElementInView(index:int):Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
指定したインデックスが完全に表示されている場合は 1.0、表示されていない場合は 0.0、部分的に表示されている場合はその割合を表す 0.0 ～ 1.0 の範囲の値を返します。
対応する null 以外のレイアウトエレメントがコンテナの scrollRect の垂直方向の制限内にあり、レイアウトに含まれている場合、インデックスは「ビュー内」にあります。
指定したインデックスが部分的にビュー内に存在する場合、戻り値は、表示可能な対応するレイアウトエレメントに対する割合になります。
パラメーター
index:int — 行のインデックスです。
|
Number — ビュー内にある指定したエレメントの割合です。指定したインデックスが無効の場合、または指定したインデックスが null エレメント、または includeInLayout プロパティが false である ILayoutElement に対応している場合は、0.0 を返します。
|
Tue Jun 12 2018, 10:34 AM Z