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