Paket | flash.events |
Sınıf | public class KeyboardEvent |
Miras Alma | KeyboardEvent Event Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN
ve KeyboardEvent.KEY_UP
Tuşlar ile belirli karakterler arasındaki eşlemeler aygıta ve işletim sistemine göre değişiklik göstereceğinden, karakter girdisini işleme için TextEvent olayını kullanın.
Key olaylarını global olarak dinlemek için, yakalama ve hedef veya köpürme aşaması için Sahne Alanı'nda dinleme işlemi yapın.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
altKey : Boolean
Windows'da Alt tuşunun etkin olup (true) olmadığını (false); Mac OS'de Option tuşunun etkin olup olmadığını belirtir. | KeyboardEvent | ||
bubbles : Boolean [salt okunur]
Bir olayın köpüren bir olay olup olmadığını belirtir. | Event | ||
cancelable : Boolean [salt okunur]
Olayla ilişkilendirilmiş davranışın önlenebilir olup olmadığını gösterir. | Event | ||
charCode : uint
Basılan veya bırakılan tuşun karakter kod değerini içerir. | KeyboardEvent | ||
commandKey : Boolean
Command tuşunun etkin mi (true) yoksa devre dışı mı (false) olduğunu belirtir. | KeyboardEvent | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
controlKey : Boolean
Ctrl tuşunun etkin mi (true) yoksa devre dışı mı (false) olduğunu belirtir. | KeyboardEvent | ||
ctrlKey : Boolean
Windows ve Linux'ta Ctrl tuşunun etkin olup (true) olmadığını (false); Mac OS'de Ctrl tuşu veya Control tuşunun etkin olup olmadığını belirtir. | KeyboardEvent | ||
currentTarget : Object [salt okunur]
Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. | Event | ||
eventPhase : uint [salt okunur]
Olay akışındaki geçerli aşama. | Event | ||
keyCode : uint
Basılan veya bırakılan tuşun tuş kod değeri. | KeyboardEvent | ||
keyLocation : uint
Tuşun klavyedeki konumunu belirtir. | KeyboardEvent | ||
shiftKey : Boolean
Shift tuşu değiştiricisinin etkin mi (true) devre dışı mı (false) olduğunu gösterir. | KeyboardEvent | ||
target : Object [salt okunur]
Olay hedefi. | Event | ||
type : String [salt okunur]
Olay türü. | Event |
Yöntem | Tanımlayan: | ||
---|---|---|---|
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)
keyboard olayları hakkındaki belirli bilgileri içeren bir Event nesnesi oluşturur. | KeyboardEvent | ||
[geçersiz kıl]
KeyboardEvent nesnesinin bir kopyasını oluşturur ve her özelliğin değerini, orijinal ile aynı olacak şekilde ayarlar. | KeyboardEvent | ||
Özel ActionScript 3.0 Event sınıfınızdaki toString() yöntemini uygulamak için bir yardımcı işlev. | Event | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Olayda preventDefault() öğesinin çağrılmış olup olmadığını kontrol eder. | Event | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Bir olayın varsayılan davranışını, bu yapılabiliyorsa iptal eder. | Event | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Olay akışında geçerli düğümdeki ve ondan sonra gelen düğümlerdeki olay dinleyicilerin işlenmesini engeller. | Event | ||
Olay akışında geçerli düğümden sonra gelen düğümlerdeki olay dinleyicilerin işlenmesini engeller. | Event | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
[geçersiz kıl]
KeyboardEvent nesnesinin tüm özelliklerini içeren bir dize döndürür. | KeyboardEvent | ||
Görüntü listesi değiştirildiyse, bu olayın işlenmesi tamamlandıktan sonra görüntünün oluşturulması gerekip gerekmediğini gösterir.
| KeyboardEvent | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
Sabit | Tanımlayan: | ||
---|---|---|---|
KEY_DOWN : String = "keyDown" [statik]
KeyboardEvent.KEY_DOWN sabiti, keyDown olay nesnesinin type özelliği değerini tanımlar. | KeyboardEvent | ||
KEY_UP : String = "keyUp" [statik]
KeyboardEvent.KEY_UP sabiti, keyUp olay nesnesinin type özelliği değerini tanımlar. | KeyboardEvent |
altKey | özellik |
altKey:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Windows'da Alt tuşunun etkin olup (true
) olmadığını (false
); Mac OS'de Option tuşunun etkin olup olmadığını belirtir.
Uygulama
public function get altKey():Boolean
public function set altKey(value:Boolean):void
charCode | özellik |
charCode:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Basılan veya bırakılan tuşun karakter kod değerini içerir. Karakter kodu değerleri, İngilizce klavye değerleridir. Örneğin, Shift+3 tuşlarına basarsanız charCode
öğesi, Japonca klavyede # şeklinde olur, Shift+2 tuşlarına basarsanız charCode
öğesi şu şekilde olur: Almanca klavyede, tıpkı bir İngilizce klavyede olduğu gibi @ (" değil).
Not: Bir input yöntemi düzenleyici (IME) çalışırken, charCode
doğru karakter kodlarını bildirmez.
Uygulama
public function get charCode():uint
public function set charCode(value:uint):void
commandKey | özellik |
commandKey:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Lite 4 |
Command tuşunun etkin mi (true
) yoksa devre dışı mı (false
) olduğunu belirtir. Yalnızca Mac OS için desteklenir. Mac OS'de commandKey
özelliği ctrlKey
özelliğiyle aynı değere sahiptir.
Uygulama
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | özellik |
controlKey:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Lite 4 |
Control tuşunun etkin mi (true
) yoksa devre dışı mı (false
) olduğunu belirtir. Ctrl tuşu etkinse, bu Windows ve Linux'ta da geçerlidir.
Uygulama
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void
ctrlKey | özellik |
ctrlKey:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Windows ve Linux'ta Ctrl tuşunun etkin olup (true
) olmadığını (false
); Mac OS'de Ctrl tuşu veya Control tuşunun etkin olup olmadığını belirtir.
Uygulama
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
keyCode | özellik |
keyCode:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Basılan veya bırakılan tuşun tuş kod değeri.
Not: Bir input yöntemi düzenleyici (IME) çalışırken, keyCode
doğru karakter kodlarını bildirmez.
Uygulama
public function get keyCode():uint
public function set keyCode(value:uint):void
İlgili API Öğeleri
keyLocation | özellik |
keyLocation:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tuşun klavyedeki konumunu belirtir. Bu, klavyede birden fazla olan tuşların ayırt edilmesi için yararlıdır. Örneğin, bu özelliğin değerine göre sol ve sağ Shift tuşlarını ayırt edebilirsiniz: soldaki için KeyLocation.LEFT
ve sağdaki için KeyLocation.RIGHT
. Buna başka bir örnek olarak standart klavyede basılan sayı tuşlarının birbirinden ayrılması verilebilir (KeyLocation.STANDARD
) ve sayısal tuş takımı (KeyLocation.NUM_PAD
).
Uygulama
public function get keyLocation():uint
public function set keyLocation(value:uint):void
shiftKey | özellik |
KeyboardEvent | () | Yapıcı |
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)
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
keyboard olayları hakkındaki belirli bilgileri içeren bir Event nesnesi oluşturur. Event nesneleri, olay dinleyicilerine parametre olarak iletilir.
Parametrelertype:String — Olayın türü. Olası değerler şunlardır: KeyboardEvent.KEY_DOWN ve KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true ) — Event nesnesinin olay akışının köpürme aşamasında yer alıp almayacağını belirler.
| |
cancelable:Boolean (default = false ) — Event nesnesinin iptal edilip edilemeyeceğini belirler.
| |
charCodeValue:uint (default = 0 ) — Basılan veya bırakılan tuşun karakter kod değeri. Döndürülen karakter kodu değerleri, İngilizce klavye değerleridir. Örneğin, Shift+3 tuşlarına basarsanız, Keyboard.charCode() özelliği, İngilizce klavyede olduğu gibi Japonca veya Almanca klavyede de # öğesini döndürür.
| |
keyCodeValue:uint (default = 0 ) — Basılan veya bırakılan tuşun tuş kod değeri.
| |
keyLocationValue:uint (default = 0 ) — Tuşun klavyedeki konumu.
| |
ctrlKeyValue:Boolean (default = false ) — Windows'ta Ctrl tuşunun etkin olup olmadığını gösterir. Mac'de, Ctrl tuşunun veya Command tuşunun etkin olup olmadığını belirtir.
| |
altKeyValue:Boolean (default = false ) — Shift tuşu değiştiricinin etkinleştirilip etkinleştirilmediğini belirtir (yalnızca Windows).
| |
shiftKeyValue:Boolean (default = false ) — Shift tuşu değiştiricinin etkinleştirilip etkinleştirilmediğini belirtir.
| |
controlKeyValue:Boolean (default = false ) — Mac'te Control tuşunun etkin olup olmadığını ve Windows ile Linux'ta Control ve Ctrl tuşlarının etkin olup olmadığını gösterir.
| |
commandKeyValue:Boolean (default = false ) — Command tuşunun etkin olup olmadığını belirtir (yalnızca Mac'te).
|
İlgili API Öğeleri
clone | () | yöntem |
override public function clone():Event
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent nesnesinin bir kopyasını oluşturur ve her özelliğin değerini, orijinal ile aynı olacak şekilde ayarlar.
DöndürürEvent — Orijinaliyle eşlenen özellik değerlerine sahip yeni bir KeyboardEvent nesnesi.
|
toString | () | yöntem |
override public function toString():String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent nesnesinin tüm özelliklerini içeren bir dize döndürür. Dize şu biçimdedir:
[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value]
String — KeyboardEvent nesnesinin tüm özelliklerini içeren bir dize.
|
updateAfterEvent | () | yöntem |
public function updateAfterEvent():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Görüntü listesi değiştirildiyse, bu olayın işlenmesi tamamlandıktan sonra görüntünün oluşturulması gerekip gerekmediğini gösterir.
KEY_DOWN | Sabit |
public static const KEY_DOWN:String = "keyDown"
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN
sabiti, keyDown
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | AIR'de true , Flash Player'da false ; AIR'de bu olay iptal edildiğinde karakterin bir metin alanına girilmesi engellenir. |
charCode | Basılan veya bırakılan tuşun karakter kod değeri. |
commandKey | Mac'te Command tuşu etkinse true . Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Mac'te Control tuşu etkinse true . Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Ctrl veya Command tuşu etkin olduğunda Mac'te true . Aksi takdirde, false . |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true ; etkin değilse false . |
target | Odaklı InteractiveObject örneği target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın. |
İlgili API Öğeleri
KEY_UP | Sabit |
public static const KEY_UP:String = "keyUp"
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_UP
sabiti, keyUp
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
charCode | Basılan veya bırakılan tuşun karakter kod değerini içerir. |
commandKey | Mac'te Command tuşu etkinse true . Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Mac'te Control tuşu etkinse true . Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows'ta true . Ctrl veya Command tuşu etkin olduğunda Mac'te true . Aksi takdirde, false . |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true ; etkin değilse false . |
target | Odaklı InteractiveObject örneği target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın. |
İlgili API Öğeleri
KeyboardEventExample
sınıfını kullanır. Örnekte şu görevler yerine getirilmektedir:
child
adında yeni bir Sprite örneği oluşturur.- Bu örnek, bir karenin arka plan rengini ve boyutunu ayarlamak için ileride kullanılacak özellikleri bildirir.
- Sprite yöntemlerini kullanarak,
addChild()
yöntemini çağırıp varsayılan koordinatlarda (0,0) Sahne Alanı üzerinde görüntülenen açık mavi bir kare çizer. - Bir mouse olayı ve iki keyboard type olay dinleyicisi ekler.
- Keyboard olaylarını dinleyebilmesi için
child
hareketli grafiğinde odak ayarlamak üzere kareyi tıklattığınızda gönderilenclick
/clickHandler
. - Her tuşa basıldığında gönderilen
keyDown
/keyDownHandler
. Subscriber yöntemi,trace()
ifadesini kullanarak olay hakkındaki bilgileri yazdırır. - Bir tuş serbest bırakıldığında gönderilen
keyUp
/keyUpHandler
.
- Keyboard olaylarını dinleyebilmesi için
Bu örneği test ettiğinizde, keyboard olaylarının çalışması için ilk olarak kareyi tıklatmanız gerekir.
Ayrıca Flash'ta Filmi Test Et komutunu kullanıyorsanız, geliştirme arabirimi, child hareketli grafiğine bağlı olay dinleyicileri yerine belirli tuşlara yanıt verebilir.
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); } } }
Tue Jun 12 2018, 01:09 PM Z