Keyboard.Focus(IInputElement) 方法

定义

命名空间:

System.Windows.Input

程序集:

PresentationCore.dll

对指定元素设置键盘焦点。

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

参数

element

IInputElement

要对其设置键盘焦点的元素。

返回

IInputElement

具有键盘焦点的元素。

示例

以下示例演示一个 Loaded 事件处理程序，该事件处理程序在 上 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

注解

对于要接收键盘输入的元素，该元素必须是可聚焦的。 若要使元素可聚焦，请将基元素上的 属性设置为 Focusabletrue。 有关基元素的详细信息，请参阅 基元素概述。 Panel 类（如 StackPanel 和 Canvas）将 的默认值 Focusable 设置为 false;因此，要获取键盘焦点， Focusable 必须将 这些对象设置为 true。

键盘焦点是指接收键盘输入的对象。 具有键盘焦点的 元素已 IsKeyboardFocused 设置为 true。 整个桌面上只能有一个具有键盘焦点的元素。 逻辑焦点是指具有焦点的焦点范围内的对象。 有关焦点、键盘焦点和逻辑焦点的详细信息，请参阅 输入概述 和 焦点概述。

具有键盘焦点的元素还具有该元素所属的焦点范围的逻辑焦点。 具有逻辑焦点的元素可能具有键盘焦点，也可能没有键盘焦点。