FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle Property

Définition

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.Gets or sets an object that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus.

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.The desired style to apply on focus. La valeur par défaut déclarée dans la propriété de dépendance est un Style statique vide.The default value as declared in the dependency property is an empty static Style. 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.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Remarques

Lors de la définition de XAMLXAMLcette propriété dans, 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 StaticResourceExtensionréférencée en tant que.When setting this property in XAMLXAML, styles are almost always defined as a resource, rather than inline as an element, and that resource is usually referenced as a StaticResourceExtension.

Notez que cette propriété affecte l’apparence visuelle, mais ne signale pas les métadonnées.Note that this property affects visual appearance but does not report so in metadata. 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 pas signaler généralement des informations visuelles ou de mise en page dans les métadonnées.This is because the visual appearance change is event-driven and may not apply at all times, and thus should not generally report any visual or layout information in metadata.

D’un point de vue conceptuel, le comportement visuel de focus appliqué à un contrôle doit être cohérent d’un élément à l’élément.Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. Le moyen le plus raisonnable d’appliquer la cohérence consiste à modifier uniquement le style de focus visuel si vous composez un thème entier.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. La définition de cette propriété sur des styles individuels et non pas 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 confuse concernant le focus clavier.Setting this property on individual styles and not as part of a theme is not the intended usage of this property, because it may lead to a confusing user experience regarding keyboard focus. Si vous entourez un comportement spécifique à un élément qui n’est délibérément pas cohérent au sein d’un thème, une meilleure approche consiste à utiliser des déclencheurs dans les styles pour IsFocused les IsKeyboardFocusWithinpropriétés d’état d’entrée individuelles, telles que ou, et à le faire d’une manière qui ne le fait pas interfère visuellement avec un style de focus visuel existant.If you are intending element-specific behavior that is deliberately not coherent across a theme, a much better approach is to use triggers in styles for individual input state properties, such as IsFocused or IsKeyboardFocusWithin, and to do so in a way that does not visually interfere with any existing focus visual style. Pour plus d’informations sur l’intention de FocusVisualStyle conception de et d’autres propriétés de focus, consultez stylisation for Focus in Controls et FocusVisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Utilisation des éléments de propriété XAMLXAML Property Element Usage

Valeurs XAMLXAML Values

resourceExtensionresourceExtension
L’une des valeurs suivantes:, ou.One of the following: , or . Consultez ressources XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Clé qui identifie le style demandé.The key that identifies the style being requested. La clé fait référence à une ressource existante dans ResourceDictionaryun.The key refers to an existing resource in a ResourceDictionary.

Notes

La syntaxe des éléments de propriété est techniquement possible, mais non recommandée.Property element syntax is technically possible, but not recommended. Consultez styles et modèles intralignes.See Inline Styles and Templates. Une référence de liaison à l' Binding aide de TemplateBinding ou est également possible, mais rare.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field FocusVisualStyleProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

S’applique à