Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Method

Definition

Legt den Tastaturfokus für das angegebene Element fest.Sets keyboard focus on the specified element.

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

Das Element, für das der Tastaturfokus festgelegt werden soll.The element on which to set keyboard focus.

Gibt zurück

Das Element mit dem Tastaturfokus.The element with keyboard focus.

Beispiele

Das folgende Beispiel zeigt einen Loaded -Ereignishandler, der den Tastaturfokus Buttonauf einen festlegt.The following example shows a Loaded event handler that sets keyboard focus on a 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 als Fokus verwendbar sein.For an element to receive keyboard input, the element must be focusable. Legen Sie die Focusable -Eigenschaft für das Basis trueElement auf fest, damit ein Element Fokus fähig ist.To make an element focusable, set the Focusable property on the base element to true. Weitere Informationen zu den Basiselementen finden Sie unter Übersicht über Basiselemente.For more information on the base elements, see Base Elements Overview. PanelKlassen, wie z StackPanel false true Focusable .bCanvas. und, legen den Standardwert von auf fest. deshalb mussfürdieseObjekteauffestgelegtwerden,damitSiedenTastaturfokuserhalten.FocusablePanel classes, such as StackPanel and Canvas, set the default value of Focusable to false; therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

Der Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt.Keyboard focus refers to the object that is receiving keyboard input. Das Element mit dem Tastaturfokus IsKeyboardFocused ist auf truefestgelegt.The element with keyboard focus has IsKeyboardFocused set to true. Es darf nur ein Element mit dem Tastaturfokus auf dem gesamten Desktop vorhanden sein.There can be only one element with keyboard focus on the entire desktop. Der logische Fokus bezieht sich auf das Objekt innerhalb eines Fokusbereichs, der den Fokus besitzt.Logical focus refers to the object within a focus scope that has focus. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter Übersicht über Eingaben und Fokus.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Ein Element mit dem Tastaturfokus verfügt auch über den logischen Fokus auf den Fokusbereich, zu dem das Element gehört.An element with keyboard focus also has logical focus for the focus scope the element belongs to. Ein Element mit dem logischen Fokus kann den Tastaturfokus aufweisen oder nicht.An element with logical focus may or may not have keyboard focus.

Gilt für: