Keyboard Sınıf

Tanım

Ad Alanı:

System.Windows.Input

Bütünleştirilmiş Kod:

PresentationCore.dll

Klavye cihazını temsil eder.

public ref class Keyboard abstract sealed

public static class Keyboard

type Keyboard = class

Public Class Keyboard

Devralma

Object

Keyboard

Örnekler

Aşağıdaki örnekte, anahtarın IsKeyToggled iki durumlu durumda olup olmadığını belirlemek için yönteminin nasıl kullanılacağı gösterilmektedir. Geçiş IsKeyToggled yapılırken Key geçiş yapılırsa, düğmenin arka planı değiştirilir.

// Uses the Keyboard.IsToggled to determine if a key is toggled.
if (Keyboard.IsKeyToggled(Key.Return))
{
    btnIsToggle.Background = Brushes.Red;
}
else
{
    btnIsToggle.Background = Brushes.AliceBlue;
}

' Uses the Keyboard.IsToggled to determine if a key is toggled.
If Keyboard.IsKeyToggled(Key.Return) Then
    btnIsToggle.Background = Brushes.Red
Else
    btnIsToggle.Background = Brushes.AliceBlue
End If

Açıklamalar

sınıfı Keyboard , klavyenin durumuyla ilgili bilgi sağlayan klavyeyle ilgili olaylar, yöntemler ve özellikler sağlar.

Ekli olay olarak tanımlayan Keyboard olayların her biri de temel öğe sınıfları UIElement tarafından ve ContentElement yeni bir yönlendirilmiş olay olarak yeniden kullanıma sunulur. Genel olarak, ve üzerindeki UIElementContentElementbir uygulama için klavye olaylarını kullanmak Keyboard yerine işlemek daha uygundur. Ayrıntılar için bkz. Girişe Genel Bakış.

Bir öğenin klavye girişi alabilmesi için öğenin odaklanabilir olması gerekir. Türetilmiş nesnelerin çoğu UIElement varsayılan olarak odaklanabilir. Aksi takdirde, bir öğeyi odaklanabilir hale getirmek için, temel öğedeki özelliğini olarak trueayarlayınFocusable. Temel öğeler hakkında daha fazla bilgi için bkz. Temel Öğelere Genel Bakış.

Panel ve gibi StackPanelCanvassınıflar için varsayılan değerini Focusable olarak falseayarlayın. Bu nedenle, bu nesnelerin klavye odağını elde etmesi için olarak Focusabletrueayarlanması gerekir.

Klavye odağı, klavye girişi alan nesneye başvurur. Klavye odağı olan öğe olarak trueayarlanmıştırIsKeyboardFocused. Klavye odağı masaüstünün tamamında olan tek bir öğe olabilir. Mantıksal odak, odağı olan bir odak kapsamındaki nesneyi ifade eder. Odak, klavye odağı ve mantıksal odak hakkında daha fazla bilgi için bkz. Girişe Genel Bakış ve Odaklanmaya Genel Bakış.

Sınıfın Keyboard statik üyeleri, çağıran iş parçacığının birincil KeyboardDevice temsilcisidir, bu nedenle iş parçacığı güvenli olmaları gerekmez.

Alanlar

Name	Description
GotKeyboardFocusEvent	Ekli GotKeyboardFocus olayı tanımlar.
KeyboardInputProviderAcquireFocusEvent	Ekli KeyboardInputProviderAcquireFocus olayı tanımlar.
KeyDownEvent	Ekli KeyDown olayı tanımlar.
KeyUpEvent	Ekli KeyUp olayı tanımlar.
LostKeyboardFocusEvent	Ekli LostKeyboardFocus olayı tanımlar.
PreviewGotKeyboardFocusEvent	Ekli PreviewGotKeyboardFocus olayı tanımlar.
PreviewKeyboardInputProviderAcquireFocusEvent	Ekli PreviewKeyboardInputProviderAcquireFocus olayı tanımlar.
PreviewKeyDownEvent	Ekli PreviewKeyDown olayı tanımlar.
PreviewKeyUpEvent	Ekli PreviewKeyUp olayı tanımlar.
PreviewLostKeyboardFocusEvent	Ekli PreviewLostKeyboardFocus olayı tanımlar.

Özellikler

Name	Description
DefaultRestoreFocusMode	Odağı geri yüklerken Windows Presentation Foundation'ın (WPF) davranışını alır veya ayarlar.
FocusedElement	Klavye odağı olan öğeyi alır.
Modifiers	Şu anda basılan kümesini ModifierKeys alır.
PrimaryDevice	Birincil klavye giriş cihazını alır.

Yöntemler

Name	Description
AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için GotKeyboardFocus bir işleyici ekler.
AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Ekli olay için KeyboardInputProviderAcquireFocus bir işleyici ekler.
AddKeyDownHandler(DependencyObject, KeyEventHandler)	Ekli olay için KeyDown bir işleyici ekler.
AddKeyUpHandler(DependencyObject, KeyEventHandler)	Ekli olay için KeyUp bir işleyici ekler.
AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için LostKeyboardFocus bir işleyici ekler.
AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için PreviewGotKeyboardFocus bir işleyici ekler.
AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Ekli olay için PreviewKeyboardInputProviderAcquireFocus bir işleyici ekler.
AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Ekli olay için PreviewKeyDown bir işleyici ekler.
AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Ekli olay için PreviewKeyUp bir işleyici ekler.
AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için PreviewLostKeyboardFocus bir işleyici ekler.
ClearFocus()	Odağı temizler.
Focus(IInputElement)	Klavye odağını belirtilen öğeye ayarlar.
GetKeyStates(Key)	Belirtilen anahtar için anahtar durumları kümesini alır.
IsKeyDown(Key)	Belirtilen tuşa basılıp basılmayacağını belirler.
IsKeyToggled(Key)	Belirtilen anahtarın iki durumlu olup olmadığını belirler.
IsKeyUp(Key)	Belirtilen anahtarın serbest bırakılıp bırakılmayacağını belirler.
RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için bir işleyici kaldırır GotKeyboardFocus .
RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Ekli olay için bir işleyici kaldırır KeyboardInputProviderAcquireFocus .
RemoveKeyDownHandler(DependencyObject, KeyEventHandler)	Ekli olay için bir işleyici kaldırır KeyDown .
RemoveKeyUpHandler(DependencyObject, KeyEventHandler)	Ekli olay için bir işleyici kaldırır KeyUp .
RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için bir işleyici kaldırır LostKeyboardFocus .
RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için bir işleyici kaldırır PreviewGotKeyboardFocus .
RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Ekli olay için bir işleyici kaldırır PreviewKeyboardInputProviderAcquireFocus .
RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Ekli olay için bir işleyici kaldırır PreviewKeyDown .
RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Ekli olay için bir işleyici kaldırır PreviewKeyUp .
RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Ekli olay için bir işleyici kaldırır PreviewLostKeyboardFocus .

İliştirilmiş Olaylar

Name	Description
GotKeyboardFocus	Bir öğe klavye odağı aldığında gerçekleşir.
KeyboardInputProviderAcquireFocus	Klavye giriş sağlayıcısı odağı aldığı zaman gerçekleşir.
KeyDown	Klavyedeki bir tuşa basıldığında gerçekleşir.
KeyUp	Klavyedeki bir tuş serbest bırakıldığında gerçekleşir.
LostKeyboardFocus	Bir öğe klavye odağını kaybettiğinde gerçekleşir.
PreviewGotKeyboardFocus	Bir öğe klavye odağı alma sürecinde olduğunda gerçekleşir.
PreviewKeyboardInputProviderAcquireFocus	Klavye giriş sağlayıcısı odak alma sürecinde olduğunda gerçekleşir.
PreviewKeyDown	Klavyedeki bir tuşa basıldığında gerçekleşir.
PreviewKeyUp	Klavyedeki bir tuş serbest bırakıldığında gerçekleşir.
PreviewLostKeyboardFocus	Bir öğe klavye odağını kaybetme sürecinde olduğunda gerçekleşir.

Ayrıca bkz.

• KeyboardEventArgs
• KeyEventArgs