ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
Navigating to relative paths
Adobe AIR 1.0 and later
You can use the resolvePath() method to obtain a path relative to another given path. For example, the following
code sets a File object to point to an "AIR Test" subdirectory of the user's home directory:
var file:File = File.userDirectory;
file = file.resolvePath("AIR Test");
You can also use the url property of a File object to point it to a directory based on a URL string, as in the following:
var urlStr:String = "file:///C:/AIR Test/";
var file:File = new File()
file.url = urlStr;
For more information, see “Modifying File paths” on page 676.
Letting the user browse to select a directory
Adobe AIR 1.0 and later
The File class includes the browseForDirectory() method, which presents a system dialog box in which the user can
select a directory to assign to the object. The browseForDirectory() method is asynchronous. The File object
dispatches a select event if the user selects a directory and clicks the Open button, or it dispatches a cancel event if
the user clicks the Cancel button.
For example, the following code lets the user select a directory and outputs the directory path upon selection:
var file:File = new File();
file.addEventListener(Event.SELECT, dirSelected);
file.browseForDirectory("Select a directory");
function dirSelected(e:Event):void {
trace(file.nativePath);
}
Note: On Android, the browseForDirectory() method is not supported. Calling this method has no effect; a cancel
event is dispatched immediately. To allow users to select a directory, use a custom, application-defined dialog, instead.
Pointing to the directory from which the application was invoked
Adobe AIR 1.0 and later
You can get the directory location from which an application is invoked, by checking the currentDirectory property
of the InvokeEvent object dispatched when the application is invoked. For details, see “Capturing command line
arguments” on page 878.
Pointing a File object to a file
Adobe AIR 1.0 and later
There are different ways to set the file to which a File object points.
Last updated 6/6/2012
674