Freigeben über


Keyboard.Focus(IInputElement) Methode

Definition

Legt den Tastaturfokus auf 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, auf dem der Tastaturfokus festgelegt werden soll.

Gibt zurück

Das Element mit Tastaturfokus.

Beispiele

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

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 empfängt, muss das Element fokussierbar sein. Um ein Element fokussierbar zu machen, legen Sie die Focusable Eigenschaft für das Basiselement auf true. Weitere Informationen zu den Basiselementen finden Sie unter "Übersicht über Basiselemente". PanelKlassen, zStackPanel. B. und Canvas, legen den Standardwert auf falseFocusable ; daher müssen für diese Objekte, um den Tastaturfokus zu erhalten, Focusable auf truefestgelegt werden.

Der Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt. Das Element mit Tastaturfokus ist auf .> festgelegt. Es kann nur ein Element mit Tastaturfokus auf dem gesamten Desktop vorhanden sein. Der logische Fokus bezieht sich auf das Objekt innerhalb eines Fokusbereichs, der den Fokus besitzt. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter Input Overview and Focus Overview.

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

Gilt für: