StorageVolumeChangeEvent

包	flash.events
类	public class StorageVolumeChangeEvent
继承	StorageVolumeChangeEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

安装或卸载存储卷时，StorageVolumeInfo.storageVolumeInfo 对象将调度 StorageVolumeChangeEvent 事件对象。有两种类型的 StorageVolumeChangeEvent： storageVolumeMount 和 storageVolumeUnmount。

在 Linux 上，StorageVolumeInfo 对象只为物理设备调度 storageVolumeMount 和 storageVolumeUnmount 事件。用户通过网络装载或卸载卷时，该对象不调度事件。

有些设备，如一些数字摄像头和电话，显示在 StorageVolumeInfo.getStorageVolumes() 数组中，但在安装或卸载时，它们不调度 StorageVolumeChangeEvent 对象。

相关 API 元素

flash.filesystem.StorageVolumeInfo

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		rootDirectory : File [只读] 与安装的卷的根目录相对应的 File 对象。	StorageVolumeChangeEvent
		storageVolume : StorageVolume [只读] 一个包含有关安装的卷的信息的 StorageVolume 对象。	StorageVolumeChangeEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		StorageVolumeChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, path:File = null, volume:StorageVolume = null) 创建 StorageVolumeChangeEvent 对象作为参数传递给事件侦听器。	StorageVolumeChangeEvent
		clone():Event [覆盖] 复制 Event 子类的实例。	StorageVolumeChangeEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，其中包含 Event 对象的所有属性。	StorageVolumeChangeEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		STORAGE_VOLUME_MOUNT : String = "storageVolumeMount" [静态] 当安装卷时，StorageVolumeChangeEvent.VOLUME_MOUNT 常量定义 StorageVolumeChangeEvent 的 type 属性的值。	StorageVolumeChangeEvent
		STORAGE_VOLUME_UNMOUNT : String = "storageVolumeUnmount" [静态] 当卸载卷时，StorageVolumeChangeEvent.VOLUME_MOUNT 常量定义 StorageVolumeChangeEvent 的 type 属性的值。	StorageVolumeChangeEvent

属性详细信息

rootDirectory

属性

rootDirectory:File [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

与安装的卷的根目录相对应的 File 对象。如果已卸载了卷（如果事件类型是 storageVolumeUnmount），则此属性设置为 null。

实现
public function get rootDirectory():File

相关 API 元素

flash.filesystem.File

storageVolume

属性

storageVolume:StorageVolume [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

一个包含有关安装的卷的信息的 StorageVolume 对象。对于卸载的卷，此属性为 null（对于 storageVolumeUnmount 事件）。

实现
public function get storageVolume():StorageVolume

相关 API 元素

flash.filesystem.StorageVolume

构造函数详细信息

()

构造函数

public function StorageVolumeChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, path:File = null, volume:StorageVolume = null)

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

创建 StorageVolumeChangeEvent 对象作为参数传递给事件侦听器。

参数

	`type:String` — 事件的类型，可在 `type` 属性中访问。StorageVolumeChangeEvent 类定义两种事件类型：`storageVolumeMount` 事件，由 `StorageVolumeChangeEvent.STORAGE_VOLUME_MOUNT` 常量表示；`storageVolumeUnmount` 事件，由 `StorageVolumeChangeEvent.STORAGE_VOLUME_UNMOUNT` 常量表示。

	`bubbles:Boolean` (default = `false`) — 确定 Event 对象是否参与事件流的冒泡阶段。默认值为 `false`。

	`cancelable:Boolean` (default = `false`) — 确定是否可以取消 Event 对象。默认值为 `false`。

	`path:File` (default = `null`) — 存储卷的名称。

	`volume:StorageVolume` (default = `null`) — 表示存储卷的 File 对象。

方法详细信息

clone

()

方法

override public function clone():Event

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

复制 Event 子类的实例。

返回一个新的 Event 对象，它是 Event 对象的原始实例的副本。通常您不需要调用 clone()；当您重新调度事件，即调用 dispatchEvent(event)（从正在处理 event 的处理函数）时，EventDispatcher 类会自动调用它。

新的 Event 对象包括原始对象的所有属性。

当您创建自己的自定义 Event 类时，必须覆盖继承的 Event.clone() 方法，以复制自定义类的属性。如果您未设置在事件子类中添加的所有属性，则当侦听器处理重新调度的事件时，这些属性将不会有正确的值。

在本示例中，PingEvent 是 Event 的子类，因此它可以实现其自己的 clone() 版本。

     class PingEvent extends Event {
         var URL:String;
         
     public override function clone():Event {
              return new PingEvent(type, bubbles, cancelable, URL);
        }
     }

Event — 一个新的 Event 对象，它与原始对象相同。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

返回一个字符串，其中包含 Event 对象的所有属性。字符串的格式如下：

[Event type=value bubbles=value cancelable=value]

String — 一个字符串，其中包含 Event 对象的所有属性。

常量详细信息

STORAGE_VOLUME_MOUNT

常量

public static const STORAGE_VOLUME_MOUNT:String = "storageVolumeMount"

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

当安装卷时，StorageVolumeChangeEvent.VOLUME_MOUNT 常量定义 StorageVolumeChangeEvent 的 type 属性值。

事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	StorageVolumeChangeEvent 对象。
`file`	表示存储卷的 File 对象。
`name`	存储卷的名称。
`target`	StorageVolumeChangeEvent 对象。
`type`	`"storageVolumeMount"`

相关 API 元素

flash.filesystem.StorageVolumeInfo

STORAGE_VOLUME_UNMOUNT

常量

public static const STORAGE_VOLUME_UNMOUNT:String = "storageVolumeUnmount"

语言版本:

ActionScript 3.0

运行时版本:

AIR 2

当卸载卷时，StorageVolumeChangeEvent.VOLUME_MOUNT 常量定义 StorageVolumeChangeEvent 的 type 属性值。

事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	StorageVolumeChangeEvent 对象。
`file`	表示存储卷的 File 对象。
`name`	存储卷的名称。
`target`	StorageVolumeChangeEvent 对象。
`type`	`"storageVolumeUnmount"`

相关 API 元素

flash.filesystem.StorageVolumeInfo

法律声明 | 在线隐私策略

StorageVolumeChangeEvent - AS3

包x

语言元素

附录

包 flash.events

rootDirectory

storageVolume