メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。

メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。MXML コードに設定されている値は、SDK に用意されている HTML テンプレートを更新するツールで使用できるように設計されています。

メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。

このプロパティは、カスタムプログレスインジケーターを定義するコンポーネントのパスを指定するために使用します。カスタムプログレスインジケーターを作成するには、通常、DownloadProgressBar クラスのサブクラスを作成するか、mx.preloaders.IPreloaderDisplay インターフェイスを実装する flash.display.Sprite クラスのサブクラスを作成します。

メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。

• ユーザーがブラウザーの更新ボタンをクリックしたとき。
• ユーザーが別の Web ページに移動してから、ブラウザーの戻るボタンをクリックして Flex アプリケーションに戻ったとき。
• ユーザーがブラウザーのお気に入りメニューまたはブックマークメニューから Flex アプリケーションをロードしたとき。

メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。

メモ：このプロパティは ActionScript コードでは設定できません。MXML コードで設定する必要があります。

通常、Application オブジェクトは階層を構成しています。これは、Application が SWFLoader コントロールを使用して、別の Application を動的にロードできるためです。 UIComponent の parentApplication プロパティを使用すると、この UIComponent が存在するサブアプリケーションにアクセスし、階層を上って最上位の Application にアクセスできます。

このプロパティは、Flex4 から使用されなくなりました。このプロパティは、以前のバージョンと同じように、mx.core.Application タイプおよび mx.core.WindowedApplication タイプのアプリケーションを返します。 Flex 4 以降では、spark.components.Application タイプまたは spark.components.WindowedApplication タイプのアプリケーションも返されます。

for-in ループを使用すると、パラメーター Object からすべての名前と値を抽出できます。

パラメーターは、Application の URL のクエリストリングと、FlashVars HTML パラメーターの値の 2 つから提供されます。HTML パラメーターはメイン Application にのみ影響します。

次の例に示すように、viewSourceURL プロパティは、ActionScript ではなく MXML を使用して設定する必要があります。

        <mx:Application viewSourceURL="http://path/to/source">
          ...
        </mx:Application>

これを最も簡単に行うには、子ごとに x、y、width および height を指定します。

MXML では、width と height はパーセンテージ値として指定できます。 ActionScript では、percentWidth プロパティと percentHeight プロパティを設定する必要があります。

子の width または percentWidth を指定しなかった場合は、measuredWidth（measure() メソッドによって自動的に決定される）が使用されます。 高さについても同様です。

レイアウトを行うもう 1 つの方法として、アンカースタイル left、top、right、bottom、horizontalCenter および verticalCenter を使用して、子をコンテナの上下左右または中央に固定することができます。

絶対配置レイアウトを使用する場合、コンテナの paddingLeft、paddingTop、paddingRight、paddingBottom、horizontalGap、verticalGap、horizontalAlign および verticalAlign スタイルは無視されます。

子の width または percentWidth を指定しなかった場合は、measuredWidth（measure() メソッドによって自動的に決定される）が使用されます。 高さについても同様です。

子と子の間の間隔は horizontalGap スタイルで、子の配置は verticalAlign スタイルで制御できます。 paddingLeft、paddingTop、paddingRight および paddingBottom スタイルにより、コンテナの境界線と子の間の間隔を制御します。

子の width または percentWidth を指定しなかった場合は、measuredWidth（measure() メソッドによって自動的に決定される）が使用されます。 高さについても同様です。

子と子の間の間隔は verticalGap スタイルで、子の配置は horizontalAlign スタイルで制御できます。 paddingLeft、paddingTop、paddingRight および paddingBottom スタイルにより、コンテナの境界線と子の間の間隔を制御します。

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

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

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

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

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

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

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

コンテナに 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() メソッドを呼び出すことによって子を作成します。

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

このプロパティを ScrollPolicy.OFF に設定した場合も、horizontalScrollPosition プロパティが無効になります。

メモ：このプロパティは ControlBar コンテナには適用されません。

horizontalScrollPolicy が ScrollPolicy.AUTO の場合、水平スクロールバーは、次のすべての条件が満たされるときに表示されます。

• コンテナの子の 1 つが、コンテナの左端または右端の外にはみ出している。
• clipContent プロパティが true である。
• コンテナには、スクロールバーを表示するのに十分な幅および高さがある。

例えば、この Container が TabNavigator の子である場合、対応するタブにこのアイコンが表示されます。この Container が Accordion の子である場合、対応するヘッダーにこのアイコンが表示されます。

SWF ファイルにアイコンを埋め込むには、次の @Embed() MXML コンパイラーディレクティブを使用します。

        icon="@Embed('filepath')"
      

イメージには JPEG、GIF、PNG、SVG、または SWF ファイルを使用できます。

例えば、この Container が TabNavigator の子である場合、対応するタブにこのストリングが表示されます。この Container が Accordion の子である場合、対応するヘッダーにこのストリングが表示されます。

子の数は、最初は MXML で宣言された子の数に等しくなります。 実行時には、addChild() または addChildAt() の呼び出しによって新しい子が追加されたり、removeChild()、removeChildAt() または removeAllChildren() の呼び出しによって既存の子が削除される可能性があります。

コンテナのすべての子（コンテンツである子とスキンの両方）にアクセスする必要がある場合は、通常の Container のメソッドの代わりに、rawChildren プロパティのメソッドとプロパティを使用します。 例えば、Container.rawChildren.getChildAt()) メソッドを使用します。 ただし、コンテナが子の ContentPane Sprite オブジェクトを作成する場合、rawChildren プロパティ値は ContentPane だけをカウントし、コンテナの子はカウントしません。 コンテナがいつ ContentPane を持つのかを判断することが常に可能であるとは限りません。

メモ： addChild メソッドまたは addChildAt メソッドを rawChildren オブジェクトに対して呼び出す場合は、追加したコンポーネントで tabFocusEnabled = false を設定してください。 そうすると、ユーザーは追加された表示専用コンポーネントをタブで選択できなくなります。

このプロパティを ScrollPolicy.OFF に設定すると、verticalScrollPosition プロパティが無効になります。

メモ：このプロパティは ControlBar コンテナには適用されません。

verticalScrollPolicy が ScrollPolicy.AUTO の場合、垂直スクロールバーは、次のすべての条件が満たされるときに表示されます。

• コンテナの子の 1 つが、コンテナの上端または下端の外にはみ出している。
• clipContent プロパティが true である。
• コンテナには、スクロールバーを表示するのに十分な幅および高さがある。

クロムには境界線の幅が含まれます。 horizontalScrollPolicy または verticalScrollPolicy プロパティ値が ScrollPolicy.ON の場合、クロムには対応するスクロールバーの幅も含まれます。 スクロールポリシーが ScrollPolicy.AUTO の場合は、スクロールバーが表示されていても、クロムの測定にスクロールバーの幅は含まれません。

クロムには境界線の幅が含まれます。 horizontalScrollPolicy または verticalScrollPolicy プロパティ値が ScrollPolicy.ON の場合、クロムには対応するスクロールバーの幅も含まれます。 スクロールポリシーが ScrollPolicy.AUTO の場合は、スクロールバーが表示されていても、クロムの測定にスクロールバーの幅は含まれません。

Container のサブクラスでは、Container の子の位置を決める際に他のクロムが考慮されるように、このメソッドをオーバーライドしてください。 例えば、Panel クラスの viewMetrics プロパティは、Panel コンテナのタイトルバーの幅を top プロパティで示しているオブジェクトを返す必要があります。

ListBase サブクラスでこのプロパティを ScrollPolicy.OFF に設定しても、horizontalScrollPosition プロパティは影響を受けません。引き続き、コンテンツをプログラムでスクロールできます。

このポリシーは、コンポーネントの測定サイズに影響を与える場合があります。ポリシーが ScrollPolicy.AUTO の場合、スクロールバーは測定サイズに反映されません。 この設定により、スクロールバーが表示されたときにレイアウトが再計算されなくなります。 スクロールバーに十分なデータが供給されることがわかっている場合は、このポリシーを ScrollPolicy.ON に設定してください。 それが不確かなときに、スクロールバーを後で表示できるように、コンポーネントの幅と高さを明示的に設定することが必要になります。

ほとんどのコンポーネントで、maxHorizontalScrollPosition プロパティの値は、コンポーネントのデータおよびサイズから計算されます。アプリケーションコードで設定しないようにしてください。

maxVerticalScrollPosition プロパティの値は、コンポーネントのデータとサイズから計算されます。アプリケーションコードで設定しないでください。

      function scrollTipFunction(direction:String, position:Number):String 
      {
        if (direction == "vertical") return myToolTips[position];
        else return "";
      }

ListBase サブクラスでこのプロパティを ScrollPolicy.OFF に設定しても、verticalScrollPosition プロパティは影響を受けません。引き続き、コンテンツをプログラムでスクロールできます。

このポリシーは、コンポーネントの測定サイズに影響を与える場合があります。ポリシーが ScrollPolicy.AUTO の場合、スクロールバーは測定サイズに反映されません。 この設定により、スクロールバーが表示されたときにレイアウトが再計算されなくなります。 スクロールバーに十分なデータが供給されることがわかっている場合は、このポリシーを ScrollPolicy.ON に設定してください。 それが不確かなときに、スクロールバーを後で表示できるように、コンポーネントの幅と高さを明示的に設定することが必要になります。