FrameworkContentElement.FocusVisualStyle Propriété

Définition

Obtient ou définit un objet 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

Lorsque vous définissez cette propriété en XAML, les styles sont presque toujours définis comme une ressource, plutôt que inline comme élément, et cette ressource est généralement référencée en tant que StaticResourceExtensionressource .

Notez que cette propriété affecte l’apparence visuelle, mais ne l’indique 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 l’élément et 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 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 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 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 à