この Box コンテナが子をレイアウトする方向です。有効な MXML 値は、"horizontal" および "vertical" です。ActionScript で有効な値は、BoxDirection.HORIZONTAL および BoxDirection.VERTICAL です。

デフォルト値BoxDirection.VERTICAL.

このプロパティはデータバインディングのソースとして使用できます。

コンストラクタ。

Box コンテナのデフォルトサイズ、および最小値と最大値を計算します。

Box コンテナの direction プロパティが BoxDirection.HORIZONTAL に設定されると、その measuredWidth プロパティはすべての子のデフォルトの幅の合計に境界線の幅、左右のパディング、および子同士の間の水平ギャップを加えたものと等しくなります。measuredHeight プロパティの値は、子のデフォルトの高さの最大値に境界線の領域およびパディングの領域を加えたものになります。Box コンテナの direction プロパティが BoxDirection.VERTICAL に設定されると、これら 2 つの値が入れ替わります。

Box コンテナの minWidth および minHeight プロパティは、子の最小幅と最小高さを組み合わせて同様に計算されます。子の width プロパティがパーセント値である場合、Box コンテナの最小幅は子の minWidth プロパティの値に等しくなります。子の width が設定されていない場合や固定値である場合は、子は増大または縮小せず、Box コンテナの最小幅は子の explicitWidth プロパティの値に等しくなります。子の最小高さも同様に計算されます。

Box コンテナの maxWidth および maxHeight プロパティは計算されません。Box コンテナの最大幅と最大高さは無限であると想定されます。

前述の値はすべて、Box コンテナの計算された幅と高さです。以下のプロパティの値を明示的に指定することにより、測定値をオーバーライドできます。

• width
• height
• minWidth
• minHeight
• maxWidth
• maxHeight

measure() メソッドは直接呼び出さないでください。Flex LayoutManager が適切なタイミングで呼び出します。Flex LayoutManager は、アプリケーションの起動時に、子から親に至るすべてのコンポーネントを測定してから、それぞれに最終的なサイズを設定しようとします。

これは、サブクラスの処理で使用する高度なメソッドです。このメソッドをオーバーライドする場合は、実装で super.measure() メソッドを呼び出すか、または measuredHeight および measuredWidth プロパティを設定する必要があります。また、オプションで次のプロパティも設定できます。

• measuredMinWidth
• measuredMinHeight

どちらのプロパティも前述のレイアウトプロパティに対応しているため、これ以上取り上げません。

ピクセル数を、このコンテナのコンテンツに対するパーセント値に変換するために使用するメソッドです。

パーセント値は、コンテナのサイズまたはレイアウトが変更されない間のみ適切です。サイズやレイアウトを変更すると、このメソッドから返される値が最新のものではなくなることがあります。

このメソッドの使用例として、コンポーネントを非表示にした後、そのサイズを特定のピクセル数に復元することなどが考えられます。

Box コンテナの各子のサイズと位置を設定します。

Box コンテナのレイアウトアルゴリズムを理解するために、ここでは Box コンテナの方向が水平であると仮定します。

Box コンテナの子すべてが単一の水平行に隣り合って配置されており、隣接する 2 つの子の間には horizontalGap で指定したピクセル数の間隔があります。明示的な幅の値がない子の幅は、measuredWidth プロパティと同じ値に設定されます。

子の measuredWidth プロパティの値の合計が Box コンテナの幅より大きくまたは小さくなり、width プロパティの値がパーセント値である子がある場合には、これらの子のサイズはすべての子が Box の幅に完全に収まるまで増大または縮小します。ただし、子が minWidth プロパティの値より小さくなる、または maxWidth プロパティの値より大きくなることはありません。増大する子の間に、子の percentWidth に比例して領域が追加されます。縮小する子の場合には、その子の間にある領域が percentWidth に比例して削除されます。たとえば、40% の percentWidth を持つ子は、領域がすべて満たされるか、指定したサイズに到達するまで、20% の percentWidth を持つ子の 2 倍に増大します。

フレキシブルなすべての子が増大または縮小した後、子の幅の合計が Box コンテナの幅と一致するかどうかがチェックされます。一致しない場合には、子が Box の左端、右端、または中央揃えに整列されるように、子のグループ全体が Box コンテナの horizontalAlign プロパティの値に応じてシフトします。

子の高さを決定するために、Flex は子の height プロパティの値を確認します。height が設定されない場合は、子の高さはその measuredHeight に設定されます。height がピクセル値に設定されると、その値が使用されます。height がパーセント値に設定されると、子の高さは Box の高さの指定したパーセントに一致するように増大または縮小します。ただし、子の高さが minHeight プロパティの値より小さくなる、または maxHeight プロパティの値より大きくなることはありません。

子の垂直方向の位置は、Box コンテナの verticalAlign プロパティによって決定されます。子はそれぞれ Box の上端、下端、または中央に整列されるようにシフトします。

Box コンテナの direction が vertical である場合にもこれと同じ規則が当てはまりますが、幅と高さが入れ替わります。子は、単一の垂直列に配置されます。

このメソッドを直接呼び出すことは避けてください。Flex LayoutManager が適切なタイミングで呼び出します。Flex LayoutManager は、アプリケーションの起動時に、Application オブジェクトから始まって下方向にある全コンポーネントに対して updateDisplayList() メソッドを呼び出します。

これは、サブクラスの処理で使用する高度なメソッドです。このメソッドをオーバーライドする場合は、実装で super.updateDisplayList() メソッドを呼び出して、それぞれの子で move() および setActualSize() メソッドを呼び出す必要があります。レイアウトを実行するために、このコンテナのサイズは width および height プロパティではなく、unscaledWidth および unscaledHeight の各プロパティから取得してください。width および height プロパティは、このコンテナの scaleX および scaleY プロパティの値を考慮しません。