Megosztás a következőn keresztül:

ThemeDictionary Markup bővítmény

Lehetővé teszi az egyéni vezérlőkészítők vagy alkalmazások számára, hogy külső vezérlőket integráljanak a témaspecifikus erőforrás-szótárak betöltéséhez a vezérlő formázásához.

XAML-attribútumok használata

<object property="{ThemeDictionary assemblyUri}" ... />

XAML objektumelem-használat

<object>
  <object.property>
    <ThemeDictionary AssemblyName="assemblyUri"/>
  <object.property>
<object>

XAML-értékek

Érték Leírás
assemblyUri A témainformációkat tartalmazó szerelvény egységes erőforrás-azonosítója (URI). Ez általában egy csomag URI-ja, amely a nagyobb csomag egy szerelvényére hivatkozik. Az összeállítási erőforrások és a csomag URI-kkal egyszerűbbé teszik az üzembe helyezéssel kapcsolatos problémákat. További információért lásd: Pack URI-k a WPF-ben.

Megjegyzések

Ez a bővítmény csak egy tulajdonságérték kitöltésére szolgál: a ResourceDictionary.Sourceértékét.

Ennek a bővítménynek a használatával megadhat egyetlen, csak erőforrásokból álló szerelvényt, amely csak akkor használható stílusokat tartalmaz, ha a Windows Aero téma a felhasználó rendszerére van alkalmazva, más stílusokat csak akkor, ha a Luna-téma aktív, és így tovább. Ennek a bővítménynek a használatával a vezérlőspecifikus erőforrás-szótár tartalma automatikusan érvényteleníthető, és szükség esetén újra betölthető egy másik témához.

A assemblyUri sztring (AssemblyName tulajdonságérték) egy elnevezési konvenció alapját képezi, amely meghatározza, hogy melyik szótár vonatkozik egy adott témára. A ProvideValueThemeDictionary logikája azzal egészíti ki a konvenciót, hogy létrehoz egy egységes erőforrás-azonosítót (URI), amely egy előre összeállított erőforrás-gyűjteményben található adott témaszótár-változatra mutat. Ennek a szabványnak a leírása, mint koncepció, vagy az általános vezérlési stílus és a lap/alkalmazásszintű stílus közti interakciók itt nincsenek teljeskörűen tárgyalva. A ThemeDictionary használatának alapvető forgatókönyve egy alkalmazás szintjén deklarált SourceResourceDictionary tulajdonságának megadása. Ha nem közvetlen URI-ként, hanem ThemeDictionary kiterjesztésen keresztül ad meg egy URI-t az assembly részére, a kiterjesztés logika érvénytelenítési logikát biztosít, ami a rendszertéma megváltozásakor alkalmazható.

Az attribútumszintaxis a korrektúrakiterjesztés leggyakoribb szintaxisa. A ThemeDictionary azonosító sztringje után megadott karakterlánc token a mögöttes AssemblyName bővítményosztály ThemeDictionaryExtension értékéhez van hozzárendelve.

ThemeDictionary az objektumelem szintaxisában is használható. Ebben az esetben a AssemblyName tulajdonság értékének megadása szükséges.

ThemeDictionary olyan részletes attribútumhasználatban is használható, amely a Member tulajdonságot tulajdonság=érték párként határozza meg:

<object property="{ThemeDictionary AssemblyName=assemblyUri}" ... />

A részletes használat gyakran hasznos olyan bővítmények esetében, amelyek több beállítási tulajdonsággal rendelkeznek, vagy ha egyes tulajdonságok nem kötelezőek. Mivel ThemeDictionary csak egy beállítási tulajdonsággal rendelkezik, ami kötelező, ez a bőbeszédű használat nem jellemző.

A WPF XAML processzor implementációjában a jelölőbővítmény kezelését a ThemeDictionaryExtension osztály határozza meg.

ThemeDictionary egy korrektúrakiterjesztés. Jelölőkiterjesztéseket általában akkor alkalmaznak, amikor szükség van arra, hogy az attribútumértékek ne csak konstans értékek vagy kezelőnevek legyenek, és a követelmény globálisabb, mint bizonyos típusok vagy tulajdonságok esetében a típuskonverterek használata. Az XAML-ben az összes korrektúrakiterjesztés az attribútumszintaxisában a { és } karaktert használja, amely az a konvenció, amellyel az XAML-processzor felismeri, hogy egy korrektúrakiterjesztésnek fel kell dolgoznia az attribútumot. További információ: Korrektúrakiterjesztések és WPF XAML.

Lásd még

  • Last updated on