Keyboard.Focus(IInputElement) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.IInputElementPublic Shared Function Focus (element As IInputElement) As IInputElementParâmetros
- element
- IInputElement
O elemento no qual definir o foco do teclado.
Retornos
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.
