ContentElement.Focus Méthode
Définition
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.
Tente de définir le focus sur cet élément.
public:
virtual bool Focus();public bool Focus();abstract member Focus : unit -> bool
override this.Focus : unit -> boolPublic Function Focus () As BooleanRetours
true si le focus clavier peut être défini sur cet élément ; false si cet appel de méthode n’a pas forcé le focus.
Implémente
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 définit le focus sur celui-ci. Les paragraphes ne sont pas focusables 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 doit être truetous les deux . Notez que presque toutes les ContentElement classes dérivées ne sont pas Focusable par défaut.
Même si un élément est focusable et activé, la gestion des événements dans 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.
Le focus en général 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 focus), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (source est la nouvelle cible de focus).
