Container  - AS3 Flex

このコンテナの作成ポリシーです。

true の場合、子の位置またはサイズが変更されたときに測定とレイアウトが実行されます。 false の場合、測定とレイアウトは、子がコンテナに追加されたとき、またはコンテナから削除されたときに、一度だけ実行されます。

Move エフェクトを使用する場合、移動するコンポーネントの周囲のレイアウトは、Move エフェクトがアニメーション化するものに収まるように再調整されません。 コンテナの autoLayout プロパティを true に設定しても、この動作には影響しません。

autoLayout プロパティが false の場合、Zoom エフェクトは有効になりません。

autoLayout プロパティは、Accordion または ViewStack コンテナには適用されません。

デフォルト値： true。

left、top、right および bottom の 4 つのプロパティを持つ EdgeMetrics オブジェクトを返します。 各プロパティの値は、境界線の 1 辺の太さをピクセル単位で表したものです。

viewMetrics とは異なり、このプロパティは Container のサブクラスによってオーバーライドされません。

MXML コンパイラーによって生成される UIComponentDescriptor オブジェクトの配列です。

各 UIComponentDescriptor オブジェクトには、コンテナの MXML タグの、子 MXML タグの 1 つで指定される情報が含まれます。配列内での UIComponentDescriptor オブジェクトの順序は、子タグの順序と同一です。初期化時には、子の記述子を使用して、コンテナの子 UIComponent オブジェクトとその Repeater オブジェクトが作成され、これらに MXML で指定された初期プロパティ値やイベントハンドラー、エフェクトなどが設定されます。

関連する API エレメント

このコンテナの子の位置やサイズが、このコンテナの境界線を超えるように変更された場合に、クリップマスクを適用するかどうかを指定します。 false の場合、このコンテナの子は、移動やサイズ変更によってこのコンテナの外部に出た場合も、表示されたままになります。 true の場合、このコンテナの子は切り詰められます。

clipContent が false の場合、このコンテナのスクロールが無効になり、スクロールバーが表示されません。 clipContent が true の場合、コンテナの子がコンテナの外部に拡張されると、通常はスクロールバーが表示されます。 スクロールバーの表示の制御については、horizontalScrollPolicy および verticalScrollPolicy を参照してください。

デフォルト値： true。

コンテンツ座標系におけるマウスの x 位置を返します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。

コンテンツ座標系におけるマウスの y 位置を返します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。

コンテナは、内部コンテンツペインを使用してスクロールを制御します。 コンテナでコンテンツペインを作成している間は creatingContentPane が true になるため、いくつかのイベントを無視またはブロックできます。

コンテナの子をインスタンス化して描画する順序を指定します。

このプロパティは、creationPolicy プロパティが ContainerCreationPolicy.QUEUED に設定されている場合にのみ有効です。 それ以外の場合は無視されます。

デフォルト値： -1。

この MX コンテナの子作成ポリシーです。有効な ActionScript 値は、ContainerCreationPolicy.AUTO、ContainerCreationPolicy.ALL または ContainerCreationPolicy.NONE です。有効な MXML 値は、auto、all または none です。

コンテナに creationPolicy が指定されていない場合、そのコンテナは親の creationPolicy を継承します。 Application に creationPolicy が指定されていない場合、デフォルトは ContainerCreationPolicy.AUTO になります。

creationPolicy が ContainerCreationPolicy.AUTO の場合、必要になるまでコンテナの一部またはすべての下位要素の作成が遅延されます（遅延インスタンス化）。 このポリシーを使用した場合、最初に作成される UIComponent が少なくなるため、起動時間が最短になります。 ただし、ユーザーがアプリケーションの別の部分に初めて移動するとき、ナビゲーションの遅延が生じます。 Accordion、TabNavigator、ViewStack などのナビゲーターコンテナは、すべての子を直ちに作成することによって ContainerCreationPolicy.AUTO ポリシーを実装しますが、ある子がそのナビゲーターコンテナの選択された子になるまでは、その子の下位要素を作成しません。

creationPolicy が ContainerCreationPolicy.ALL である場合、ナビゲーターコンテナは、子が選択されるまで待たずに各子の下位要素を直ちに作成します。 VBox コンテナなどの単一ビューコンテナについては、ContainerCreationPolicy.AUTO ポリシーと ContainerCreationPolicy.ALL ポリシーに違いはありません。

creationPolicy が ContainerCreationPolicy.NONE である場合、コンテナは子を作成しません。 この場合は、MXML 作成者が、createComponentsFromDescriptors() メソッドを呼び出すことによって子を作成します。

デフォルト値： ContainerCreationPolicy.AUTO。

アイテムレンダラーまたはアイテムエディターで data プロパティを使用すると、コンポーネントに値を渡すことができます。 通常、データバインディングを使用して、data プロパティのフィールドをこのコンポーネントのプロパティにバインドします。

MXML でこのプロパティを設定することはありません。

デフォルト値： null。

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

関連する API エレメント

コンテナのデフォルトボタンとして指定された Button コントロールです。 コンテナ内のコントロールにフォーカスがあるときは、Enter キーを押すことと、この Button コントロールをクリックすることが同義です。

デフォルト値： null。

processedDescriptors に相当する IDeferredContentOwner のプロパティ

関連する API エレメント

水平スクロールバーの左矢印ボタンまたは右矢印ボタンがクリックされたときに移動するピクセル数です。

デフォルト値： 5。

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

水平スクロールバーのトラックがクリックされたときに移動するピクセル数です。 値が 0 の場合は、全画面表示にするためのページサイズが計算されることを意味します。

デフォルト値： 0。

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

このコンテナで使用する水平スクロールバーです。現在表示されている水平スクロールバーがない場合、このプロパティは null です。一般に、このプロパティに直接アクセスすることはありません。 horizontalScrollPolicy および horizontalScrollPosition プロパティを操作することで、このスクロールバーを適切に制御できます。