Partager via


FrameworkElement.FocusVisualStyle Propriété

Définition

Obtient ou définit une propriété qui permet la personnalisation de l’apparence, des effets ou d’autres caractéristiques de style qui s’appliquent à cet élément quand 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

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 par conséquent ne doit 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 mieux 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 de 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’une des opérations suivantes : , 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 de propriété est techniquement possible, mais pas recommandée. Consultez les styles et les modèles inline. Une 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

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

S’applique à

Voir aussi