AIR での File オブジェクトの操作

File オブジェクトでユーザーのホームディレクトリを参照できます。次のコードでは、ホームディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.userDirectory.resolvePath("AIR Test");

File オブジェクトでユーザーのドキュメントディレクトリを参照できます。次のコードでは、ドキュメントディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.documentsDirectory.resolvePath("AIR Test");

File オブジェクトでデスクトップを参照できます。次のコードでは、デスクトップの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.desktopDirectory.resolvePath("AIR Test");

File オブジェクトでアプリケーション記憶領域ディレクトリを参照できます。AIR アプリケーションにはそれぞれ、アプリケーション記憶領域ディレクトリを定義する一意のパスが関連付けられています。このディレクトリは、アプリケーションおよびユーザーごとに一意に割り当てられます。このディレクトリは、ユーザーおよびアプリケーションに固有のデータ（ユーザーデータや環境設定ファイルなど）を格納するために使用できます。例えば、次のコードでは、アプリケーション記憶領域ディレクトリに格納されている prefs.xml という環境設定ファイルを File オブジェクトで参照します。

var file = air.File.applicationStorageDirectory; 
file = file.resolvePath("prefs.xml");

通常、アプリケーション記憶領域ディレクトリの場所は、ユーザー名とアプリケーション ID に基づきます。次に示すファイルシステムの場所は、アプリケーションをデバッグする場合に使用できます。このディレクトリ内のファイルを解決するには、 File.applicationStorage プロパティまたは app-storage: URI スキームを常に使用する必要があります。

• Mac OS の場合

  /Users/ user name /Library/Preferences/ applicationID /Local Store/

  次に、例を示します。

  /Users/babbage/Library/Preferences/com.example.TestApp/Local Store

• Windows の場合（Documents and Settings ディレクトリ内）

  C:¥Documents and Settings\user name \Application Data\ applicationID ¥Local Store¥

  次に、例を示します。

  C:\Documents and Settings\babbage\Application Data\com.example.TestApp\Local Store

• Linux の場合

  /home/ user name /.appdata/ applicationID /Local Store/

  次に、例を示します。

  /home/babbage/.appdata/com.example.TestApp/Local Store

File.applicationStorageDirectory で作成された File オブジェクトの URL （および url プロパティ）では、次のように app-storage URL スキーム（ サポートされる AIR URL スキーム を参照）が使用されます。

var dir = air.File.applicationStorageDirectory; 
dir = dir.resolvePath("prefs.xml"); 
air.trace(dir.url); // app-storage:/preferences

File オブジェクトで、アプリケーションがインストールされたディレクトリ（アプリケーションディレクトリ）を参照できます。このディレクトリを参照するには、 File.applicationDirectory プロパティを使用します。このディレクトリでは、アプリケーション記述ファイルなど、アプリケーションと共にインストールされたリソースを確認できます。例えば、次のコードでは、アプリケーションディレクトリにある images というディレクトリを File オブジェクトで参照します。

var dir = air.File.applicationDirectory; 
dir = dir.resolvePath("images");

File.applicationDirectory で作成された File オブジェクトの URL （および url プロパティ）では、次のように app URL スキーム（ サポートされる AIR URL スキーム を参照）が使用されます。

var dir = air.File.applicationDirectory; 
dir = dir.resolvePath("images"); 
air.trace(dir.url); // app:/images

File.getRootDirectories() メソッドは、すべてのルートボリュームの一覧を出力します。Windows コンピューターの場合は、C: およびマウントされたボリュームが含まれます。Mac OS および Linux の場合は、常にマシンの一意のルートディレクトリ（「/」ディレクトリ）が返されます。 StorageVolumeInfo.getStorageVolumes() メソッドは、マウントされたストレージボリュームに関する詳細を提供します（ ストレージボリュームの操作 を参照）。

File オブジェクトの nativePath プロパティを設定することにより、File オブジェクトで明示的なディレクトリを参照できます。Windows の場合の例を次に示します。

var file = new air.File(); 
file.nativePath = "C:\\AIR Test";

重要： このような方法で明示的なパスを参照すると、コードが複数のプラットフォームにわたって機能しなくなる可能性があります。例えば、前の例は Windows 上でのみ機能します。クロスプラットフォームで機能するディレクトリを見つけるには、 File.applicationStorageDirectory などの File オブジェクトの静的プロパティを使用します。次に、 resolvePath() メソッド（次の節を参照）を使用して、相対パスに移動します。

resolvePath() メソッドを使用すると、別の特定のパスを基準とした相対的なパスを取得できます。例えば、次のコードでは、ユーザーのホームディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.userDirectory; 
file = file.resolvePath("AIR Test");

また、次のように、File オブジェクトの url プロパティを使用すると、URL ストリングに基づいてディレクトリを参照することもできます。

var urlStr = "file:///C:/AIR Test/"; 
var file = new air.File() 
file.url = urlStr;

詳しくは、 File パスの変更 を参照してください。

File クラスの browseForDirectory() メソッドを使用すると、ユーザーがオブジェクトに割り当てるディレクトリを選択できるシステムダイアログボックスを表示できます。 browseForDirectory() メソッドは、非同期のメソッドです。File オブジェクトでは、ユーザーがディレクトリを選択して「開く」ボタンをクリックすると select イベントを送出し、ユーザーが「キャンセル」ボタンをクリックすると cancel イベントを送出します。

例えば、次のコードでは、ユーザーがディレクトリを選択できるようにし、その選択に応じたディレクトリパスを出力します。

var file = new air.File(); 
file.addEventListener(air.Event.SELECT, dirSelected); 
file.browseForDirectory("Select a directory"); 
function dirSelected(event) { 
    alert(file.nativePath); 
}

アプリケーションを起動したディレクトリの場所を取得するには、アプリケーションの起動時に送出された InvokeEvent オブジェクトの currentDirectory プロパティを確認します。詳しくは、 コマンドライン引数のキャプチャ を参照してください。

重要： 明示的なパスを参照すると、コードが複数のプラットフォームにわたって機能しなくなる可能性があります。例えば、C:¥foo.txt というパスは、Windows 上でのみ機能します。クロスプラットフォームで機能するディレクトリを見つけるには、 File.applicationStorageDirectory などの File オブジェクトの静的プロパティを使用します。次に、 resolvePath() メソッド（ File パスの変更 を参照）を使用して、相対パスに移動します。

次のように、File オブジェクトの url プロパティを使用すると、URL ストリングに基づいてファイルまたはディレクトリを参照できます。

var urlStr = "file:///C:/AIR Test/test.txt"; 
var file = new air.File() 
file.url = urlStr;

URL は、次のように File() コンストラクター関数に渡すこともできます。

var urlStr = "file:///C:/AIR Test/test.txt"; 
var file = new air.File(urlStr);

url プロパティでは、常に URI エンコード形式の URL が返されます（例えば、スペースは "%20 に置き換えられます）。

file.url = "file:///c:/AIR Test"; 
alert(file.url); // file:///c:/AIR%20Test

また、File オブジェクトの nativePath プロパティを使用して明示的なパスを設定することもできます。例えば、次のコードを Windows コンピューターで実行すると、C: ドライブの AIR Test サブディレクトリにある test.txt ファイルを参照するように File オブジェクトが設定されます。

var file = new air.File(); 
file.nativePath = "C:/AIR Test/test.txt";

このパスは、次のように File() コンストラクター関数に渡すこともできます。

var file = new air.File("C:/AIR Test/test.txt");

nativePath プロパティのパス区切り文字としては、スラッシュ（/）を使用します。Windows では、円記号（¥）も使用できますが、その場合、アプリケーションが複数のプラットフォームにわたって機能しなくなる可能性があります。

詳しくは、 File パスの変更 を参照してください。

File オブジェクトの getDirectoryListing() メソッドを使用すると、ディレクトリのルートレベルにあるファイルおよびサブディレクトリを参照する File オブジェクトの配列を取得することができます。詳しくは、 ディレクトリの列挙 を参照してください。

File クラスには、ユーザーがオブジェクトに割り当てるファイルを選択できるシステムダイアログボックスを表示する以下のメソッドがあります。

• browseForOpen()

• browseForSave()

• browseForOpenMultiple()

これらのメソッドでは、いずれも非同期で処理が行われます。 browseForOpen() メソッドと browseForSave() メソッドでは、ユーザーがファイル（browseForSave() の場合はターゲットパス）を選択すると select イベントを送出します。 browseForOpen() メソッドと browseForSave() メソッドのターゲットの File オブジェクトは、その選択に応じて、選択されたファイルを参照します。 browseForOpenMultiple() メソッドでは、ユーザーがファイルを選択すると selectMultiple イベントを送出します。 selectMultiple イベントは FileListEvent 型のイベントで、その files プロパティに（選択されたファイルを参照する） File オブジェクトの配列が格納されます。

例えば、次のコードでは、ファイルを選択するための「開く」ダイアログボックスが表示されます。

var fileToOpen = air.File.documentsDirectory; 
selectTextFile(fileToOpen); 
 
function selectTextFile(root) 
{ 
    var txtFilter = new air.FileFilter("Text", "*.as;*.css;*.html;*.txt;*.xml"); 
    root.browseForOpen("Open", new window.runtime.Array(txtFilter)); 
    root.addEventListener(air.Event.SELECT, fileSelected); 
} 
 
function fileSelected(event) 
{ 
    trace(fileToOpen.nativePath); 
}

アプリケーションで別の参照ダイアログボックスが開かれている場合に参照メソッドを呼び出すと、ランタイムから Error 例外がスローされます。