FrameworkContentElement.FocusVisualStyle Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit un objet qui active la personnalisation de l’apparence, les effets ou d’autres caractéristiques de style qui s’appliquent à cet élément lorsqu’il capture le focus clavier.

public:
 property System::Windows::Style ^ FocusVisualStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };

public System.Windows.Style FocusVisualStyle { get; set; }

member this.FocusVisualStyle : System.Windows.Style with get, set

Public Property FocusVisualStyle As Style

Valeur de propriété

Style

Style souhaité à appliquer sur le focus. La valeur par défaut déclarée dans la propriété de dépendance est un Style statique vide. Toutefois, la valeur effective au moment de l’exécution est souvent (mais pas toujours) un style tel qu’il est fourni par la prise en charge du thème pour les contrôles.

Remarques

Lors de la définition de cette propriété en XAML, les styles sont presque toujours définis en tant que ressource, plutôt qu’en tant qu’élément, et cette ressource est généralement référencée en tant que StaticResourceExtension.

Notez que cette propriété affecte l’apparence visuelle, mais qu’elle ne le signale pas dans les métadonnées. Cela est dû au fait que la modification de l’apparence visuelle est pilotée par les événements et peut ne pas s’appliquer à tout moment, et ne doit donc généralement pas signaler d’informations visuelles ou de disposition dans les métadonnées.

Conceptuellement, le comportement visuel du focus appliqué à un contrôle doit être cohérent de l’élément à l’élément. La façon la plus sensible d’appliquer la cohérence consiste à modifier uniquement le style visuel de focus si vous composez un thème entier. La définition de cette propriété sur des styles individuels et non dans le cadre d’un thème n’est pas l’utilisation prévue de cette propriété, car elle peut entraîner une expérience utilisateur déroutante concernant le focus clavier. Si vous envisagez un comportement spécifique à l’élément qui n’est délibérément pas cohérent dans un thème, une approche beaucoup plus efficace consiste à utiliser des déclencheurs dans des styles pour des propriétés d’état d’entrée individuelles, telles que IsFocused ou IsKeyboardFocusWithin, et de le faire d’une manière qui n’interfère pas visuellement avec un style visuel focus existant. Pour plus d’informations sur l’intention de conception et les autres propriétés de FocusVisualStyle focus, consultez Style pour focus dans contrôles et FocusVisualStyle.

Utilisation d'attributs XAML

<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>  

Utilisation des éléments de propriété XAML

Valeurs XAML

resourceExtension
L’un des éléments suivants : , ou . Consultez les ressources XAML.

styleResourceKey
Clé qui identifie le style demandé. La clé fait référence à une ressource existante dans un ResourceDictionary.

Notes

La syntaxe de l’élément Property est techniquement possible, mais pas recommandée. Voir Styles et modèles inline. Référence de liaison utilisant TemplateBinding ou Binding est également possible, mais rare.

Informations sur les propriétés de dépendance

Champ d’identificateur	FocusVisualStyleProperty
Propriétés de métadonnées définies sur true	Aucun