パッケージ	mx.controls
クラス	public class FileSystemDataGrid
継承	FileSystemDataGrid DataGrid DataGridBase ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

各アイテムで表示される情報には、それぞれの名前（必要に応じて一般的なアイコンを表示）、タイプ、サイズ、作成日および変更日があります。 これを行うために、FileSystemDataGrid は、5 つの列（DataGridColumn インスタンス） -- nameColumn、typeColumn、sizeColumn creationDateColumn、および modificationDateColumn -- を自動的に作成し、columns プロパティをこれらの 5 つのインスタンスの配列に設定します。それぞれの列のインスタンスは、適切な labelFunction や sortCompareFunction などを持つように自動的に設定されます。これら 5 つの列の一部が不要な場合や列の順番を変更する場合は、columns プロパティを再設定します。 labelFunction の変更など、列をカスタマイズする場合は、単にそのプロパティを該当の列オブジェクトに再度割り当てます。

表示データを変更するには、dataProvider プロパティを使用するのではなく、directory プロパティを設定します。 これにより、ディレクトリの内容が列挙され、自動的に dataProvider プロパティに値が設定されます。dataProvider をユーザー自身が設定することは避けてください。

次の例に示すように、File インスタンスへの directory プロパティを設定します。

<mx:FileSystemDataGrid directory="{File.desktopDirectory}"/>

enumerationMode を設定することで、ファイルやサブディレクトリまたはその両方を表示するかどうか指定できます。両方表示する場合は、ディレクトリを最初に表示、ファイルを最初に表示、両方を混在して表示の 3 種類の表示方法が用意されています。

extensions プロパティを設定して、指定の拡張子を持つファイルのみが表示されるように表示アイテムをフィルタ処理できます。showHidden プロパティによって、通常はオペレーティングシステムが非表示にしているファイルおよびサブディレクトリをコントロールに表示するかどうかを制御できます。filterFunction を指定するとカスタムフィルタ処理が可能です。また、nameCompareFunction を指定するとカスタムソートが可能です。

AIR ではファイルシステムの変更通知をサポートしていないので、ファイルの作成、削除、移動または名前変更が行われても自動的に反映されません。つまり、ファイルシステムの古い情報が表示されている可能性があります。 ただし、refresh() を呼び出すことで、現在の directory を再列挙することができます。例えば、コントロールの表示内容が最新でなくなるファイル操作を実行した場合や、ユーザーがアプリケーションを非アクティブにして再アクティブにした場合に、この方法を使用できます。

showIcons プロパティを使用して、アイコンを表示または非表示にできます。また、showExtensions を使用して、ファイル拡張子を表示または非表示にできます。

このコントロールには findItem() および findIndex() の 2 つのメソッドが用意されています。これらを使用して、表示されているファイルとサブディレクトリを検索し、指定の nativePath を持つファイルまたはサブディレクトリを探し出すことができます。

selectedPath および selectedPaths の 2 種類のプロパティは、selectedItem および selectedItems、または selectedIndex および selectedIndices と同様に機能しますが、nativePath ストリングを使用して選択範囲を指定できます。特定のアイテムがあらかじめ選択されているディレクトリを表示する必要がある場合、ディレクトリの列挙時にコントロールが作成する File アイテムがまだないので、これらのプロパティを使用すると便利です。

このコントロールでは、ユーザーはマウスまたはキーボードを使用して他のディレクトリに移動できます。ユーザーは、サブディレクトリをダブルクリックする、サブディレクトリが選択された状態で Enter キーまたは Ctrl キーを押しながら下矢印キーを押す、COMPUTER ディレクトリが表示されていない状態で Ctrl キーを押しながら上矢印キーを押すという方法でディレクトリの変更を試行できます。また、以前に移動したディレクトリが存在する場合は、Ctrl キーを押しながら左矢印キーを押して戻ったり、以前のディレクトリから戻ってきた場合は、Ctrl キーを押しながら右矢印キーを押してそのディレクトリに進んだりできます。ユーザーが、現在表示されているディレクトリの変更を試行すると、キャンセル可能な directoryChanging イベントがコントロールから送出されます。 event.preventDefault() を呼び出すことによってこのイベントをキャンセルしない場合は、コントロールに新しいディレクトリの内容が表示され、directory プロパティが変更されます。directory プロパティが変更されるたびに directoryChange イベントが送出され、変更が通知されます。

「上へ」および「下へ」移動する操作をサポートするため、FileSystemList には canNavigateUp および canNavigateDown プロパティと、navigateUp() および navigateDown() メソッドが用意されています。また、任意のディレクトリに移動する navigateTo() も用意されています。

ユーザーが移動したディレクトリはコントロールによって管理されるので、「戻る」および「進む」の移動操作を容易にサポートできます。 詳細については、backHistory、forwardHistory、canNavigateBack、および canNavigateForward プロパティと、navigateBack() および navigateForward() メソッドを参照してください。

メモ：各アイテムに使用されるアイコンは、汎用のファイルアイコンおよびディレクトリアイコンです。これらは、fileIcon および directoryIcon スタイルを使用して設定できます。 Flex のリストベースのコントロールで表示できるアイコンは現時点では埋め込みアイコンのみで、実行時に読み込まれるアイコンは使用できません。したがって、オペレーティングシステムで実際には表示されるファイルシステムアイコンは、File の icon プロパティを使用して AIR からアクセスできても、FileSystemDataGrid では表示できません。

MXML シンタックスを表示

MXML シンタックスを隠す

  <mx:FileSystemDataGrid
    Properties
    dateFormatString=""
    directory="null"
    enumerationMode="directoriesFirst"
    extensions="null"
    filterFunction="null"
    nameCompareFunction="null"
    selectedPath="null"
    selectedPaths="null"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    Styles
    directoryIcon="TreeNodeIcon"
    fileIcon="TreeNodeIcon"
 
    Events
    directoryChange="No default"
    directoryChanging="No default"
    fileChoose="No default"
  />
  

関連項目