大网数据广告活动
.NET 与 C# 开发

可样式化控件的设计准则

· 52CE 我爱测

本文档概述在设计可方便地样式化和模板化的控件时需要考虑的一组最佳做法。 在为内置的 !INCLUDE[TLA2#tla_winclient] 控件集处理主题控件样式时,我们通过大量试验和错误总结出了这组最佳做法。 我们已经认识到,成功的样式设置不只是设计完善的对象模型的功能,也是样式本身的功能。 本文档面向控件作者,而不是样式作者。

本文档概述在设计可方便地样式化和模板化的控件时需要考虑的一组最佳做法。 在为内置的 WPF 控件集处理主题控件样式时,我们通过大量试验和错误总结出了这组最佳做法。 我们已经认识到,成功的样式设置不只是设计完善的对象模型的功能,也是样式本身的功能。 本文档面向控件作者,而不是样式作者。

术语

“样式设置和模板化”是一组技术,控件作者可以通过该组技术将控件的可视化特性延迟到控件的样式和模板。 这组技术包括:

  • 样式(包括属性资源库、触发器和演示图板)。

  • 资源。

  • 控件模板。

  • 数据模板。

有关样式设置和模板化简介,请参阅样式设置和模板化。

在开始之前:了解您的控件

在开始阅读这些准则之前,请务必了解并定义了控件的常见用法。 样式设置公开一组通常不受约束的可能性。 旨在由许多开发人员在许多应用程序中广泛使用的控件面临着如下挑战:可以使用样式设置对控件的可视化外观进行广泛更改。 实际上,带样式的控件甚至可能并非控件作者的本意。 由于样式设置在本质上可以提供无限的灵活性,因此可以使用“常见用法”这一概念来帮助你限制自己的决定。

若要了解控件的常见用法,最好考虑控件的价值主张。 你的控件能够在表中提供哪些无法由其他控件提供的内容? 常见用法并不表示任何特定的可视化外观,而是表示控件的基本原理和一组有关其用法的合理预期。 了解到这一点,就可以对控件在一般情况下的撰写模型和样式定义行为进行一些假设。 情况下xref:System.Windows.Controls.ComboBox,例如,了解常见的使用情况不会深入分析任何有关某个特定xref:System.Windows.Controls.ComboBox具有圆的角,但能够让你深入了解这一事实,xref:System.Windows.Controls.ComboBox可能需要一个弹出窗口和切换是否处于打开状态的一些方法。

通用准则

主题注意事项

  • 主题样式应尝试在所有主题中具有一致的属性语义,但不保证能够实现这一点。 作为控件文档的一部分,控件应当具有一个描述其属性语义(即控件属性的“含义”)的文档。 例如,xref:System.Windows.Controls.ComboBox控件应当定义的含义xref:System.Windows.Controls.Control.Background*属性内的xref:System.Windows.Controls.ComboBox。 控件的默认样式应当尝试遵循在其文档中的所有主题中定义的语义。 另一方面,控件用户应当注意属性语义可能因主题而异。 在某些情况下,给定的属性在由特定主题所需的可视化约束下可能无法表示。 (例如,对于许多控件来说,传统主题没有可以向其应用 Thickness 的边框。)

  • 主题样式不需要在所有主题中具有一致的触发器语义。 由控件样式通过触发器或动画公开的行为可能因主题而异。 控件用户应当注意到,控件不必使用同一个机制在所有主题中实现特定的行为。 例如,一个主题可以使用动画来表示悬停行为,而另一个主题则可以使用触发器。 这可能会导致自定义控件上的行为保留出现不一致。 (例如,如果控件的悬停状态使用触发器来表示,则更改背景属性可能不会影响该状态。 但是,如果悬停状态使用动画来实现,则更改背景属性可能会不可挽回地中断动画,从而中断状态过渡。)

  • 主题样式不需要在所有主题中具有一致的“布局”语义。 例如,默认的样式不需要保证控件将在所有主题中占用同样的大小,也不需要保证控件将在所有主题中具有同样的内容边距/空白。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。