Keyboard.Focus(IInputElement) Méthode

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Définit le focus clavier sur l'élément spécifié.

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

Paramètres

element

IInputElement

Élément sur lequel définir le focus clavier.

Retours

IInputElement

Élément ayant le focus clavier.

Exemples

L’exemple suivant montre un gestionnaire d’événements Loaded qui définit le focus clavier sur un 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

Remarques

Pour qu’un élément reçoive une entrée au clavier, l’élément doit pouvoir être focus. Pour rendre un élément focus, définissez la Focusable propriété sur l’élément de base sur true. Pour plus d’informations sur les éléments de base, consultez Vue d’ensemble des éléments de base. Panel les classes, telles que StackPanel et Canvas, définissent la valeur par défaut de Focusable sur false; par conséquent, pour que ces objets obtiennent le focus clavier, Focusable doivent avoir la valeur true.

Le focus clavier fait référence à l’objet qui reçoit une entrée au clavier. L’élément avec le focus clavier a IsKeyboardFocused la valeur true. Il ne peut y avoir qu’un seul élément avec le focus clavier sur l’ensemble du bureau. Le focus logique fait référence à l’objet dans une étendue de focus qui a le focus. Pour plus d’informations sur le focus, le focus clavier et le focus logique, consultez Vue d’ensemble des entrées et Vue d’ensemble du focus.

Un élément avec le focus clavier a également le focus logique pour l’étendue de focus à laquelle appartient l’élément. Un élément avec le focus logique peut avoir ou non le focus clavier.