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

パラメーター

戻り値

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

例

次の例は、キーボード フォーカスをButtonに設定するLoaded イベント ハンドラーを示しています。

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 に設定する必要があります。

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

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