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 avec 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 l’entrée du clavier, l’élément doit être focusable. Pour rendre un élément focusable, définissez la Focusable propriété sur l’élément truede base sur . Pour plus d’informations sur les éléments de base, consultez Vue d’ensemble des éléments de base. Panelles classes, telles que StackPanel et , définissent la valeur par défaut sur Focusablefalse; par conséquent, pour que ces objets obtiennent le focus clavier, Focusable doivent être définies sur trueCanvas.

Le focus clavier fait référence à l’objet qui reçoit l’entrée du 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 de l’entrée et Vue d’ensemble du focus.

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