Keyboard.Focus(IInputElement) Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Determina o foco do teclado no elemento especificado.

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

Parâmetros

element

IInputElement

O elemento no qual definir o foco do teclado.

Retornos

IInputElement

O elemento com foco do teclado.

Exemplos

O exemplo a seguir mostra um Loaded manipulador de eventos que define o foco do teclado em um 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

Comentários

Para que um elemento receba entrada de teclado, o elemento deve ser focalizável. Para tornar um elemento focalizável, defina a Focusable propriedade no elemento base como true. Para obter mais informações sobre os elementos base, consulte Visão geral dos elementos base. Panel classes, como StackPanel e Canvas, definem o valor padrão de Focusable como false; portanto, para que esses objetos obtenham o foco do teclado, Focusable devem ser definidas como true.

O foco do teclado refere-se ao objeto que está recebendo entrada de teclado. O elemento com foco no teclado foi IsKeyboardFocused definido como true. Só pode haver um elemento com foco no teclado em toda a área de trabalho. O foco lógico refere-se ao objeto dentro de um escopo de foco que tem foco. Para obter mais informações sobre foco, foco do teclado e foco lógico, consulte Visão geral de entrada e Visão geral do foco.

Um elemento com foco no teclado também tem foco lógico para o escopo de foco ao qual o elemento pertence. Um elemento com foco lógico pode ou não ter o foco do teclado.