FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle Property

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.Gets or sets a property 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

Cette propriété affecte l’apparence visuelle mais ne signale pas AffectsRender dans les métadonnées.This property affects visual appearance but does not report AffectsRender in metadata. Il s’agit, car la modification de l’apparence visuelle est pilotée par événements et ne peut-être pas s’appliquer à tout moment et par conséquent ne doit pas généralement signaler toute information visual ou une disposition dans les métadonnées.This is because the visual appearance change is event-driven and may not apply at all times, and therefore should not generally report any visual or layout information in metadata.

Point de vue conceptuel, le comportement visuel de focus appliqué à un contrôle doit être cohérent du contrôle.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. La méthode la plus sensible pour 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. Définition de cette propriété sur des styles de contrôle et non comme faisant partie d’un thème n’est pas l’utilisation prévue de cette propriété, car elle peut entraîner une expérience utilisateur ambiguë concernant le focus clavier.Setting this property on individual control 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 prévoyez un comportement spécifique au contrôle qui est délibérément pas cohérent à travers un thème, une approche bien meilleure consiste à utiliser des déclencheurs dans les styles pour les propriétés de l’état d’entrées individuelles, telles que IsFocused ou IsKeyboardFocusWithinet à le faire d’une façon qui ne pas visuellement, interférer avec n’importe quel style de focus visuel existant.If you are intending control-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 conception de FocusVisualStyle et d’autres propriétés du focus, consultez focus dans les contrôles 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
Une des opérations suivantes :, ou.One of the following: , or . Consultez XAML ressources.See XAML Resources.

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

Notes

Syntaxe d’élément de propriété est techniquement possible, mais non recommandée.Property element syntax is technically possible, but not recommended. Consultez modèles et Styles intralignes.See Inline Styles and Templates. Une référence de liaison à l’aide TemplateBinding ou Binding 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
La valeur des propriétés de métadonnées trueMetadata properties set to true Aucun.None

S’applique à

Voir aussi