Keyboard.Focus(IInputElement) Methode

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Legt den Tastaturfokus für das angegebene Element fest.

public:
 static System::Windows::IInputElement ^ Focus(System::Windows::IInputElement ^ element);

public static System.Windows.IInputElement Focus (System.Windows.IInputElement element);

static member Focus : System.Windows.IInputElement -> System.Windows.IInputElement

Public Shared Function Focus (element As IInputElement) As IInputElement

Parameter

element

IInputElement

Das Element, für das der Tastaturfokus festgelegt werden soll.

Gibt zurück

IInputElement

Das Element mit dem Tastaturfokus.

Beispiele

Das folgende Beispiel zeigt einen Loaded Ereignishandler, der den Tastaturfokus auf ein Buttonfestlegt.

private void OnLoaded(object sender, RoutedEventArgs e)
{
    // Sets keyboard focus on the first Button in the sample.
    Keyboard.Focus(firstButton);
}

Private Sub OnLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Sets keyboard focus on the first Button in the sample.
    Keyboard.Focus(firstButton)
End Sub

Hinweise

Damit ein Element Tastatureingaben empfangen kann, muss das Element fokussierbar sein. Um ein Element fokussierbar zu machen, legen Sie die Focusable -Eigenschaft für das Basiselement auf fest true. Weitere Informationen zu den Basiselementen finden Sie unter Übersicht über Basiselemente. PanelKlassen wie StackPanel und Canvaslegen den Standardwert auf falseFocusable fest. Daher muss für diese Objekte, um den Tastaturfokus zu erhalten, Focusable auf truefestgelegt werden.

Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt. Das Element mit Tastaturfokus ist IsKeyboardFocused auf truefestgelegt. Es kann nur ein Element mit Tastaturfokus auf dem gesamten Desktop vorhanden sein. Logischer Fokus bezieht sich auf das Objekt in einem Fokusbereich, der den Fokus hat. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter Eingabeübersicht und Fokusübersicht.

Ein Element mit Tastaturfokus verfügt auch über einen logischen Fokus für den Fokusbereich, zu dem das Element gehört. Ein Element mit logischem Fokus kann den Tastaturfokus haben oder nicht.