DeviceRotationEvent

套件	flash.events
類別	public class DeviceRotationEvent
繼承	DeviceRotationEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

自 (裝置所安裝) 加速計和迴轉儀感應器讀數的合併讀數取得 DeviceRotation 更新時，DeviceRotation 類別會傳送 DeviceRotationEvent 並傳回滾動、偏轉、俯仰和四元數資料。

相關 API 元素

flash.sensors.DeviceRotation

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		pitch : Number 沿著 X 軸的俯仰 (以度為測量單位)。	DeviceRotationEvent
		quaternion : Array 裝置旋轉的四元數資料 (採用 [w, x, y, z] 格式)。	DeviceRotationEvent
		roll : Number 沿著 Y 軸的滾動 (以度為測量單位)。	DeviceRotationEvent
		target : Object [唯讀] 事件目標。	Event
		timestamp : Number 從執行階段初始化之後，事件時間的毫秒數。	DeviceRotationEvent
		type : String [唯讀] 事件類型。	Event
		yaw : Number 沿著 Z 軸的偏轉 (以度為測量單位)。	DeviceRotationEvent

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		DeviceRotationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, timestamp:Number = 0, roll:Number = 0, pitch:Number = 0, yaw:Number = 0, quaternion:Array = null) 建立 DeviceRotationEvent 物件，其中包含有關沿著三維軸滾動、偏轉、俯仰的資訊。	DeviceRotationEvent
		clone():Event [覆寫] 建立 DeviceRotationEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。	DeviceRotationEvent
		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 [覆寫] 傳回包含 DeviceRotationEvent 物件所有屬性的字串。	DeviceRotationEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		UPDATE : String = "update" [靜態] 定義 DeviceRotationEvent 事件物件的 type 屬性值。	DeviceRotationEvent

屬性詳細資訊

pitch

屬性

pitch:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

沿著 X 軸的俯仰 (以度為測量單位)。

實作
public function get pitch():Number
public function set pitch(value:Number):void

quaternion

屬性

quaternion:Array

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

裝置旋轉的四元數資料 (採用 [w, x, y, z] 格式)。

實作
public function get quaternion():Array
public function set quaternion(value:Array):void

roll

屬性

roll:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

沿著 Y 軸的滾動 (以度為測量單位)。

實作
public function get roll():Number
public function set roll(value:Number):void

timestamp

屬性

timestamp:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

從執行階段初始化之後，事件時間的毫秒數。例如，如果在應用程式初始化後，裝置擷取 DeviceRotation 資料 4 秒，則事件的 timestamp 屬性會設定為 4000。

實作
public function get timestamp():Number
public function set timestamp(value:Number):void

yaw

屬性

yaw:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

沿著 Z 軸的偏轉 (以度為測量單位)。

實作
public function get yaw():Number
public function set yaw(value:Number):void

建構函式詳細資料

()

建構函式

public function DeviceRotationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, timestamp:Number = 0, roll:Number = 0, pitch:Number = 0, yaw:Number = 0, quaternion:Array = null)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

建立 DeviceRotationEvent 物件，其中包含有關沿著三維軸滾動、偏轉、俯仰的資訊。Event 物件會當做參數傳遞至事件偵聽程式。

參數

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

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

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

	`timestamp:Number` (default = `0`) — DeviceRotation 更新的時間戳記。

	`roll:Number` (default = `0`) — 沿著 Y 軸的滾動值 (以度為單位)。

	`pitch:Number` (default = `0`) — 沿著 X 軸的俯仰值 (以度為單位)。

	`yaw:Number` (default = `0`) — 沿著 Z 軸的偏轉值 (以度為單位)。

	`quaternion:Array` (default = `null`) — 裝置旋轉的四元數 (採用 [w, x, y, z] 格式)。

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

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

傳回值

Event — 新的 DeviceRotationEvent 物件，其屬性值符合原始物件的屬性值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

傳回包含 DeviceRotationEvent 物件所有屬性的字串。將使用下列格式：

[DeviceRotationEvent type=value bubbles=value cancelable=value timestamp=value roll=value pitch=value yaw=value quaternion=value ]

傳回值

String — 包含 DeviceRotationEvent 物件所有屬性的字串。

常數詳細資訊

UPDATE

常數

public static const UPDATE:String = "update"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

定義 DeviceRotationEvent 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`timestamp`	DeviceRotation 更新的時間戳記。
`roll`	滾動值 (以度為單位)。
`pitch`	俯仰值 (以度為單位)。
`yaw`	偏轉值 (以度為單位)。
`quaternion`	四元數資料 (採用 [w, x, y, z] 格式)。

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

DeviceRotationEvent - AS3

類別 x

pitch

quaternion

roll

timestamp

yaw