GameInputControl - Adobe ActionScript® 3 (AS3 ) API 参考

包	flash.ui
类	public dynamic class GameInputControl
继承	GameInputControl EventDispatcher Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

GameInputControl 类表示输入设备上的一个控件。GameInput API 将设备上的物理控件映射为简单的逻辑控件。

获取控件值：

value 属性会返回控件的当前值。此方法不会直接从控件返回最新的值。而是会返回上次取样控件时缓存的值。

有三种方法可从单个控件获取控件值：

轮询：每当想要获取控件的上一个已知值时调用 value。
更改事件：为控制器注册一个更改事件。每当控件的值更改时调度 Event.CHANGE 事件。接收到事件后，调用 value 以获取触发该事件的控件的值。
缓存样本值：缓存在设备级别上完成。有关缓存和检索取样控件值的详细信息，请参阅 GameInputDevice 类文档。

试图从已禁用设备读取控件值会导致 value 引发 IOError。不过，即使未启用设备，您也可以访问用来描述控件的属性（id、minValue 及 maxValue）。使用此功能可确定某个设备是否符合您的应用程序的需要，而无需先启用该设备。

有关更多信息，请参阅 Adobe AIR 开发人员中心文章：Adobe AIR 中的游戏控制器。

对于 Android，此功能支持的 Android OS 最低版本为 4.1，需要的 SWF 最低版本为 20，命名空间最低版本为 3.7。对于 iOS，此功能支持的 iOS 最低版本为 9.0，需要的 SWF 最低版本为 34，命名空间最低版本为 23.0。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		device : GameInputDevice [只读] 返回包含此控件的 GameInputDevice 对象。	GameInputControl
		id : String [只读] 返回此控件的 ID。	GameInputControl
		maxValue : Number [只读] 返回此控件的最大值。	GameInputControl
		minValue : Number [只读] 返回此控件的最小值。	GameInputControl
		value : Number [只读] 返回此控件的值。	GameInputControl

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
change	当控件值发生更改时调度。	GameInputControl
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

device

属性

device:GameInputDevice [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

返回包含此控件的 GameInputDevice 对象。

实现
public function get device():GameInputDevice

id

属性

id:String [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

返回此控件的 ID。

实现
public function get id():String

maxValue

属性

maxValue:Number [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

返回此控件的最大值。

实现
public function get maxValue():Number

minValue

属性

minValue:Number [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

返回此控件的最小值。

实现
public function get minValue():Number

value

属性

value:Number [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 3.7

返回此控件的值。

实现
public function get value():Number

引发

IOError — 禁用设备时如果调用 value。

事件详细信息

change

事件

事件对象类型: flash.events.Event

当控件值发生更改时调度。

法律声明 | 在线隐私策略

GameInputControl - AS3

类 x

device

id

maxValue

minValue

value

change