KeyEventArgs.KeyStates Eigenschaft

Definition

Ruft den Zustand der diesem Ereignis zugeordneten Taste ab.Gets the state of the keyboard key associated with this event.

public:
 property System::Windows::Input::KeyStates KeyStates { System::Windows::Input::KeyStates get(); };
public System.Windows.Input.KeyStates KeyStates { get; }
member this.KeyStates : System.Windows.Input.KeyStates
Public ReadOnly Property KeyStates As KeyStates

Eigenschaftswert

Der Zustand der Taste.The state of the key.

Beispiele

Im folgenden Beispiel wird überprüft, ob ein mit einer Instanz von KeyEventArgs verknüpften Schlüssel durch Ausführen eines bitweisen AND Vergleichs mit dem KeyStates des-Schlüssels und des Down -Enumerationswerts nicht erreichbar ist.The following example checks whether a key associated with an instance of KeyEventArgs is down by performing a bitwise AND comparison on the KeyStates of the key and the Down enumeration value.

// A bitwise AND operation is used in the comparison.
// e is an instance of KeyEventArgs.
// btnDown is a Button.
if ((e.KeyStates & KeyStates.Down) > 0)
{
    btnDown.Background = Brushes.Red;
}
' A bitwise AND operation is used in the comparison.
' e is an instance of KeyEventArgs.
' btnDown is a Button.
If (e.KeyStates And KeyStates.Down) > 0 Then
    btnDown.Background = Brushes.Red

Hinweise

Ein Schlüssel kann sich in den Status "hoch" und "ein-oder ausgeschaltet" oder "nach unten" und "ein/aus" befinden.A key can be in both the up and toggled states or the down and toggled states. Aus diesem Grund ist es nicht so einfach, festzustellen, ob ein Schlüssel auf dem neuesten Stand KeyStates ist, und den Wert als numerischen Wert zu überprüfen.For this reason, determining whether a key is up or down is not as simple as checking the KeyStates value as a numeric value. Stattdessen sollten Sie den Wert überprüfen, indem Sie ihn als Flagenumeration behandeln.Instead, you should check the value by treating it as a flag enumeration. Verwenden Sie AND einen Vergleich des ersten Bits.Use an AND comparison of the first bit. Verwenden Sie alternativ die Hilfseigenschaften IsUp, IsDownund IsToggled , um zu bestimmen, ob ein angegebener Schlüssel ein-oder ausgeschaltet ist.Alternatively, use the helper properties IsUp, IsDown, and IsToggled to determine whether a given key is up, down, or toggled.

Gilt für:

Siehe auch