Langue

FrameworkElement.FocusVisualStyle Propriété

Définition

Obtient ou définit une propriété qui active la personnalisation de l’apparence, des effets ou d’autres caractéristiques de style qui s’appliqueront à 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 souhaité à appliquer sur le focus. La valeur par défaut déclarée dans la propriété de dépendance est une valeur statique Stylevide. Toutefois, la valeur effective au moment de l’exécution est souvent (mais pas toujours) un style fourni par la prise en charge du thème pour les contrôles.

Remarques

Cette propriété affecte l’apparence visuelle, mais ne signale AffectsRender 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 entre le contrôle et le contrôle. 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 de contrôle 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 au contrôle 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 les propriétés d’état d’entrée individuelles, telles que IsFocused ou IsKeyboardFocusWithin, et pour ce faire de manière à ne pas interférer 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 les contrôles et FocusVisualStyle.

Utilisation des attributs XAML

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

Utilisation de l’élément 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.

Note

La syntaxe de l’élément property est techniquement possible, mais n’est pas recommandée. Consultez les styles et les modèles inline. Référence de liaison à l’aide de TemplateBinding ou Binding est également possible, mais rare.

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

Élément Valeur
Champ d’identificateur FocusVisualStyleProperty
Propriétés de métadonnées définies sur true None

S’applique à

Voir aussi