FileSystemList  - AS3 Flex

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

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

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

    <mx:FileSystemList 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 でアクセスできる場合でも、FileSystemList には表示されません。

MXML シンタックスを表示

MXML シンタックスを隠す

  <mx:FileSystemList
    Properties
    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"
  />
  

デフォルトの MXML プロパティdataProvider

関連する API エレメント