Keyboard.Focus(IInputElement) Método

Definição

Espaço de Nomes:
System.Windows.Input
Assemblagem:
PresentationCore.dll

Define 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 em que definir o foco do teclado.

Devoluções

IInputElement

O elemento com foco no teclado.

Exemplos

O exemplo seguinte mostra um Loaded gestor de eventos que define o foco do teclado num 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

Observações

Para que um elemento receba entrada do teclado, o elemento deve ser focalizável. Para tornar um elemento focável, defina a Focusable propriedade no elemento base para true. Para 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 para false; portanto, para que estes objetos obtenham foco no teclado, Focusable devem ser definidos para true.

O foco do teclado refere-se ao objeto que está a receber a entrada do teclado. O elemento com foco do teclado está IsKeyboardFocused definido para true. Só pode haver um elemento com o teclado focado em todo o ambiente de trabalho. Foco lógico refere-se ao objeto dentro de um âmbito de foco que tem foco. Para mais informações sobre foco, foco do teclado e foco lógico, consulte Visão Geral de Entrada e Visão Geral de Foco.

Um elemento com foco de teclado também tem foco lógico para o âmbito de foco a que pertence. Um elemento com foco lógico pode ou não ter foco no teclado.

Aplica-se a