GameInputControl - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.ui
Klass	public dynamic class GameInputControl
Arv	GameInputControl EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Klassen GameInputControl representerar en kontroll på en indataenhet. GameInput-API:n matchar de fysiska kontrollerna på en enhet med enkla logiska kontroller.

Hämta kontrollvärden:

Metoden value returnerar kontrollvärdet för en kontroll. Den här metoden returnerar inte direkt det senaste värdet från kontrollen. I stället returneras värdet som cache-lagrades den senaste gången kontrollen samplades.

Det finns tre sätt att hämta kontrollvärden från en enskild kontroll.

Avfrågning: Anropa value när du vill hämta det senast kända värdet för en kontroll.
Ändra händelser: Registrera en ändringshändelse för en kontrollenhet. Händelsen Event.CHANGE skickas när värdet i en kontroll ändras. När händelsen tas emot ska du anropa value för att hämta värdet för kontrollen som utlöste händelsen.
Cache-lagra sampelvärden: Cache-lagring görs på enhetsnivån. Mer information om cache-lagring och hämtning av samplade kontrollvärden finns i dokumentationen för klassen GameInputDevice.

Att försöka läsa kontrollvärden för en inaktiverad enhet medför att value genererar ett IOError-fel. Du kan emellertid få åtkomst till egenskaper som beskriver en kontroll (id, minValue och maxValue) även om enheten inte är aktiverad. Med den här funktionen kan du avgöra om en enhet passar ditt program, utan att du först måste aktivera enheten.

Mer information finns i artikeln på Adobe Air Developer Center: Spelkontroller i Adobe AIR.

I Android krävs minst Android OS-version 4.1, SWF-version 20 och namnrymden 3.7 för funktionen. I iOS krävs minst iOS-version 9.0, SWF-version 34 och namnrymden 23.0 för funktionen.

Relaterade API-element

flash.ui.GameInput
flash.ui.GameInputDevice
flash.events.GameInputEvent

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		device : GameInputDevice [skrivskyddad] Returnerar objektet GameInputDevice som innehåller denna kontroll.	GameInputControl
		id : String [skrivskyddad] Returnerar ID för den här kontrollen.	GameInputControl
		maxValue : Number [skrivskyddad] Returnerar högsta värdet för den här kontrollen.	GameInputControl
		minValue : Number [skrivskyddad] Returnerar minsta värdet för den här kontrollen.	GameInputControl
		value : Number [skrivskyddad] Returnerar värdet för den här kontrollen.	GameInputControl

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
change	Skickas när ett kontrollvärde ändras.	GameInputControl
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher

Egenskapsdetaljer

device

egenskap

device:GameInputDevice [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Returnerar objektet GameInputDevice som innehåller denna kontroll.

Implementering
public function get device():GameInputDevice

id

egenskap

id:String [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Returnerar ID för den här kontrollen.

Implementering
public function get id():String

maxValue

egenskap

maxValue:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Returnerar högsta värdet för den här kontrollen.

Implementering
public function get maxValue():Number

minValue

egenskap

minValue:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Returnerar minsta värdet för den här kontrollen.

Implementering
public function get minValue():Number

value

egenskap

value:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.7

Returnerar värdet för den här kontrollen.

Implementering
public function get value():Number

Utlöser

IOError — När value anropas medan enheten är inaktiverad.

Händelsedetaljer

change

Händelse

Typ av händelseobjekt: flash.events.Event

Skickas när ett kontrollvärde ändras.

Juridiska meddelanden | Onlinesekretesspolicy

GameInputControl - AS3

Klasser x

device

id

maxValue

minValue

value

change