StatusUpdateEvent

套件	air.update.events
類別	public class StatusUpdateEvent
繼承	StatusUpdateEvent UpdateEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

在更新程式成功下載並解譯更新描述器檔案之後，updater 物件便會傳送 StatusUpdateEvent 物件。

預設的行為是在 StatusUpdateEvent 物件的 available 屬性設定為 true 時，開始下載更新。唯有使用 ApplicationUpdater 類別才能制止預設的行為。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		available : Boolean = false 指出是否有更新可使用。	StatusUpdateEvent
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		details : Array 陣列，定義每一種支援語言的 details 字串。	StatusUpdateEvent
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event
		version : String 更新的版本字串。	StatusUpdateEvent
		versionLabel : String 更新的版本標籤字串。	StatusUpdateEvent

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		StatusUpdateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, available:Boolean = false, version:String = "", details:Array = null, versionLabel:String = "") 建構函數。	StatusUpdateEvent
		clone():Event [覆寫] 建立物件的副本，然後設定每個屬性值以符合原始物件的屬性值。	StatusUpdateEvent
		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 [覆寫] 傳回包含物件所有屬性的字串。	StatusUpdateEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		UPDATE_STATUS : String = "updateStatus" [靜態] StatusUpdateEvent.UPDATE_STATUS 常數定義了代表 updateStatus 事件之事件物件的 type 屬性值。	StatusUpdateEvent

屬性詳細資訊

available

屬性

public var available:Boolean = false

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

指出是否有更新可使用。這個屬性為 true 表示更新描述器檔案指定的版本與目前的應用程式版本不同，否則為 false (兩者的版本相同)。

details

屬性

public var details:Array

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

陣列，定義每一種支援語言的 details 字串。如果沒有當地語系化描述，此陣列將定義成第一個元素為空字串 ("")，第二個元素為 details 字串。若有當地語系化描述，則陣列中的每個元素本身都是包含兩個元素的陣列。第一個元素是地區碼，第二個元素是描述文字。例如，此陣列包含了代表兩種語言 (美式英文和法文) 的子陣列：["en-US", "Hello World"], ["fr", "Bonjour monde"]。語言的列示順序與更新描述器中的順序相同。

version

屬性

public var version:String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

更新的版本字串。

在 AIR 2.5 及更新版本中，版本字串會在應用程式描述器檔案的 versionNumber 元素中指定。在先前的 AIR 版本中，版本字串是在 version 元素中指定。

versionLabel

屬性

public var versionLabel:String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2.5

更新的版本標籤字串。

建構函式詳細資料

()

建構函式

public function StatusUpdateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, available:Boolean = false, version:String = "", details:Array = null, versionLabel:String = "")

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

建構函數。請勿呼叫此函數。這是專供更新架構呼叫，用以建立事件物件。

參數

	`type:String` — 事件類型。事件偵聽程式可以透過繼承的 `type` 屬性來存取此資訊。錯誤事件只有一種類型：`ErrorEvent.ERROR`。

	`bubbles:Boolean` (default = `false`) — 判斷 Event 物件是否會反昇。事件偵聽程式可以透過繼承的 `bubbles` 屬性來存取此資訊。

	`cancelable:Boolean` (default = `false`) — 判斷是否可以取消 Event 物件。事件偵聽程式可以透過繼承的 `cancelable` 屬性來存取此資訊。

	`available:Boolean` (default = `false`) — 要顯示為錯誤訊息的文字。事件偵聽程式可以透過 `text` 屬性來存取此資訊。

	`version:String` (default = "") — 要與特定錯誤產生關聯的參考號碼。

	`details:Array` (default = `null`) — 更新的版本字串。

	`versionLabel:String` (default = "") — 包含更新說明的陣列。陣列元素的說明會在本機字碼與當地化版本之間切換。

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

建立物件的副本，然後設定每個屬性值以符合原始物件的屬性值。

傳回值

Event

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

傳回包含物件所有屬性的字串。

傳回值

String

常數詳細資訊

UPDATE_STATUS

常數

public static const UPDATE_STATUS:String = "updateStatus"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.5

StatusUpdateEvent.UPDATE_STATUS 常數定義了代表 updateStatus 事件之事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`available`	設定為 `true` 表示更新描述器檔案指定的版本與目前的應用程式版本不同，否則為 `false` (兩者的版本相同)。
`version`	字串，代表可用的新版本.
`details`	陣列，定義每一種支援語言的 `details` 字串。如果沒有當地語系化描述，此陣列將定義成第一個元素為空字串 (`""`)，第二個元素為 details 字串。若有當地語系化描述，則陣列中的每個元素本身都是包含兩個元素的陣列。第一個元素是地區碼，第二個元素是描述文字。例如，此陣列包含了代表兩種語言 (美式英文和法文) 的子陣列：`["en-US", "Hello World"], ["fr", "Bonjour monde"]`。語言的列示順序與更新描述器中的順序相同。詳細資訊屬性的文字會在更新描述器檔案中指定。
`versionLabel`	(AIR 2.5+) 來自更新應用程式描述器的版本標籤。應該向使用者顯示版本標籤，而非顯示版本。若未指定版本標籤，此屬性將為空白字串。

法律聲明 | 線上隱私權政策

StatusUpdateEvent - AS3

類別 x

available

details

version

versionLabel