UIElement.Focus UIElement.Focus UIElement.Focus UIElement.Focus Method

Définition

Essaie d'affecter le focus sur cet élément.Attempts to set focus to this element.

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.true if keyboard focus and logical focus were set to this element; false if only logical focus was set to this element, or if the call to this method did not force the focus to change.

Implémente

Exemples

L’exemple suivant définit le focus un TextBox référencé par Name, puis ajuste la position du curseur dans le TextBox.The following example sets focus to a TextBox referenced by Name, and then adjusts the position of the cursor within the 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

Soit actif, Focusable et IsEnabled doivent tous deux être true.To be focusable, Focusable and IsEnabled must both be true.

Même si l’élément est actif et valide, le Focus événements preview peuvent être traités dans une arborescence spécifique, et le focus sur cet élément ne peuvent pas être autorisé (par exemple, dans un contrôle composite).Even if the element is focusable and valid, the Focus preview events may be processed in a specific tree, and focus on that element may not be allowed (for example, in a composite control). Dans ce cas, cette méthode retourne false.In such a case, this method returns false.

En règle générale, le focus est contrôlé par deux concepts différents : le focus clavier et le focus logique.In general, focus is controlled by two different concepts: keyboard focus and logical focus. Ces deux concepts ne sont pas toujours à la même.These two concepts are not always the same. Pour plus d’informations, consultez résumé de Focus et vue d’ensemble de l’entrée.For more information, see Focus summary and Input Overview.

Si l’appel Focus retourne true, IsKeyboardFocused et IsKeyboardFocusWithin sont également true.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also 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 cible de focus), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (la source est la cible de focus).If the related properties are not already true, when you call Focus, one or more of the following events are raised in the following order: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (source is the new focus target), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (source is the new focus target).

Afin que cet appel réussisse, un autre élément dans l’application requises pour que le focus précédemment.In order for this call to be successful, some other element in the application needed to have focus previously.

S’applique à