FrameworkContentElement.FocusVisualStyle Eigenschap

Definitie

Hiermee wordt een object opgehaald of ingesteld waarmee het uiterlijk, de effecten of andere stijlkenmerken kunnen worden aangepast die van toepassing zijn op dit element wanneer de toetsenbordfocus wordt vastgelegd.

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

Waarde van eigenschap

De gewenste stijl die moet worden toegepast op focus. De standaardwaarde zoals gedeclareerd in de afhankelijkheidseigenschap is een lege statische Stylewaarde. De effectieve waarde tijdens runtime is echter vaak (maar niet altijd) een stijl zoals geleverd door themaondersteuning voor besturingselementen.

Opmerkingen

Bij het instellen van deze eigenschap in XAML worden stijlen bijna altijd gedefinieerd als een resource, in plaats van inline als element, en die resource wordt meestal aangeduid als een StaticResourceExtension.

Houd er rekening mee dat deze eigenschap van invloed is op het uiterlijk van de visual, maar dit niet rapporteert in metagegevens. Dit komt doordat de wijziging van het uiterlijk van de visual gebeurtenisgestuurd is en mogelijk niet altijd van toepassing is en daarom geen visuele of indelingsgegevens in metagegevens moet rapporteren.

Conceptueel moet het visuele gedrag van de focus die op een besturingselement wordt toegepast, coherent zijn van element tot element. De meest verstandige manier om coherentie af te dwingen, is door alleen de stijl van de focusvisual te wijzigen als u een heel thema opstelt. Het instellen van deze eigenschap voor afzonderlijke stijlen en niet als onderdeel van een thema is niet het beoogde gebruik van deze eigenschap, omdat dit kan leiden tot een verwarrende gebruikerservaring met betrekking tot toetsenbordfocus. Als u van plan bent elementspecifiek gedrag te gebruiken dat opzettelijk niet coherent is voor een thema, is het veel beter om triggers te gebruiken in stijlen voor eigenschappen van afzonderlijke invoerstatussen, zoals IsFocused of IsKeyboardFocusWithin, en dit op een manier die geen visuele invloed heeft op een bestaande stijl van de focusvisual. Zie FocusVisualStyle meer informatie over de ontwerpintentie van en alternatieve focuseigenschappen.

XAML-kenmerkgebruik

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

Gebruik van XAML-eigenschapselement

XAML-waarden

resourceExtension Een van de volgende opties: , of . Zie XAML-resources.

styleResourceKey De sleutel waarmee de stijl wordt geïdentificeerd die wordt aangevraagd. De sleutel verwijst naar een bestaande resource in een ResourceDictionary.

Note

Syntaxis van eigenschapselement is technisch mogelijk, maar wordt niet aanbevolen. Zie Inlinestijlen en -sjablonen. Een bindingsverwijzing met Behulp van TemplateBinding of Binding is ook mogelijk, maar ongebruikelijk.

Informatie over afhankelijkheidseigenschappen

Item Waarde
Id-veld FocusVisualStyleProperty
Eigenschappen van metagegevens ingesteld op true Geen

Van toepassing op