ContentElement.Focus ContentElement.Focus ContentElement.Focus ContentElement.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 peut être placé sur cet élément ; false si l'appel à cette méthode n'a pas forcé l'affectation du focus.true if keyboard focus could be set to this element; false if this method call did not force focus.

Implémente

Exemples

L’exemple suivant est un gestionnaire d’événements de chargement de page qui recherche une certaine nommé paragraphe du document et affecte le focus.The following example is a page-loaded event handler that finds a specified named paragraph in the document and sets focus to it. Les paragraphes ne sont pas actifs par défaut ; Ce paragraphe particulier avait un style appliqué (non illustré), qui utilisait un style Setter pour le rendre actif.Paragraphs are not focusable by default; this particular paragraph had a style applied (not shown) that used a style Setter to make it 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

Soit actif, Focusable et IsEnabled doivent tous deux être true.To be focusable, Focusable and IsEnabled must both be true. Notez que presque toutes les ContentElement classes dérivées ne sont pas Focusable par défaut.Note that nearly all ContentElement derived classes are not Focusable by default.

Même si un élément est la gestion des événements de focus et être activé, 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 ne pas le focus, par conséquent, cette méthode retourne false.Even if an element is focusable and enabled, event handling within a specific tree, (such as for a composite control) might respond to the preview focus events by not allowing focus there, thus this method would return 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.Focus in general is governed by two separate concepts: keyboard focus and logical focus, which are not always identical. Cette méthode définit le focus logique.This method sets the logical focus. Il n’existe aucun moyen de programmation pour définir le focus clavier en particulier ; le focus clavier est déterminé par l’utilisateur.There is no programmatic means to set keyboard focus specifically; keyboard focus is determined by user input. Pour plus d’informations, consultez vue d’ensemble du Focus et vue d’ensemble de l’entrée.For more information, see Focus Overview 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).

S’applique à

Voir aussi