为集成第三方控件的自定义控件创作者或应用程序提供一种方法,用于加载要在设置控件样式时使用的特定于主题的资源字典。
XAML 属性用法
<object property="{ThemeDictionary assemblyUri}" .../>
XAML 对象元素用法
<object>
<object.property>
<ThemeDictionary AssemblyName="assemblyUri"/>
<object.property>
<object>
XAML 值
assemblyUri |
程序集的 统一资源标识符 (URI),其中包含主题信息。 通常,这是一个引用较大包中程序集的 Pack URI。 程序集资源和 Pack URI 可以简化部署问题。 有关详细信息,请参阅 WPF 中的 Pack URI。 |
备注
此扩展旨在填补只有一个特定属性值: 的值xref:System.Windows.ResourceDictionary.Source*?displayProperty=nameWithType。
通过使用此扩展,可以指定一个纯资源程序集,该程序集包含一些仅在向用户系统应用 Windows Aero 主题时使用的样式、当 Luna 主题处于活动状态时的其他样式等。 通过使用此扩展,可以自动让特定于控件的资源字典的内容失效,并在需要时重新将其加载为特定于其他主题的内容。
assemblyUri字符串 (xref:System.Windows.ThemeDictionaryExtension.AssemblyName*属性值) 标识的字典适用于特定主题的命名约定的基础。 xref:System.Windows.Markup.MarkupExtension.ProvideValue*逻辑ThemeDictionary通过生成来完成约定统一资源标识符 (URI),它指向特定主题字典变体,包含在预编译的资源程序集中。 本文并未将该约定(即主题与一般控件样式设置和页/应用程序级样式设置之间的交互)作为一个概念进行详细介绍。 使用的基本情形ThemeDictionary是指定xref:System.Windows.ResourceDictionary.Source*属性的ResourceDictionary应用程序级别的声明。 将 URI 通过 ThemeDictionary 扩展而不是作为一个直接的 URI 提供给程序集时,扩展逻辑将提供系统主题更改时适用的失效逻辑。
特性语法是最常用于该标记扩展的语法。 在 ThemeDictionary 标识符字符串之后提供的字符串标记被指定为基础 xref:System.Windows.ThemeDictionaryExtension.AssemblyName* 扩展类的 xref:System.Windows.ThemeDictionaryExtension 值。
ThemeDictionary 还可以在对象元素语法中使用。 在这种情况下,指定的值xref:System.Windows.ThemeDictionaryExtension.AssemblyName*属性是必需的。
ThemeDictionary 还可以在详细特性用法中使用,以便将 xref:System.Windows.Markup.StaticExtension.Member* 属性指定为一个 property=value 对:
<object property="{ThemeDictionary AssemblyName=assemblyUri}" .../>
如果扩展具有一个以上的可设置属性,或者某些属性是可选的,则详细用法通常会很有用。 由于 ThemeDictionary 仅有一个可设置的属性,并且此属性是必需的,因此该详细用法不具有典型性。
在中WPFXAML处理器实现中,对此标记扩展的处理由定义xref:System.Windows.ThemeDictionaryExtension类。
ThemeDictionary 是标记扩展。 当要求转义特性值应为非文本值或非处理程序名称时,通常会实现标记扩展,相对于只在某些类型或属性上放置类型转换器而言,此需求更具有全局性。 XAML 中的所有标记扩展在其特性语法中都使用 { 和 } 字符,XAML 处理器通过这一约定确认标记扩展必须处理该特性。 有关详细信息,请参阅标记扩展和 WPF XAML。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
