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()，因為 EventDispatcher 類別會在您重新傳送事件時自動呼叫它 (也就是說，當您從正在處理 event 的處理常式呼叫dispatchEvent(event) 的時候)。

新的 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