ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
The storageVolume property of the StorageVolumeChangeEvent object is undefined (null) for an unmounted
volume. However you can access the rootDirectory property of the event.
The following code outputs the name and file path of a storage volume when it is mounted:
StorageVolumeInfo.storageVolumeInfo.addEventListener(StorageVolumeChangeEvent.STORAGE_VOLUME
_MOUNT, onVolumeMount);
function onVolumeMount(event:StorageVolumeChangeEvent):void
{
trace(event.storageVolume.name, event.rootDirectory.nativePath);
}
The following code outputs the file path of a storage volume when it is unmounted:
StorageVolumeInfo.storageVolumeInfo.addEventListener(StorageVolumeChangeEvent.STORAGE_VOLUME
_UNMOUNT, onVolumeUnmount);
function onVolumeUnmount(event:StorageVolumeChangeEvent):void
{
trace(event.rootDirectory.nativePath);
}
The StorageVolumeInfo.storageVolumeInfo object includes a getStorageVolumes() method. This method
returns a vector of StorageVolume objects corresponding to the currently mounted storage volumes. The following
code shows how to list the names and root directories of all mounted storage volumes:
var volumes:Vector. = new Vector.;
volumes = StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
for (var i:int = 0; i < volumes.length; i++)
{
trace(volumes[i].name, volumes[i].rootDirectory.nativePath);
}
Note: On modern Linux distributions, the getStorageVolumes() method returns objects corresponding to physical
devices and network drives mounted at particular locations.
The File.getRootDirectories() method lists the root directories (see “Pointing to the file system root” on
page 673. However, the StorageVolume objects (enumerated by the StorageVolumeInfo.getStorageVolumes()
method) provides more information about the storage volumes.
You can use the spaceAvailable property of the rootDirectory property of a StorageVolume object to get the space
available on a storage volume. (See “Determining space available on a volume” on page 679.)
For information about storage volumes on AIR for TV devices, see “Directory view for AIR for TV applications” on
page 670.
More Help topics
StorageVolume
StorageVolumeInfo
Reading and writing files
Adobe AIR 1.0 and later
The FileStream class lets AIR applications read and write to the file system.
Last updated 6/6/2012
687