FrameworkElement.FocusVisualStyle Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 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 |