flash.filesystem.StorageVolume - Adobe® AIR® API Reference for HTML Developers

window.runtime property	window.runtime.flash.filesystem.StorageVolume

Inheritance	StorageVolume Object

Runtime Versions:

A StorageVolume object includes properties defining a mass storage volume. This class is used in two ways:

The storageVolume property of a StorageVolumeChangeEvent object is a StorageVolume object. This object represents the storage volume that has been mounted or unmounted.
The StorageVolumeInfo.storageVolumeInfo.getStorageVolumes() method returns a vector of StorageVolume objects. Each of these StorageVolume objects represents a mounted storage volume.

View the examples

Properties

Hide Inherited Public Properties

Show Inherited Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		drive : String [read-only] The volume drive letter on Windows.	StorageVolume
		fileSystemType : String [read-only] The type of file system on the storage volume (such as "FAT", "NTFS", "HFS", or "UFS").	StorageVolume
		isRemovable : Boolean [read-only] Whether the operating system considers the storage volume to be removable (true) or not (false).	StorageVolume
		isWritable : Boolean [read-only] Whether a volume is writable (true) or not (false).	StorageVolume
		name : String [read-only] The name of the volume.	StorageVolume
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		rootDirectory : File [read-only] A File object corresponding to the root directory of the volume.	StorageVolume

Public Methods

Hide Inherited Public Methods

Show Inherited Methods

	Method		Defined By
		StorageVolume(rootDirPath:File, name:String, writable:Boolean, removable:Boolean, fileSysType:String, drive:String) The constructor function.	StorageVolume
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Property Detail

drive

property

drive:String [read-only]

Runtime Versions:

The volume drive letter on Windows. On other platforms, this property is set to null.

fileSystemType

property

fileSystemType:String [read-only]

Runtime Versions:

The type of file system on the storage volume (such as "FAT", "NTFS", "HFS", or "UFS").

Example ( How to use this example )

The following code lists the native path for the root directory and the file system type of each mounted storage volume:

var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
for (var i = 0; i < volumes.length; i++)
{
    air.trace(volumes[i].rootDirectory.nativePath, "(" + volumes[i].fileSystemType + ")");
}

isRemovable

property

isRemovable:Boolean [read-only]

Runtime Versions:

Whether the operating system considers the storage volume to be removable (true) or not (false).

The following table lists the values StorageVolume.isRemovable property for various types of devices:

Type of device	Mac OS	Windows	Linux
CD/DVD (fixed)	true	true	true
USB flash drive	true	true	true
USB hard srive	false	false	true
FireWire hard drive	false	false	true
Shared volume	true	false	- ¹
Network drive	false	false	false
Storage card reader (empty)	- ²	false	- ²
Storage card reader (with SD/CF card)	true	true	true

¹ Linux does not have a concept of a shared volume.

² On Windows, an empty card reader is listed as a non-removable device. On Mac OS and Linux, empty car readers are not listed as storage volumes.

Example ( How to use this example )

The following code outputs a list of non-removable storage volumes, followed by a list of removable storage volumes:

var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();

air.trace("Non-removeable volumes:");
for (var i = 0; i < volumes.length; i++)
{
    if (!volumes[i].isRemovable)
    {
        air.trace(volumes[i].rootDirectory.nativePath);
    }
}

air.trace("\nRemoveable volumes:");
for (i = 0; i < volumes.length; i++)
{
    if (volumes[i].isRemovable)
    {
        air.trace(volumes[i].rootDirectory.nativePath);
    }
}

isWritable

property

isWritable:Boolean [read-only]

Runtime Versions:

Whether a volume is writable (true) or not (false).

Note: You can determine the amount of space available on a volume by calling the rootDirectory.spaceAvailble property of the StorageVolume object.

Example ( How to use this example )

The following code outputs a list of writable storage volumes and the space available on each:

var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();

for (var i = 0; i < volumes.length; i++)
{
    if(volumes[i].isWritable)
    {         
        air.trace(volumes[i].rootDirectory.nativePath, volumes[i].rootDirectory.spaceAvailable);
    }
}

name

property

name:String [read-only]

Runtime Versions:

The name of the volume. If there is no name, this property is set to null.

Example ( How to use this example )

The following code lists the native path for the root directory and the file system name (if there is one) of each mounted storage volume:

var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
for (var i; i < volumes.length; i++)
{
    var name = new String();
    if (volumes[i].name)
    {
        name = "(" + volumes[i].name + ")";
    }
    air.trace(volumes[i].rootDirectory.nativePath, name);
}

rootDirectory

property

rootDirectory:File [read-only]

Runtime Versions:

A File object corresponding to the root directory of the volume.

Example ( How to use this example )

The following code lists the native path for the root directory of each mounted storage volume:

var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
for (var i = 0; i < volumes.length; i++)
{
    air.trace(volumes[i].rootDirectory.nativePath);
}

Constructor Detail

StorageVolume

()

Constructor

public function StorageVolume(rootDirPath:File, name:String, writable:Boolean, removable:Boolean, fileSysType:String, drive:String)

Runtime Versions:

The constructor function. Generally, you do not call this constructor function directly (to create new StorageVolume objects). Rather, you reference StorageVolume objects by accessing the storageVolume property of a StorageVolumeChangeEvent object or by calling StorageVolumeInfo.storageVolumeInfo.getStorageVolumes().

Parameters

	`rootDirPath:File`

	`name:String`

	`writable:Boolean`

	`removable:Boolean`

	`fileSysType:String`

	`drive:String`

Examples

The following code lists the properties of each mounted storage volume:

<html>
   <head>
   <title>Test</title>
   <script type="text/javascript" src="AIRAliases.js"></script>
   <script type="text/javascript"> 
   
   function traceVolumes()
   {
      var volumes = air.StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
      for (var i = 0; i < volumes.length; i++)
      {
         var volume = volumes[i];
         air.trace("nativePath:", volume.rootDirectory.nativePath);
         air.trace("fileSystemType:", volume.fileSystemType);
         air.trace("isRemovable:", volume.isRemovable);
         air.trace("isWritable:", volume.isWritable);
         air.trace("drive:", volume.drive);
         air.trace("name:", volume.name);
         air.trace("________________________________________________________");
      }
   }
   
   </script>
   </head>
   
   <body onload="traceVolumes()">
   </body>
</html>

The following code lists the properties of each storage volume that becomes mounted or unmounted. Note that the storageVolume property of the StorageVolumeChangeEvent is only set for the storageVolumeMount event; it is null for the storageVolumeUnmount event:

air.StorageVolumeInfo.storageVolumeInfo.addEventListener(air.StorageVolumeChangeEvent.STORAGE_VOLUME_MOUNT, mountEventHandler);
air.StorageVolumeInfo.storageVolumeInfo.addEventListener(air.StorageVolumeChangeEvent.STORAGE_VOLUME_UNMOUNT, unmountEventHandler);

function mountEventHandler(event)
{            
    var volume = event.storageVolume;
    air.trace("VOLUME MOUNTED:");
    air.trace("nativePath:", event.rootDirectory.nativePath);
    air.trace("fileSystemType:", volume.fileSystemType);
    trace("isRemovable:", volume.isRemovable);
    air.trace("isWritable:", volume.isWritable);
    air.trace("drive:", volume.drive);
    air.trace("name:", volume.name);
    air.trace();
}
function unmountEventHandler(event)
{            
    air.trace("VOLUME UNMOUNTED:");
    air.trace("nativePath:", event.rootDirectory.nativePath);
    air.trace();
}

[an error occurred while processing this directive][an error occurred while processing this directive]

Legal Notices | Online Privacy Policy