Adobe® Flex® 4 Language Reference
Show Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
flash.filesystem 
StorageVolumeInfo 
Packageflash.filesystem
Classpublic final class StorageVolumeInfo
InheritanceStorageVolumeInfo Inheritance EventDispatcher Inheritance Object

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

The StorageVolumeInfo object dispatches a StorageVolumeChangeEvent object when a storage volume is mounted or unmounted. The StorageVolume.storageVolume static property references the singleton StorageVolumeInfo object, which dispatches the events. The StorageVolumeInfo class also defines a getStorageVolumes method for listing currently mounted storage volumes.

On modern Linux distributions, the StorageVolumeInfo object only dispatches storageVolumeMount and storageVolumeUnmount events for physical devices and network drives mounted at particular locations.



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  AIR-only isSupported : Boolean
[static] [read-only] The isSupported property is set to true if the StorageVolumeInfo class is supported on the current platform, otherwise it is set to false.
StorageVolumeInfo
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  AIR-only storageVolumeInfo : StorageVolumeInfo
[static] [read-only] The singleton instance of the StorageVolumeInfo object.
StorageVolumeInfo
Public Methods
 MethodDefined By
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
 Inherited
Dispatches an event into the event flow.
EventDispatcher
  
Returns vector of StorageVolume objects corresponding to the currently mounted storage volumes.
StorageVolumeInfo
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Events
 Event Summary Defined By
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
  Dispatched when a storage volume has been mounted.StorageVolumeInfo
  Dispatched when a storage volume has been unmounted.StorageVolumeInfo
Property Detail
AIR-only 

isSupported

property
isSupported:Boolean  [read-only]

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

The isSupported property is set to true if the StorageVolumeInfo class is supported on the current platform, otherwise it is set to false.



Implementation
    public static function get isSupported():Boolean
AIR-only 

storageVolumeInfo

property 
storageVolumeInfo:StorageVolumeInfo  [read-only]

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

The singleton instance of the StorageVolumeInfo object. Register event listeners on this object for the storageVolumeMount and storageVolumeUnmount events.



Implementation
    public static function get storageVolumeInfo():StorageVolumeInfo
Method Detail

AIR-only getStorageVolumes

()method
public function getStorageVolumes():Vector.<StorageVolume>

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

Returns vector of StorageVolume objects corresponding to the currently mounted storage volumes.

On modern Linux distributions, this method returns objects corresponding to physical devices and network drives mounted at particular locations.

Returns
Vector.<StorageVolume>

See also


Example  ( How to use this example )

The following code lists the native path for the root directory of each mounted storage volume:
var volumes:Vector.<StorageVolume> = new Vector.<StorageVolume>;
volumes = StorageVolumeInfo.storageVolumeInfo.getStorageVolumes();
for (var i:int = 0; i < volumes.length; i++)
{
    trace(volumes[i].rootDirectory.nativePath);
}
Event Detail
AIR-only 

storageVolumeMount

Event
Event Object Type: flash.events.StorageVolumeChangeEvent
property StorageVolumeChangeEvent.type = flash.events.StorageVolumeChangeEvent.STORAGE_VOLUME_MOUNT

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

Dispatched when a storage volume has been mounted.

On modern Linux distributions, the StorageVolumeInfo object only dispatches storageVolumeMount and storageVolumeUnmount events for physical devices and network drives mounted at particular locations.

The StorageVolumeChangeEvent.VOLUME_MOUNT constant defines the value of the type property of a StorageVolumeChangeEvent when a volume is mounted.

The event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
currentTargetThe StorageVolumeChangeEvent object.
fileA File object representing the storage volume.
nameThe name of the storage volume.
targetThe StorageVolumeChangeEvent object.
type"storageVolumeMount"
AIR-only 

storageVolumeUnmount

Event  
Event Object Type: flash.events.StorageVolumeChangeEvent
property StorageVolumeChangeEvent.type = flash.events.StorageVolumeChangeEvent.STORAGE_VOLUME_UNMOUNT

Language Version: ActionScript 3.0
Runtime Versions: AIR 2

Dispatched when a storage volume has been unmounted.

On modern Linux distributions, the StorageVolumeInfo object only dispatches storageVolumeMount and storageVolumeUnmount events for physical devices and network drives mounted at particular locations.

The StorageVolumeChangeEvent.VOLUME_MOUNT constant defines the value of the type property of a StorageVolumeChangeEvent when a volume is unmounted.

The event has the following properties:

PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
currentTargetThe StorageVolumeChangeEvent object.
fileA File object representing the storage volume.
nameThe name of the storage volume.
targetThe StorageVolumeChangeEvent object.
type"storageVolumeUnmount"