UIElement.Focus Méthode

Définition

Essaie d'affecter le focus sur cet élément.

public:
 virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean

Retours

true si le focus clavier et le focus logique ont eu pour valeur cet élément ; false si seul le focus logique a eu pour valeur cet élément, ou si l'appel de cette méthode n'a pas entraîné de modification du focus.

Implémente

Exemples

L’exemple suivant définit le focus sur un TextBox référencé par Name, puis ajuste la position du curseur dans le TextBox.

void OnClickMoveToStart(object sender, RoutedEventArgs e)
{
    tbPositionCursor.Focus();
    tbPositionCursor.Select(0, 0);
}
Private Sub OnClickMoveToStart(ByVal sender As Object, ByVal e As RoutedEventArgs)

    tbPositionCursor.Focus()
    tbPositionCursor.Select(0, 0)

End Sub

Remarques

Pour pouvoir être mis au point, Focusable et IsEnabled doivent être truetous deux .

Même si l’élément est focusable et valide, les Focus événements d’aperçu peuvent être traités dans une arborescence spécifique, et le focus sur cet élément peut ne pas être autorisé (par exemple, dans un contrôle composite). Dans ce cas, cette méthode retourne false.

En général, le focus est contrôlé par deux concepts différents : le focus clavier et le focus logique. Ces deux concepts ne sont pas toujours les mêmes. Pour plus d’informations, consultez Résumé du focus et Vue d’ensemble des entrées.

Si l’appel Focus retourne true, IsKeyboardFocused et IsKeyboardFocusWithin sont également true.

Si les propriétés associées ne sont pas déjà true, lorsque vous appelez Focus, un ou plusieurs des événements suivants sont déclenchés dans l’ordre suivant : PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (la source est la nouvelle cible de focus), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus( GotKeyboardFocus source est la nouvelle cible de focus).

Pour que cet appel réussisse, un autre élément de l’application devait avoir le focus précédemment. En outre, lorsqu’un élément conteneur parent appelle cette méthode, dans certaines situations, l’enfant obtient le focus et la valeur de retour est false. Pour tester si l’élément a le focus, utilisez les IsKeyboardFocusWithin propriétés et IsKeyboardFocused .

S’applique à