UIElement.Focus Méthode

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 été définis sur cet élément ; false si seul le focus logique a été défini sur cet élément, ou si l’appel à cette méthode n’a pas forcé le focus à modifier.

Implémente

Exemples

L’exemple suivant définit le focus sur une TextBox référence 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 être focusable, Focusable et IsEnabled doit être truetous les 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 se concentrer 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 de l’entrée.

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 (source est la nouvelle cible 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 doit 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 sera false. Pour tester si l’élément a le focus, utilisez les propriétés et IsKeyboardFocusWithin les IsKeyboardFocused propriétés.