creationDateColumn.width などのプロパティを設定してこの列をカスタマイズできます。 この列全体を削除する場合や、列の順序を変更する場合は、columns プロパティを [ nameColumn, modificationDateColumn, sizeColumn ] などの配列に設定します。

modificationDateColumn.width などのプロパティを設定してこの列をカスタマイズできます。 この列全体を削除する場合や、列の順序を変更する場合は、columns プロパティを [ nameColumn, modificationDateColumn, sizeColumn ] などの配列に設定します。

nameColumn.width などのプロパティを設定してこの列をカスタマイズできます。 この列全体を削除する場合や、列の順序を変更する場合は、columns プロパティを [ nameColumn, modificationDateColumn, sizeColumn ] などの配列に設定します。

sizeColumn.width などのプロパティを設定してこの列をカスタマイズできます。 この列全体を削除する場合や、列の順序を変更する場合は、columns プロパティを [ nameColumn, modificationDateColumn, sizeColumn ] などの配列に設定します。

typeColumn.width などのプロパティを設定してこの列をカスタマイズできます。 この列全体を削除する場合や、列の順序を変更する場合は、columns プロパティを [ nameColumn, modificationDateColumn, sizeColumn ] などの配列に設定します。

この配列の最初のアイテムは、履歴リストに格納されている 1 つ前のディレクトリになります。最後のアイテムは、履歴リストに格納されている最も古いディレクトリです。

この配列には、null アイテムを格納することができます。この場合、戻ることができるディレクトリが存在せず、その内容がルートディレクトリ（Microsoft Windows では C:¥ および D:¥ など）であることを表します。

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、前のディレクトリに戻るボタンを実装する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
         enabled="{fileSystemViewer.canNavigateBack}"
         dataProvider="{fileSystemViewer.backHistory}"
         click="fileSystemViewer.navigateBack();"
         itemClick="fileSystemViewer.navigateBack(event.index);"/>

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、前のディレクトリに戻るボタンを実装する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

次の例は、このプロパティを Button コントロールで使用する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、次のディレクトリに進むボタンを実装する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

次の例は、このプロパティを Button コントロールで使用する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

この配列の最初のアイテムは、履歴リストに格納されている 1 つ先のディレクトリになります。最後のアイテムは、履歴リストに格納されている最も新しいディレクトリです。

この配列の内容が null になっていることもあり、この場合は現在のディレクトリが Microsoft Windows の C:¥ や D:¥ などのルートディレクトリなので、配列にディレクトリが記述されていないことを表しています。

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、次のディレクトリに進むボタンを実装する方法を示したものです。

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

このプロパティを既存のディレクトリを表す File オブジェクトに設定した場合、dataProvider は直ちに null になります。 その後、このコントロールが LayoutManager で再検証されると、そのディレクトリの内容が同期的に列挙され、ディレクトリ内のファイルとサブディレクトリを表す File オブジェクトの ArrayCollection が dataProvider プロパティに設定されます。

このプロパティを既存のディレクトリを表していない File に設定するとエラーになります。 このプロパティを COMPUTER に設定すると、同期的にルートディレクトリ（Windows では C:¥ および D:¥ など）が表示されます。

この配列の最初のアイテムは、履歴リストに格納されている 1 つ前のディレクトリになります。最後のアイテムは、履歴リストに格納されている最も古いディレクトリです。

この配列には、null アイテムを格納することができます。この場合、戻ることができるディレクトリが存在せず、その内容がルートディレクトリ（Microsoft Windows では C:¥ および D:¥ など）であることを表します。

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、前のディレクトリに戻るボタンを実装する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、前のディレクトリに戻るボタンを実装する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

次の例は、このプロパティを Button コントロールで使用する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、次のディレクトリに進むボタンを実装する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

次の例は、このプロパティを Button コントロールで使用する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

このプロパティを既存のディレクトリを表す File オブジェクトに設定した場合、dataProvider は直ちに null になります。 その後、このコントロールが LayoutManager で再検証されると、そのディレクトリの内容が列挙され、ディレクトリ内のファイルとサブディレクトリを表す File オブジェクトの ArrayCollection が dataProvider プロパティに設定されます。

このプロパティを既存のディレクトリを表していない File に設定するとエラーになります。 このプロパティを COMPUTER に設定すると、同期的にルートディレクトリ（Windows では C:¥ および D:¥ など）が表示されます。

このプロパティを設定すると、既に選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

このプロパティは、コントロールに表示されるサブディレクトリとファイルに加え、表示される順序に影響します。 ただし、dataProvider プロパティに設定される File インスタンスには影響せず、dataProvider に適用されるフィルター機能の動作を変化させて機能します。 このプロパティを設定しても、現在の directory は再列挙されません。

このプロパティを設定すると、選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

拡張子の大文字小文字は区別されず、先頭のドットは省略可能です。 例えば、".HTML" と指定しても "html" と指定しても動作は同じです。

名前にドットが含まれている場合でも、サブディレクトリは拡張子でフィルターされません。

enumerationMode プロパティと filterFunction プロパティも、コントロールに表示するファイルを決定する要素となります。 例えば、このプロパティが [ ".htm", ".html" ] の場合でも、enumerationMode プロパティがFileSystemEnumerationMode.DIRECTORIES_ONLY の場合や、filterFunction がファイルに対して false を返す場合、.html ファイルは表示されません。

このプロパティが null の場合、拡張子によるフィルターは行われず、すべてのファイルが表示されます。 このプロパティが空の配列の場合、すべての拡張子がフィルター処理で除外され、拡張子を持つファイルは一切表示されません。

このプロパティは、コントロールに表示されるファイルに影響します。 ただし、dataProvider プロパティに設定される File インスタンスには影響せず、dataProvider に適用されるフィルター機能の動作を変化させて機能します。 このプロパティを設定しても、現在の directory は再列挙されません。

このプロパティを設定すると、選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

この関数には次のシグネチャが必要です。

function myFilterFunction(file:File):Boolean

すべてのファイルおよびサブディレクトリがこの関数に渡されるようにするには、enumerationMode プロパティが FileSystemEnumerationMode.FILES_ONLY または FileSystemEnumerationMode.DIRECTORIES_ONLY に設定されていてはなりません。また、extensions プロパティは null でなければなりません。 そうでない場合は、この関数が呼び出される前に、これらのプロパティによって事前にフィルター処理が行われてしまいます。

このプロパティは、コントロールに表示されるサブディレクトリおよびファイルに影響します。 ただし、dataProvider プロパティに設定される File インスタンスには影響せず、dataProvider に適用されるフィルター機能の動作を変化させて機能します。 このプロパティを設定しても、現在の directory は再列挙されません。

このプロパティを設定すると、選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

この配列の最初のアイテムは、履歴リストに格納されている 1 つ先のディレクトリになります。最後のアイテムは、履歴リストに格納されている最も新しいディレクトリです。

この配列には、COMPUTER という特別な File オブジェクトを格納することができます。この場合、進むことができるディレクトリが存在せず、その内容がルートディレクトリ（Windows では C:¥ および D:¥ など）であることを表します。

次の例は、このプロパティを FileSystemHistoryButton コントロールで使用して、次のディレクトリに進むボタンを実装する方法を示したものです。

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

この関数には次のシグネチャが必要です。

function myNameCompareFunction(name1:String, name2:String):int

-1 を返すのは、name1 を name2 の前にソートする場合で、1 を返すのは、name1 を name2 の後にソートする場合です。名前が同じ場合は 0 を返します。

このプロパティを設定していない場合、大文字と小文字を区別し、ロケールに依存した方法で 2 つの名前が比較されます。この比較処理では、まず各名前に対してストリングメソッド toLocaleLowerCase() が呼び出され、< および > 演算子を使用した比較が行われます。

enumerationMode を FileSystemEnumerationMode.FILES_FIRST または FileSystemEnumerationMode.DIRECTORIES_FIRST に設定した場合は、このメソッドを使ってファイルまたはディレクトリの個別のグループ内でのみ名前の比較が行われます。

このプロパティは、コントロールに表示されるサブディレクトリおよびファイルの順序に影響します。 ただし、dataProvider プロパティに設定される File インスタンスには影響せず、dataProvider に適用されるソート処理の動作を変化させて機能します。 このプロパティを設定しても、現在の directory は再列挙されません。

このプロパティを設定すると、選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

複数のファイルが選択されている場合にこのプロパティを取得すると、selectedPaths 配列の最初のパスになります。

このプロパティを設定すると、selectedPaths、selectedItem、selectedItems、selectedIndex および selectedIndices の各プロパティに影響します。

このプロパティを設定すると、selectedPaths、selectedItem、selectedItems、selectedIndex および selectedIndices の各プロパティに影響します。

このプロパティを設定しても、表示されるアイテムや、表示される順序には影響しません。また、選択されるアイテムやスクロール位置にも影響しません。

このプロパティを設定すると、選択されていたアイテムが選択解除され、コントロールでのスクロール位置が左上隅にリセットされます。

directoryIcon スタイルおよび fileIcon スタイルを設定して、デフォルトのアイコンを変更できます。 AIR でサポートされていないので、このコントロールでは、オペレーティングシステムでそのファイルに表示される実際のアイコンを表示できません。

このプロパティを設定しても、表示されるアイテムや、表示される順序には影響しません。また、選択されるアイテムやスクロール位置にも影響しません。

ドロップインアイテムレンダラーまたはドロップインアイテムエディターとしてコントロールを使用すると、アイテムの現在の値が、このコントロールの text プロパティに自動的に書き込まれます。

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

このプロパティが null でなくなるのは、htmlDOMInitialize イベントが送出されたときです。

履歴リストは、HTML コンテンツの window.history オブジェクトに対応しています。 現在の位置未満のエントリは "後方" リスト、現在の位置を超えるエントリは "前方" リストです。最後の位置を超える位置を設定しようとすると、最後の位置に設定されます。

HTMLLoader のデフォルトの動作をオーバーライドするには、HTMLHost クラスのサブクラスを作成し、HTML コンテンツで様々なユーザーインターフェイスの変更を処理できるようにそのメンバー関数をオーバーライドします。次に、このプロパティの値を、作成したサブクラスのインスタンスに設定します。

デフォルト値は、HTMLLoader の IFactory です。

このプロパティを設定すると、location プロパティが null に設定される副作用が発生します。逆に、location プロパティを設定すると、このプロパティが null に設定されます。

htmlText プロパティ経由で追加されたコンテンツは、アプリケーションのセキュリティサンドボックス内に置かれます。AIR アプリケーションが、アプリケーションサンドボックスに配置された HTML コントロールを含んでいるときに、htmlText プロパティを設定することでリモート HTML コードが直接追加された場合、HTML テキストに含まれるすべてのスクリプトはアプリケーションサンドボックス内で実行されます。

flash.system.IMEConversionMode クラスで、このプロパティの有効な値の定数を定義します。IME を指定しない場合は、null を指定します。

MXML および ActionScript でこのプロパティを設定することはありません。このコンポーネントがドロップインアイテムレンダラーまたはドロップインアイテムエディターとして使用されるときに、Flex でプロパティが設定されます。

このプロパティが true であるのは、complete イベントが送出されていない場合です。

このプロパティが true にならない場合もあります。 complete イベントが送出されない場合も、同様の結果になります。

このプロパティを設定すると、htmlText プロパティが null に設定される副作用が発生します。逆に、htmlText プロパティを設定すると、このプロパティが null に設定されます。

このプロパティが false である場合、この Flex コントロールに指定されている背景があれば、それが HTML コンテンツの背景に表示されます。

ただし、style="background-color:gray" などで指定された独自の不透明背景色がある HTML エレメントでは、その背景が表示されます。

このプロパティが PDFCapability.STATUS_OK である場合にのみ、HTML オブジェクトで PDF のコンテンツを表示できます。 PDFCapability クラスでは、pdfCapability プロパティの値として使用できる次の定数を定義します。

このプロパティが null である場合、または HTML コンテンツの場合とは異なるセキュリティドメインの ApplicationDomain を指定している場合、HTML ページではそのドメインとしてデフォルトの ApplicationDomain が使用されます。

アプリケーションドメインですべての HTML コントロールが使用するデフォルトのユーザーエージェントストリングを設定するには、静的な URLRequestDefaults.userAgent プロパティを設定します。 userAgent プロパティに値が設定されていない場合（値が null である場合）、ユーザーエージェントストリングは URLRequestDefaults.userAgent の値に設定されます。

このコントロールの userAgent プロパティにも、URLRequestDefaults.userAgent にも値が設定されていない場合は、デフォルト値がユーザーエージェントストリングとして使用されます。 このデフォルト値は、次の 2 つの例に示すように、実行時のオペレーティングシステム（Mac OS、Windows など）、実行時の言語、および実行時のバージョンによって異なります。

      "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
      "Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
      

このプロパティを MXML の属性として指定する場合、記述子のストリング名ではなく、データ記述子への参照を使用する必要があります。プロパティを設定するには次の形式を使用します。

<mx:FlexNativeMenu id="flexNativeMenu" dataDescriptor="{new MyCustomDataDescriptor()}"/>

また、次の例に示すように、ネストしたサブタグとして MXML のプロパティを指定できます。

<mx:FlexNativeMenu>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

デフォルト値は、DefaultDataDescriptor クラスの内部インスタンスです。

FlexNativeMenu コントロールは、ソースデータオブジェクトを次のように処理します。

• 有効な XML テキストを含むストリングが XML オブジェクトに変換されます。
• XMLNode は、XML オブジェクトに変換されます。
• また XMLList は、XMLListCollection に変換されます。
• ICollectionView インターフェイスを実装するすべてのオブジェクトが ICollectionView にキャストされます。
• Array は ArrayCollection に変換されます。
• 他のタイプのオブジェクトは、Array 内でその単一エントリとしてラップされます。

keyEquivalentFunction プロパティを設定すると、このプロパティは無視されます。

keyEquivalentFunction プロパティは、フォーマット処理やローカライズにも使用でき、プラットフォームに依存しません。

このキー相当物関数は単一の引数を取得します。この引数は、データプロバイダー内のアイテムであり、ストリングを返します。

myKeyEquivalentFunction(item:Object):String

keyEquivalentModifiersFunction プロパティは、フォーマット処理やローカライズにも使用でき、プラットフォームに依存しません。

このキー相当物のモディファイア関数は単一の引数を取得します。この引数は、データプロバイダー内のアイテムであり、モディファイアキー名の配列を返します。

myKeyEquivalentModifiersFunction(item:Object):Array

ラベルでは、アンダースコアを前に付けることによって、ニーモニックインデックスとして使用される文字を指定できます。 例えば、"C_ut" というラベル値の場合、ニーモニックインデックスが 1 に設定されます。 この目的に使用されるのは、最初のアンダースコアだけです。 ラベル内にリテラルアンダースコア文字を表示するには、アンダースコアを 2 つ使用することによってエスケープできます。 例えば、"C__u_t" というラベル値は、"C_ut" というラベルを持ち、ニーモニックインデックスが 3 （"t" 文字）であるメニューアイテムになります。 mnemonicIndexField プロパティで定義されているフィールドが存在し、それが 0 より大きい値に設定されている場合は、アンダースコアで指定されているニーモニックインデックス値よりもその値が優先されます。

labelFunction プロパティを設定すると、このプロパティは無視されます。

このプロパティを省略すると、labelField プロパティで指定したフィールドまたは属性の値が使用されます。 このプロパティを指定した場合、labelField プロパティの値は無視されます。

labelFunction プロパティは、フォーマット処理やローカライズに役立ち、プラットフォームに依存しません。

このラベル関数は単一の引数を取得します。この引数は、データプロバイダー内のアイテムであり、ストリングを返します。

myLabelFunction(item:Object):String

このプロパティに指定されているフィールドに 0 より大きい数が含まれている場合は、そのニーモニックインデックスは、ラベル内のアンダースコアによって指定された数よりも優先されます。

mnemonicIndexFunction プロパティを設定すると、このプロパティは無視されます。

このプロパティを省略すると、mnemonicIndexField プロパティで指定したフィールドまたは属性の値が使用されます。 このプロパティを指定した場合、mnemonicIndexField プロパティの値は無視されます。

このプロパティが定義されており、関数がデータアイテムに対して 0 より大きい数を返す場合は、ラベル内のアンダースコアによって指定された数よりも返されたニーモニックインデックスが優先されます。

mnemonicIndexFunction プロパティは、フォーマット処理やローカライズにも使用でき、プラットフォームに依存しません。

このニーモニックインデックス関数は単一のパラメーターを取得します。このパラメーターは、データプロバイダー内のアイテムであり、int を返します。

myMnemonicIndexFunction(item:Object):int

データプロバイダーにルートノードがあり、showRoot プロパティが false に設定されている場合、FlexNativeMenu コントロールによって表示される最上位のメニューアイテムは、ルートノードの直下の下位要素に対応します。

このフラグは、リストや配列などのルートノードがないデータプロバイダーを使用する場合には、影響しません。