Keyboard Osztály

Definíció

Névtér:: System.Windows.Input

Szerelvény:: PresentationCore.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A billentyűzeteszközt jelöli.

public ref class Keyboard abstract sealed

public static class Keyboard

type Keyboard = class

Public Class Keyboard

Öröklődés: Object
Keyboard

Példák

Az alábbi példa bemutatja, hogyan használható a IsKeyToggled metódus annak megállapítására, hogy egy kulcs váltó állapotban van-e. Ha az Key átadott IsKeyToggled gomb ki van váltógombbal, a gomb háttere megváltozik.

// 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

Megjegyzések

Az Keyboard osztály billentyűzettel kapcsolatos eseményeket, metódusokat és tulajdonságokat biztosít, amelyek információt nyújtanak a billentyűzet állapotáról.

A csatolt eseményként definiált eseményeket Keyboard az alapelemosztályok UIElement is újra közzétenik, és ContentElement új irányított eseményként is. Általában kényelmesebb az alkalmazások UIElement ContentElementbillentyűzetes eseményeinek kezelése az események használata Keyboard helyett. További részletekért lásd a Bemenet áttekintése című témakört.

Ahhoz, hogy egy elem megkapja a billentyűzetbemenetet, az elemnek összpontosíthatónak kell lennie. A legtöbb UIElement származtatott objektum alapértelmezés szerint fókuszba helyezhető. Ellenkező esetben az elem fókuszba helyezéséhez állítsa az Focusable alapelem tulajdonságát a következőre true: . Az alapelemekről további információt az Alapelemek áttekintése című témakörben talál.

Panel osztályokat, például StackPanel és Canvas, állítsa be az alapértelmezett értéket Focusable a következőre false: . Ezért ahhoz, hogy ezek az objektumok megkapják a billentyűzetfókuszt, Focusable be kell állítani a következőre true: .

A billentyűzetfókusz a billentyűzetbemenetet fogadó objektumra vonatkozik. A billentyűzetfókuszú elem a következőre IsKeyboardFocusedvan true állítva: . Csak egy elem lehet, amelynek billentyűzetfókusza a teljes asztalon van. A logikai fókusz a fókuszt tartalmazó hatókörben lévő objektumra vonatkozik. A fókuszról, a billentyűzetfókuszról és a logikai fókuszról további információt a Bemenet áttekintése és a Fókusz áttekintése című témakörben talál.

Az osztály statikus tagjai a Keyboard hívó szál elsődleges KeyboardDevice tagjára delegáltak, így nem feltétlenül szálbiztosak.

Mezők

Name	Description
GotKeyboardFocusEvent	Azonosítja a GotKeyboardFocus csatolt eseményt.
KeyboardInputProviderAcquireFocusEvent	Azonosítja a KeyboardInputProviderAcquireFocus csatolt eseményt.
KeyDownEvent	Azonosítja a KeyDown csatolt eseményt.
KeyUpEvent	Azonosítja a KeyUp csatolt eseményt.
LostKeyboardFocusEvent	Azonosítja a LostKeyboardFocus csatolt eseményt.
PreviewGotKeyboardFocusEvent	Azonosítja a PreviewGotKeyboardFocus csatolt eseményt.
PreviewKeyboardInputProviderAcquireFocusEvent	Azonosítja a PreviewKeyboardInputProviderAcquireFocus csatolt eseményt.
PreviewKeyDownEvent	Azonosítja a PreviewKeyDown csatolt eseményt.
PreviewKeyUpEvent	Azonosítja a PreviewKeyUp csatolt eseményt.
PreviewLostKeyboardFocusEvent	Azonosítja a PreviewLostKeyboardFocus csatolt eseményt.

Tulajdonságok

Name	Description
DefaultRestoreFocusMode	Lekéri vagy beállítja a Windows megjelenítési alaprendszer (WPF) viselkedését a fókusz visszaállításakor.
FocusedElement	Lekéri a billentyűzetfókuszú elemet.
Modifiers	Lekéri a jelenleg lenyomott készletet ModifierKeys .
PrimaryDevice	Lekéri az elsődleges billentyűzetbemeneti eszközt.

Metódusok

Name	Description
AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Hozzáad egy kezelőt a GotKeyboardFocus csatolt eseményhez.
AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Hozzáad egy kezelőt a KeyboardInputProviderAcquireFocus csatolt eseményhez.
AddKeyDownHandler(DependencyObject, KeyEventHandler)	Hozzáad egy kezelőt a KeyDown csatolt eseményhez.
AddKeyUpHandler(DependencyObject, KeyEventHandler)	Hozzáad egy kezelőt a KeyUp csatolt eseményhez.
AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Hozzáad egy kezelőt a LostKeyboardFocus csatolt eseményhez.
AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Hozzáad egy kezelőt a PreviewGotKeyboardFocus csatolt eseményhez.
AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Hozzáad egy kezelőt a PreviewKeyboardInputProviderAcquireFocus csatolt eseményhez.
AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Hozzáad egy kezelőt a PreviewKeyDown csatolt eseményhez.
AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Hozzáad egy kezelőt a PreviewKeyUp csatolt eseményhez.
AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Hozzáad egy kezelőt a PreviewLostKeyboardFocus csatolt eseményhez.
ClearFocus()	Törli a fókuszt.
Focus(IInputElement)	Beállítja a billentyűzet fókuszát a megadott elemre.
GetKeyStates(Key)	Lekéri a megadott kulcs kulcsállapotait.
IsKeyDown(Key)	Meghatározza, hogy a megadott kulcs be van-e nyomva.
IsKeyToggled(Key)	Meghatározza, hogy a megadott kulcs ki van-e váltógombbal.
IsKeyUp(Key)	Meghatározza, hogy a megadott kulcs ki van-e adva.
RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Eltávolít egy kezelőt a GotKeyboardFocus csatolt eseményhez.
RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Eltávolít egy kezelőt a KeyboardInputProviderAcquireFocus csatolt eseményhez.
RemoveKeyDownHandler(DependencyObject, KeyEventHandler)	Eltávolít egy kezelőt a KeyDown csatolt eseményhez.
RemoveKeyUpHandler(DependencyObject, KeyEventHandler)	Eltávolít egy kezelőt a KeyUp csatolt eseményhez.
RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Eltávolít egy kezelőt a LostKeyboardFocus csatolt eseményhez.
RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Eltávolít egy kezelőt a PreviewGotKeyboardFocus csatolt eseményhez.
RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Eltávolít egy kezelőt a PreviewKeyboardInputProviderAcquireFocus csatolt eseményhez.
RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Eltávolít egy kezelőt a PreviewKeyDown csatolt eseményhez.
RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Eltávolít egy kezelőt a PreviewKeyUp csatolt eseményhez.
RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Eltávolít egy kezelőt a PreviewLostKeyboardFocus csatolt eseményhez.

Hozzácsatolt események

Name	Description
GotKeyboardFocus	Akkor fordul elő, ha egy elem megkapja a billentyűzet fókuszát.
KeyboardInputProviderAcquireFocus	Akkor fordul elő, ha a billentyűzetbemenet-szolgáltató beszerzi a fókuszt.
KeyDown	Akkor fordul elő, ha a billentyűzeten egy billentyű van lenyomva.
KeyUp	Akkor fordul elő, ha a billentyűzeten egy billentyű ki van adva.
LostKeyboardFocus	Akkor fordul elő, ha egy elem elveszíti a billentyűzetfókuszt.
PreviewGotKeyboardFocus	Akkor fordul elő, ha egy elem éppen a billentyűzetfókusz megszerzésén dolgozik.
PreviewKeyboardInputProviderAcquireFocus	Akkor fordul elő, ha a billentyűzet beviteli szolgáltatója éppen a fókusz megszerzésén dolgozik.
PreviewKeyDown	Akkor fordul elő, ha a billentyűzeten egy billentyű van lenyomva.
PreviewKeyUp	Akkor fordul elő, ha a billentyűzeten egy billentyű ki van adva.
PreviewLostKeyboardFocus	Akkor fordul elő, ha egy elem a billentyűzetfókusz elvesztésének folyamatában van.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?