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

備註

元素要接收鍵盤輸入，必須是可聚焦的。 要讓元素可聚焦，將基礎元素的屬性設 Focusable 為 true。 欲了解更多基礎元素資訊，請參閱 基礎元素概覽。 Panel 類別，如 StackPanel 和 Canvas，將 的 Focusable 預設值設為 false;因此，這些物件要獲得鍵盤焦點， Focusable 必須設為 true。

鍵盤焦點指的是接收鍵盤輸入的物件。 帶有鍵盤焦點的元素設定 IsKeyboardFocused 為 true。 整個桌面只能有一個元素以鍵盤為焦點。 邏輯焦點指的是聚焦範圍內具有焦點的物體。 關於焦點、鍵盤焦點與邏輯焦點的更多資訊，請參閱 輸入概述 與 焦點概述。

具有鍵盤焦點的元素也具有其所屬焦點範圍的邏輯焦點。 具有邏輯焦點的元素可能有或沒有鍵盤焦點。