Keyboard.Focus(IInputElement) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Input

Zestaw:

PresentationCore.dll

Ustawia fokus klawiatury dla określonego elementu.

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

Parametry

element

IInputElement

Element, na którym należy ustawić fokus klawiatury.

Zwraca

IInputElement

Element z fokusem klawiatury.

Przykłady

W poniższym przykładzie pokazano procedurę obsługi zdarzeń Loaded , która ustawia fokus klawiatury na obiekcie 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

Uwagi

Aby element odbierał dane wejściowe klawiatury, element musi mieć fokus. Aby ustawić element w trybie koncentracji uwagi, ustaw Focusable właściwość elementu podstawowego na truewartość . Aby uzyskać więcej informacji na temat elementów podstawowych, zobacz Omówienie elementów podstawowych. Panel klasy, takie jak StackPanel i Canvas, ustaw wartość Focusablefalsedomyślną na ; w związku z tym dla tych obiektów, aby uzyskać fokus klawiatury, Focusable należy ustawić wartość true.

Fokus klawiatury odnosi się do obiektu odbierającego dane wejściowe klawiatury. Element z fokusem klawiatury ma IsKeyboardFocused ustawioną wartość true. Na całym pulpicie może znajdować się tylko jeden element z fokusem klawiatury. Fokus logiczny odnosi się do obiektu w zakresie fokusu, który ma fokus. Aby uzyskać więcej informacji na temat fokusu, fokusu klawiatury i fokusu logicznego, zobacz Omówienie danych wejściowych i Omówienie fokusu.

Element z fokusem klawiatury ma również logiczny fokus dla zakresu fokusu, do którego należy element. Element z fokusem logicznym może lub nie ma fokusu klawiatury.