使用存储库项
| 相关视频 | |
|---|---|
| WinForms的新可视化样式构建器介绍 在本次录制的网络研讨会中，您将学习如何使用最新版本的Visual Style Builder构建主题。您还将了解什么是主题存储库，以及它们如何使创建主题更容易。(运行时:42:56) |
 |
概述
存储库和存储库项是Visual Style Builder中的主要概念。这些项允许您根据每个元素快速应用属性设置，由于存储库项的设置是重用的，因此生成的XML文件的大小和反序列化它们所需的时间都得到了优化。Visual Style Builder允许通过一系列编辑器和用户体验工具(如拖拽到ItemState、实时下拉所有可用的存储库项等)进行直观而直接的存储库管理。
存储库项目类型
每个存储库都包含可以在主题中重用的项。当前支持的存储库项类型如下所示:
填满
边境
文本
图像
箭头
不同的存储库项类型映射到不同类型的元素。例如，填充存储库项只能与FillPrimitive类的实例相关联。按照同样的逻辑，Border存储库项只适用于BorderPrimitive元素，Arrow存储库项只适用于ArrowPrimitive实例。图像和文本存储库项在支持的元素方面略有不同。例如，文本存储库项可以应用于TextPrimitive和VisualElement实例。图像存储库项可以应用于ImagePrimitive实例和支持图像的VisualElements。一般来说，应用存储库项时不应该有任何顾虑，因为Visual Style Builder会根据当前样式化的元素自动筛选可用的存储库项。
您还可以为当前加载的存储库创建新的存储库项。每个存储库项目类型都有相应的编辑器。在保存新创建的存储库项之前，Visual Style Builder将检查其键是否惟一，如果不是，则提示您使用惟一值更改键。
存储库项目类型和LightVisualElement
LightVisualElement是一种特殊类型的基元类，它支持所有其他基元的功能，而无需构建元素树。换句话说，LightVisualElement自己绘制它的填充、边框、文本和图像。因此，LightVisualElement是支持所有存储库项目类型(不包括箭头类型)的元素类型，因此，当在Visual Style Builder中编辑这些元素时，存储库将被适当筛选以显示所有可用的存储库项目。
理解不同原语(Border, Fill, Arrow等)和LightVisualElement类型之间的区别是很重要的。LightVisualElement支持多种类型的存储库项，因为它基本上封装了边框、填充、文本和图像原语的功能。因此，当你在元素列表中选择一个元素，它实际上是LightVisualElement类的实例(在RadGridView, RadScheduler和RadCalendar中使用)，你只需要分配给它不同类型的存储库，以便根据你的需求来设置它的样式，也就是说，你可以同时关联一个边界存储库项，填充和图像，它的外观将被适当调整(网格，调度程序或日历的单元格)。这与由不同原语组成的元素(如border、fill和image)不同。在本例中，您需要为不同的状态分别从Elements网格中选择每个原语并设置其样式(RadButtonElement及其子元素就是一个很好的例子)。
将存储库项与元素和状态相关联
你可以很容易地将存储库项与特定状态下的给定元素关联起来，方法是将存储库项从存储库中拖出，并将其拖放到有问题的状态上:
上图显示了名称为ButtonNormalFill的存储库项如何与默认状态(RadButtonElement)的RadButton控件的ButtonFill元素相关联。
将存储库项与给定状态的元素关联的另一种方法是使用状态的元素可用的存储库项弹出窗口，点击状态可视化表示右侧的下拉按钮显示:
的可用的存储库项弹出窗口包含可以与当前元素的选定状态相关联的存储库项列表。与可视化状态相关联的存储库项以红色突出显示，并在初始时进行检查。
删除存储库项关联
根据您是想删除所有存储库项关联，还是只是删除特定的一个，您可以采取两个方向:
- 按下“Remove All Repository Item Associations”按钮，该按钮在每个状态下都会显示在下拉按钮旁边
- 打开' Available Repository Items '弹出框，单击Show Only Applied Repositories复选框，只查看与此状态存储库的关联，取消选中存储库项以删除与它们的关联:
编辑存储库项
你可以很容易地编辑一个存储库项目，从“编辑存储库项目”按钮为列表中的每个存储库项目打开它的编辑器，如下图所示:
“编辑存储库项”对话框将自动调整为显示特定存储库项类型的特定控件。但是，通常情况下，对话框为您提供了为存储库项定义键和名称的可能性，以及定义存储库项的属性设置是否为动画。您还可以选择修改项的设置并保存一个新的存储库项，而不覆盖当前的存储库项。在对话框的右侧有一个属性网格，其中显示了可以为存储库项修改的所有属性。粗体显示的属性有在存储库项中定义的值，而其他属性有默认值:
粗体显示的属性具有在存储库项中定义的值，而其他属性具有默认值。
在定义存储库项键时，您应该确保该键是唯一的，以便创建/保存该项。
的动画状态转换复选框确定当项关联的元素的状态被激活时，存储库项的属性值是否将被动画化。例如，上面对话框中显示的存储库项的所有颜色属性，将从相应元素状态出现时的值变为右边属性网格中定义的值。编辑存储库项目后，您可以通过按取消修改取消，按保存修改好吧，或按“”保存新存储库项另存为新。的另存为新按钮仅在已存在的存储库项打开以进行编辑时可见。
在更改存储库项的键时，重要的是要知道使用此存储库项的每个属性设置组(样式表中的一组样式设置)都应该更新以引用新键。Visual Style Builder允许重命名存储库项的键，并更新当前所有属性设置组的引用加载。但是，假设您创建了两个使用相同存储库的主题并保存它们。之后，通过选择存储库和保存的一些文件(不是全部)重新打开它们。如果您现在重命名存储库项的键，Visual Style Builder将更新已加载样式表中的所有引用，但那些未加载的仍将继续使用旧键，这将破坏样式表。
删除存储库项
您可以通过点击位于“编辑”按钮旁边的红色“删除”按钮，轻松地从当前加载的存储库中删除存储库项。系统将要求您确认操作，如果您确认了，则存储库项将从存储库中删除。对该存储库项的所有引用也将被删除。