Pakket | flash.events |
Klasse | public class KeyboardEvent |
Overerving | KeyboardEvent Event Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN
en KeyboardEvent.KEY_UP
Omdat toewijzingen tussen toetsen en specifieke tekens verschillen per apparaat en besturingssysteem, kunt u het beste het gebeurtenistype TextEvent gebruiken voor het verwerken van tekeninvoer.
Wanneer u wilt luisteren naar toetsgebeurtenissen, luistert u in het werkgebied voor vastleg- en doelfase of terugkoppelfase.
Meer voorbeelden
Handling keyboard events
Understanding the keyCode and charCode properties
Understanding KeyboardEvent precedence
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
altKey : Boolean
Geeft aan of de Alt-toets actief (true) of inactief (false) is in Windows. Geeft aan of de Option-toets actief is in Mac OS. | KeyboardEvent | ||
bubbles : Boolean [alleen-lezen]
Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is. | Event | ||
cancelable : Boolean [alleen-lezen]
Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen. | Event | ||
charCode : uint
Deze bevat de waarde van de tekenreekscode van de laatste toets die is ingedrukt of losgelaten. | KeyboardEvent | ||
commandKey : Boolean
Geeft aan of de Command-toets actief (true) of inactief (false) is. | KeyboardEvent | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
controlKey : Boolean
Geeft aan of de Control-toets actief (true) of inactief (false) is. | KeyboardEvent | ||
ctrlKey : Boolean
In Windows en Linux wordt aangegeven of de Ctrl-toets actief (true) of inactief (false) is. Op Mac OS wordt aangegeven of de Ctrl-toets of de Command-toets actief is. | KeyboardEvent | ||
currentTarget : Object [alleen-lezen]
Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. | Event | ||
eventPhase : uint [alleen-lezen]
De huidige fase in de gebeurtenisstroom. | Event | ||
keyCode : uint
De waarde van de toetscode van de toets die is ingedrukt of losgelaten. | KeyboardEvent | ||
keyLocation : uint
Geeft de locatie van de toets op het toetsenbord aan. | KeyboardEvent | ||
shiftKey : Boolean
Geeft aan of de optie Shift-toets actief (true) of inactief (false) is. | KeyboardEvent | ||
target : Object [alleen-lezen]
Doel van gebeurtenis. | Event | ||
type : String [alleen-lezen]
Het type gebeurtenis. | Event |
Methode | Gedefinieerd door | ||
---|---|---|---|
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false)
Maakt een Event-object dat specifieke informatie bevat over gebeurtenissen Keyboard. | KeyboardEvent | ||
[overschrijven]
Maakt een kopie van het object KeyboardEvent en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel. | KeyboardEvent | ||
Een hulpprogrammafunctie voor de implementatie van de methode toString() in aangepaste ActionScript 3.0-Event-klassen. | Event | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Controleert of de methode preventDefault() is aangeroepen voor de gebeurtenis. | Event | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Annuleert het standaardgedrag van een gebeurtenis wanneer dat gedrag kan worden geannuleerd. | Event | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Voorkomt het verwerken van gebeurtenislisteners in het huidige knooppunt en volgende knooppunten in de gebeurtenisstroom. | Event | ||
Voorkomt het verwerken van gebeurtenislisteners in knooppunten die volgen op het huidige knooppunt in de gebeurtenisstroom. | Event | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
[overschrijven]
Retourneert een tekenreeks die alle eigenschappen van het object KeyboardEvent bevat. | KeyboardEvent | ||
Geeft aan dat de weergave na de voltooiing van deze gebeurtenis moet worden gerenderd als de weergavelijst is gewijzigd.
| KeyboardEvent | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
Constante | Gedefinieerd door | ||
---|---|---|---|
KEY_DOWN : String = "keyDown" [statisch]
De constante KeyboardEvent.KEY_DOWN definieert de waarde van de eigenschap type van een KeyDown-gebeurtenisobject. | KeyboardEvent | ||
KEY_UP : String = "keyUp" [statisch]
De constante KeyboardEvent.KEY_UP definieert de waarde van de eigenschap type van een keyUp-gebeurtenisobject. | KeyboardEvent |
altKey | eigenschap |
altKey:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft aan of de Alt-toets actief (true
) of inactief (false
) is in Windows. Geeft aan of de Option-toets actief is in Mac OS.
Implementatie
public function get altKey():Boolean
public function set altKey(value:Boolean):void
charCode | eigenschap |
charCode:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Deze bevat de waarde van de tekenreekscode van de laatste toets die is ingedrukt of losgelaten. De waarden van de tekencodes zijn de waarden van het Engelse toetsenbord. Als u bijvoorbeeld drukt op Shift+3, is charCode
# op een Japans toetsenbord, als u drukt op Shift+2, is charCode
@ op een Duits toetsenbord (en niet "), precies zoals op een Engels toetsenbord.
Opmerking: wanneer een invoermethode-editor (IME) wordt uitgevoerd, rapporteert charCode
geen nauwkeurige tekencodes.
Implementatie
public function get charCode():uint
public function set charCode(value:uint):void
commandKey | eigenschap |
commandKey:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Lite 4 |
Geeft aan of de Command-toets actief (true
) of inactief (false
) is. Wordt alleen ondersteund door Mac OS. Op Mac OS heeft de eigenschap commandKey
dezelfde waarde als de eigenschap ctrlKey
.
Implementatie
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | eigenschap |
controlKey:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Lite 4 |
Geeft aan of de Ctrl-toets actief (true
) of inactief (false
) is. In Windows en Linux is dit ook waar als de Ctrl-toets actief is.
Implementatie
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void
ctrlKey | eigenschap |
ctrlKey:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
In Windows en Linux wordt aangegeven of de Ctrl-toets actief (true
) of inactief (false
) is. Op Mac OS wordt aangegeven of de Ctrl-toets of de Command-toets actief is.
Implementatie
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
keyCode | eigenschap |
keyCode:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De waarde van de toetscode van de toets die is ingedrukt of losgelaten.
Opmerking: wanneer een invoermethode-editor (IME) wordt uitgevoerd, rapporteert keyCode
geen nauwkeurige toetscodes.
Implementatie
public function get keyCode():uint
public function set keyCode(value:uint):void
Verwante API-elementen
keyLocation | eigenschap |
keyLocation:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft de locatie van de toets op het toetsenbord aan. Dit is nuttig om onderscheid te maken tussen toetsen die meer dan één keer op het toetsenbord voorkomen. U kunt bijvoorbeeld onderscheid maken tussen de linker en rechter Shift-toets aan de hand van de waarde van deze eigenschap: KeyLocation.LEFT
voor links en KeyLocation.RIGHT
voor rechts. Een ander voorbeeld is onderscheid maken tussen cijfertoetsen die op het gewone toetsenbord worden ingedrukt (KeyLocation.STANDARD
) en toetsen op het numerieke toetsenblok (KeyLocation.NUM_PAD
).
Implementatie
public function get keyLocation():uint
public function set keyLocation(value:uint):void
shiftKey | eigenschap |
KeyboardEvent | () | Constructor |
public function KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een Event-object dat specifieke informatie bevat over gebeurtenissen Keyboard. Gebeurtenisobjecten worden als parameters aan gebeurtenislisteners doorgegeven.
Parameterstype:String — Het type gebeurtenis. Mogelijke waarden zijn: KeyboardEvent.KEY_DOWN en KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true ) — Bepaalt of het Event-object deelneemt aan de terugkoppelfase van de gebeurtenisstroom.
| |
cancelable:Boolean (default = false ) — Bepaalt of het Event-object kan worden geannuleerd.
| |
charCodeValue:uint (default = 0 ) — De waarde van de tekencode van de toets die is ingedrukt of losgelaten. De waarden van de tekencodes die worden geretourneerd, zijn de waarden van het Engelse toetsenbord. Als u bijvoorbeeld drukt op Shift+3, wordt # geretourneerd op een Japans of Duits toetsenbord door de eigenschap Keyboard.charCode() , net als op een Engels toetsenbord.
| |
keyCodeValue:uint (default = 0 ) — De waarde van de toetscode van de toets die is ingedrukt of losgelaten.
| |
keyLocationValue:uint (default = 0 ) — De locatie van de toets op het toetsenbord.
| |
ctrlKeyValue:Boolean (default = false ) — In Windows wordt aangegeven of de Ctrl-toets is geactiveerd. Op de Macintosh wordt aangegeven of de Ctrl- of Command-toets is geactiveerd.
| |
altKeyValue:Boolean (default = false ) — Geeft aan of de optie Alt-toets is geactiveerd (alleen Windows).
| |
shiftKeyValue:Boolean (default = false ) — Geeft aan of de optie Shift-toets is geactiveerd.
| |
controlKeyValue:Boolean (default = false ) — Hiermee wordt aangegeven of de Control-toets actief is op de Mac en of de Control- of Ctrl-toets actief is voor Windows of Linux.
| |
commandKeyValue:Boolean (default = false ) — Geeft aan of de Command-toets is geactiveerd (alleen Macintosh).
|
Verwante API-elementen
clone | () | methode |
override public function clone():Event
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een kopie van het object KeyboardEvent en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.
Geretourneerde waardeEvent — Een nieuw object KeyboardEvent met de eigenschapwaarden die overeenkomen met het origineel.
|
toString | () | methode |
override public function toString():String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert een tekenreeks die alle eigenschappen van het object KeyboardEvent bevat. De tekenreeks heeft de volgende indeling:
[KeyboardEvent type= value bubbles= value cancelable= value ... shiftKey= value ]
String — Een tekenreeks die alle eigenschappen van het object KeyboardEvent bevat.
|
updateAfterEvent | () | methode |
public function updateAfterEvent():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft aan dat de weergave na de voltooiing van deze gebeurtenis moet worden gerenderd als de weergavelijst is gewijzigd.
KEY_DOWN | Constante |
public static const KEY_DOWN:String = "keyDown"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De constante KeyboardEvent.KEY_DOWN
definieert de waarde van de eigenschap type
van een keyDown
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player. Als deze gebeurtenis in AIR wordt geannuleerd, wordt het teken niet ingevoegd in een tekstveld. |
charCode | De waarde van de tekencode van de toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Verwante API-elementen
KEY_UP | Constante |
public static const KEY_UP:String = "keyUp"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De constante KeyboardEvent.KEY_UP
definieert de waarde van de eigenschap type
van een keyUp
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
charCode | Deze bevat de waarde van de tekenreekscode van de laatste toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Verwante API-elementen
KeyboardEventExample
gebruikt om gebeurtenissen Keyboard en hun listenerfuncties te tonen. In het voorbeeld worden de volgende taken uitgevoerd:
- Maakt een nieuwe instantie Sprite met de naam
child
. - Het declareert eigenschappen voor later gebruik door de achtergrondkleur en -grootte van een vierkant in te stellen.
- Met behulp van de methoden van Sprite tekent een lichtblauw vierkant dat het in het werkgebied weergeeft op standaardcoördinaten (0,0) door de methode
addChild()
aan te roepen. - Hiermee worden één muis- en twee toetsenbordgebeurtenislisteners toegevoegd:
click
/clickHandler
, dat wordt verzonden wanneer u op het vierkant klikt om de focus in te stellen op dechild
-sprite zodat deze naar toetsenbordgebeurtenissen kan luisteren.keyDown
/keyDownHandler
, die wordt verzonden wanneer een toets wordt ingedrukt. De abonneemethode drukt informatie over de gebeurtenis af met de instantietrace()
.keyUp
/keyUpHandler
, die wordt verzonden wanneer een toets wordt losgelaten.
Wanneer u dit voorbeeld test, moet u eerst op het vierkant klikken opdat de toetsenbordgebeurtenissen werken.
En als u de opdracht Test Movie in Flash gebruikt, is het bovendien mogelijk dat de ontwerpinterface op bepaalde toetsen reageert in plaats van de gebeurtenislisteners die aan de child-sprite zijn gekoppeld.
package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.*; public class KeyboardEventExample extends Sprite { private var child:Sprite = new Sprite(); private var bgColor:uint = 0x00CCFF; private var size:uint = 80; public function KeyboardEventExample() { child.graphics.beginFill(bgColor); child.graphics.drawRect(0, 0, size, size); child.graphics.endFill(); addChild(child); child.addEventListener(MouseEvent.CLICK, clickHandler); child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler); child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler); } private function clickHandler(event:MouseEvent):void { stage.focus = child; } private function keyDownHandler(event:KeyboardEvent):void { trace("keyDownHandler: " + event.keyCode); trace("ctrlKey: " + event.ctrlKey); trace("keyLocation: " + event.keyLocation); trace("shiftKey: " + event.shiftKey); trace("altKey: " + event.altKey); } private function keyUpHandler(event:KeyboardEvent):void { trace("keyUpHandler: " + event.keyCode); } } }
Wed Jun 13 2018, 11:42 AM Z