Keyboard.Focus(IInputElement) メソッド

定義

指定した要素にキーボード フォーカスを設定します。

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

キーボード フォーカスの設定対象の要素。

戻り値

キーボード フォーカスを持つ要素。

次の例は、 に 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クラスは、 のFocusable既定値を にfalse設定します。したがって、これらのオブジェクトがキーボード フォーカスを取得するには、 Focusable を に設定するtrue必要Canvasがあります。

キーボード フォーカスは、キーボード入力を受け取っているオブジェクトを指します。 キーボード フォーカスを持つ要素が にtrue設定されていますIsKeyboardFocused。 デスクトップ全体にキーボード フォーカスがある要素は 1 つだけです。 論理フォーカスとは、フォーカスがあるフォーカス スコープ内のオブジェクトを指します。 フォーカス、キーボード フォーカス、論理フォーカスの詳細については、「 入力の概要 」と「 フォーカスの概要」を参照してください。

キーボード フォーカスを持つ要素には、要素が属するフォーカス スコープの論理フォーカスもあります。 論理フォーカスを持つ要素には、キーボード フォーカスがある場合とない場合があります。

適用対象