GameInputControl - Bron voor Adobe ActionScript® 3 (AS3 ) API

Pakket	flash.ui
Klasse	public dynamic class GameInputControl
Overerving	GameInputControl EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

De GameInputControl-klasse vertegenwoordigt een besturingselement op een invoerapparaat. De GameInput-API wijst de fysieke besturingselementen op een apparaat toe aan eenvoudige logische besturingselementen.

Besturingselementwaarden ophalen:

De value-eigenschap retourneert de huidige waarde van een besturingselement. Deze methode retourneert de laatste waarde niet rechtstreeks van het besturingselement. In plaats daarvan wordt de waarde geretourneerd die in de cache is geplaatst toen het besturingselement voor de laatste keer is gesampled.

Er zijn drie manieren om besturingselementwaarden op te halen van een afzonderlijk besturingselement:

Poll: roep value aan als u de laatst gekende waarde van een besturingselement wilt ophalen.
Wijzigingsgebeurtenissen: een wijzigingsgebeurtenis voor een controller registreren. De Event.CHANGE-gebeurtenis wordt verzonden telkens wanneer de waarde van een besturingselement wijzigt. Als u de gebeurtenis hebt ontvangen, roept u value aan om de waarde op te halen van het besturingselement dat de gebeurtenis heeft gegenereerd.
Samplewaarden in de cache plaatsen: het in de cache plaatsen wordt uitgevoerd op apparaatniveau. Raadpleeg de documentatie voor de GameInputDevice-klasse voor details over het in cache plaatsen en het ophalen van gesamplede besturingselementwaarden.

Als u probeert besturingselementwaarden te lezen vanaf een uitgeschakeld apparaat, geeft value een IOError weer. U kunt toegang krijgen tot eigenschappen die een besturingselement beschrijven (id, minValue en maxValue) ook als het apparaat niet is ingeschakeld. Met deze functie kunt u bepalen of een apparaat voldoet aan de vereisten van uw toepassing zonder dat u het apparaat eerst moet inschakelen.

Raadpleeg voor meer informatie het Adobe AIR Developer Center-artikel:Spelbesturingen op Adobe AIR.

Voor Android biedt deze functie ondersteuning voor Android OS-versies vanaf 4.1 en wordt SWF-versie 20 of hoger en een naamruimteversie van 3.7 of hoger vereist. Voor iOS biedt deze functie ondersteuning voor iOS-versies vanaf 9.0 en wordt SWF-versie 34 of hoger en een naamruimteversie van 23.0 of hoger vereist.

Verwante API-elementen

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

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		device : GameInputDevice [alleen-lezen] Retourneert het GameInputDevice-object dat dit besturingselement bevat.	GameInputControl
		id : String [alleen-lezen] Retourneert de id van dit besturingselement.	GameInputControl
		maxValue : Number [alleen-lezen] Retourneert de maximumwaarde voor dit besturingselement.	GameInputControl
		minValue : Number [alleen-lezen] Retourneert de minimumwaarde voor dit besturingselement.	GameInputControl
		value : Number [alleen-lezen] Retourneert de waarde voor dit besturingselement.	GameInputControl

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
change	Wordt verzonden wanneer een besturingselementwaarde wijzigt.	GameInputControl
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher

Eigenschapdetails

device

eigenschap

device:GameInputDevice [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

Retourneert het GameInputDevice-object dat dit besturingselement bevat.

Implementatie
public function get device():GameInputDevice

id

eigenschap

id:String [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

Retourneert de id van dit besturingselement.

Implementatie
public function get id():String

maxValue

eigenschap

maxValue:Number [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

Retourneert de maximumwaarde voor dit besturingselement.

Implementatie
public function get maxValue():Number

minValue

eigenschap

minValue:Number [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

Retourneert de minimumwaarde voor dit besturingselement.

Implementatie
public function get minValue():Number

value

eigenschap

value:Number [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.7

Retourneert de waarde voor dit besturingselement.

Implementatie
public function get value():Number

Gegenereerde uitzondering

IOError — Als value wordt aangeroepen terwijl het apparaat is uitgeschakeld.

Gebeurtenisdetails

change

Gebeurtenis

Type gebeurtenisobject: flash.events.Event

Wordt verzonden wanneer een besturingselementwaarde wijzigt.

Juridische kennisgeving | Online privacybeleid

GameInputControl - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.ui

device

id

maxValue

minValue

value

change