FrameworkContentElement.FocusVisualStyle Tulajdonság

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállít egy objektumot, amely lehetővé teszi a megjelenés, az effektusok vagy más stílusjellemzők testreszabását, amelyek erre az elemre vonatkoznak a billentyűzetfókusz rögzítésekor.

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

Tulajdonság értéke

Style

A fókuszra alkalmazni kívánt stílus. A függőségi tulajdonságban deklarált alapértelmezett érték üres statikus Style. A futtatáskor érvényes érték azonban gyakran (de nem mindig) stílus, amelyet a vezérlők tématámogatása biztosít.

Megjegyzések

Ha ezt a tulajdonságot XAML-ben állítja be, a stílusok szinte mindig erőforrásként vannak definiálva, nem pedig beágyazott elemként, és az erőforrásra általában hivatkoznak StaticResourceExtension.

Vegye figyelembe, hogy ez a tulajdonság hatással van a vizualizáció megjelenésére, de nem jelenti a metaadatokban. Ennek az az oka, hogy a vizualizáció megjelenésének módosítása eseményvezérelt, és előfordulhat, hogy nem mindig érvényes, ezért általában nem jelenthet semmilyen vizualizációs vagy elrendezési információt a metaadatokban.

Elméletileg a vezérlőkre alkalmazott fókusz vizuális viselkedésének elemről elemre kell koherensnek lennie. A koherencia kikényszerítésének legérthetőbb módja, ha csak egy teljes téma írásakor módosítja a fókusz vizuális stílusát. Ha ezt a tulajdonságot egyéni stílusokra állítja be, és nem téma részeként, nem a tulajdonság rendeltetése, mert a billentyűzetfókuszt illetően zavaró felhasználói élményhez vezethet. Ha olyan elemspecifikus viselkedést tervez, amely szándékosan nem koherens egy témában, sokkal jobb módszer, ha az egyes bemeneti állapottulajdonságok stílusaiban használ triggereket, például IsFocused vagy IsKeyboardFocusWithin, és ezt úgy kell megtennie, hogy vizuálisan ne zavarja a meglévő fókuszvizualizációs stílusokat. További információ a tervezési szándékról FocusVisualStyle és az alternatív fókusztulajdonságokról: Styling for Focus in Controls, and FocusVisualStyle.

XAML-attribútumok használata

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

XAML tulajdonságelem-használat

XAML-értékek

resourceExtension Az alábbiak egyike: vagy . Lásd : XAML-erőforrások.

styleResourceKey A kért stílust azonosító kulcs. A kulcs egy meglévő erőforrásra hivatkozik egy ResourceDictionary.

Note

A tulajdonságelem szintaxisa technikailag lehetséges, de nem ajánlott. Lásd : Beágyazott stílusok és sablonok. A TemplateBinding használatával történő kötési hivatkozás, vagy Binding lehetséges, de nem gyakori.

Függőségi tulajdonság adatai

Termék	Érték
Azonosító mező	FocusVisualStyleProperty
Metaadat-tulajdonságok beállítása: true	None