ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.ui 

GameInputControl  - AS3

Paketflash.ui
Klassepublic dynamic class GameInputControl
VererbungGameInputControl Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Die GameInputControl-Klasse repräsentiert eine Steuerung eines Eingabegeräts. Die GameInput-API ordnet die physischen Steuerungen eines Geräts einem einfachen logischen Steuerelement zu.

Abrufen von Steuerungswerten:

Die value-Eigenschaft gibt den aktuellen Wert eines Steuerelements zurück. Diese Methode gibt nicht den neuesten Wert direkt von der Steuerung zurück Stattdessen gibt sie den Wert zurück, der beim letzten Sampling der Steuerung im Cache gespeichert wurde.

Es gibt drei Möglichkeiten, Steuerungswerte von einer einzelnen Steuerung abzurufen:

  1. Polling: Rufen Sie value auf, wenn Sie den letzten bekannten Wert für eine Steuerung abrufen möchten.
  2. Änderungsereignisse: Registrieren Sie ein Änderungsereignis für einen Controller. Das Event.CHANGE-Ereignis wird abgesetzt, wenn sich der Wert einer Steuerung ändert. Beim Erhalt des Ereignisses rufen Sie value auf, um den Wert für das Steuerelement, das das Ereignis abgesetzt hat, abzurufen.
  3. Zwischenspeichern von Samplewerten: Das Speichern im Cache erfolgt auf Geräteebene. Ausführliche Informationen zum Zwischenspeichern und Abrufen von gesampelten Steuerungswerten finden Sie in der Beschreibung der GameInputDevice-Klasse.

Wenn Sie versuchen, Steuerungswerte von einem deaktivierten Gerät zu lesen, gibt value einen IOError aus. Sie können jedoch auf Eigenschaften zugreifen, die ein Steuerelement beschreiben(id, minValue und maxValue), auch wenn das Gerät nicht aktiviert ist. Mit dieser Funktion können Sie feststellen, ob ein Gerät die Anforderungen Ihrer Anwendung erfüllt, ohne dass Sie das Gerät zuerst aktivieren müssen.

Weitere Informationen finden Sie im Artikel zum Adobe Air Developer Center: Game controllers on Adobe AIR (Spielecontroller unter Adobe AIR).

Bei Android unterstützt diese Funktion Android OS-Versionen ab 4.1 und benötigt mindestens die SWF-Version 20 und Namespace 3.7. Bei iOS ist mindestens die iOS-Version 9.0, die SWF-Version 34 und Namespace 23.0 erforderlich.

Verwandte API-Elemente

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

Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      device : GameInputDevice
[schreibgeschützt] Gibt das GameInputDevice-Objekt zurück, das diese Steuerung enthält.
GameInputControl
      id : String
[schreibgeschützt] Gibt die ID dieses Steuerelements zurück.
GameInputControl
      maxValue : Number
[schreibgeschützt] Gibt den Maximalwert für dieses Steuerelement zurück.
GameInputControl
      minValue : Number
[schreibgeschützt] Gibt den Mindestwert für dieses Steuerelement zurück.
GameInputControl
      value : Number
[schreibgeschützt] Gibt den Wert für dieses Steuerelement zurück.
GameInputControl
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
toLocaleString():String
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
toString():String
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
willTrigger(type:String):Boolean
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.
 Ereignis Übersicht Definiert von
 Inherited
activate
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
  
change
Wird abgesetzt, wenn sich ein Steuerungswert ändert.GameInputControl
 Inherited
deactivate
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails
    

device

Eigenschaft
device:GameInputDevice  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Gibt das GameInputDevice-Objekt zurück, das diese Steuerung enthält.



Implementierung
    public function get device():GameInputDevice
    

id

Eigenschaft 
id:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Gibt die ID dieses Steuerelements zurück.



Implementierung
    public function get id():String
    

maxValue

Eigenschaft 
maxValue:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Gibt den Maximalwert für dieses Steuerelement zurück.



Implementierung
    public function get maxValue():Number
    

minValue

Eigenschaft 
minValue:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Gibt den Mindestwert für dieses Steuerelement zurück.



Implementierung
    public function get minValue():Number
    

value

Eigenschaft 
value:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.7

Gibt den Wert für dieses Steuerelement zurück.



Implementierung
    public function get value():Number

Auslöser
IOError — Wenn value aufgerufen wird, während das Gerät deaktiviert ist.
Ereignisdetails

change

 Ereignis
Ereignisobjekttyp: flash.events.Event

Wird abgesetzt, wenn sich ein Steuerungswert ändert.




© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.