ContentElement.Focus Méthode

Référence

Définition

Espace de noms:: System.Windows

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Boolean

true si le focus clavier peut être placé sur cet élément ; false si l'appel à cette méthode n'a pas forcé l'affectation du focus.

Implémente

Focus()

Exemples

L’exemple suivant est un gestionnaire d’événements chargé sur une page qui recherche un paragraphe nommé spécifié dans le document et y met le focus. Les paragraphes ne peuvent pas être mis au point par défaut ; ce paragraphe particulier avait un style appliqué (non affiché) qui utilisait un style Setter pour le rendre focusable.

void FocusOnParagraph(object sender, RoutedEventArgs e)
{
  ContentElement ce = this.FindName("focusableP") as ContentElement;
  ce.Focus();
}

Private Sub FocusOnParagraph(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Dim ce As ContentElement = TryCast(Me.FindName("focusableP"), ContentElement)
  ce.Focus()
End Sub

Remarques

Pour être focusable, Focusable et IsEnabled doivent tous les deux être true. Notez que presque toutes les ContentElement classes dérivées ne le sont pas Focusable par défaut.

Même si un élément est focusable et activé, la gestion des événements au sein d’une arborescence spécifique (par exemple, pour un contrôle composite) peut répondre aux événements de focus d’aperçu en n’autorisant pas le focus là-bas, donc cette méthode retournerait false.

En général, le focus est régi par deux concepts distincts : le focus clavier et le focus logique, qui ne sont pas toujours identiques. Cette méthode définit le focus logique. Il n’existe aucun moyen programmatique de définir spécifiquement le focus clavier ; le focus clavier est déterminé par l’entrée utilisateur. Pour plus d’informations, consultez Vue d’ensemble 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 (source est la nouvelle cible de focus), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (source est la nouvelle cible de focus).

S’applique à