Adorner UI管理器

---

立即下载DevExpress WinForms

Adorner UI管理器(AdornerUIManager)提供了一个自定义的adorner层——一个绘制在所有UI元素之上的透明层，这一层可以用来绘制自定义项目和可视化效果。下图展示了一个示例，在这里，装饰层包含红色矩形元素，显示“From”列上方的紧急邮件数量，以及“Mail”按钮和“Send\Receive”页面上方的圆形蓝色元素，显示新邮件的总数。

添加Adorner元素

单击管理器智能标签中的“Edit Elements”链接，并在弹出的设计器中使用元素类型选择器。

您可以添加三种类型的adorner元素：

• 徽章
• 验证提示
• 指南

 所有Adorner元素都使用AdornerElement.TargetElement属性绑定到特定的控件。当设置了 adorner元素的父UI元素时，可以使用Location属性来使装饰器元素相对于其父元素对齐，使用Offset属性将装饰元素从初始位置移动。

要在adorner管理器能够绘制其元素的项上方设置容器控件，请使用AdornerUIManager.Owner属性。

提示：

如果您希望在MDI应用程序中显示子表单的装饰元素，我们建议使用应用程序UI管理器。当子表单被隐藏或重叠时，此管理器会自动隐藏adorner元素，如果应用程序使用，应该手动显示/隐藏adorner元素。

徽章

徽章是Badge类的元素，表示简单的静态信息。

如果没有指定BadgeDefaultProperties.Image属性，则徽章具有圆形，可以通过修改BadgeDefaultProperties.PaintStyle属性来着色。

验证提示

验证提示是ValidationHint类的对象，它根据这些控件的验证状态对目标控件应用特定的视觉效果。验证提示不仅可以连接到DevExpress控件，还可以连接到任何支持验证的标准或第三方控件(参见 MSDN 主题)，下图展示了一个示例。

支持验证的控件有三种可能的验证状态：不确定、已验证和无效。对于每一种状态，验证提示可以为其目标控件应用两种视觉效果：

• 边框：围绕元素画的边框。
• 带有图像、文本和背景的提示。

展开验证提示的ValidationHint.Properties组访问三个相关控件验证状态命名的属性子组(如下图所示)。每个子组存储一个ValidationHintBaseDefaultProperties对象，该对象提供对管理此特定验证状态的提示行为的属性的访问。例如，您可以使用ValidationHintBaseDefaultProperties.ShowBorder和ValidationHintBaseDefaultProperties.ShowHint属性来选择是否要显示验证边界、提示或不显示它们(默认情况下，两种效果都显示)。在上图中，“City”数据字段的验证提示仅显示有效状态的边框，而不确定的“state”和无效的“ZIP”编辑器同时显示边框和提示。

同样的方法也用于visual hint appearances，ValidationHint.Appearances 属性提供了对三个AppearanceObject的访问，它们允许您分别为每个控件验证状态定制效果。默认情况下，提示为不确定控件绘制蓝色边框，为已验证控件绘制绿色边框，为无效控件绘制红色边框。

默认情况下，在提示的Appearances组中设置的背景色将被忽略。使用ValidationHintBaseProperties.ShowBackgroundMode和ValidationHintBaseDefaultProperties.ShowBackgroundMode属性，您可以指定这种颜色是否应该应用于提示，目标UI元素或两者。下图展示了通过将这些属性设置为不同的值可以获得的不同外观。请注意，如果选择将背景颜色应用于目标UI元素，请使用半透明的ARGB颜色而不是纯RGB颜色。

要一次对所有验证提示应用相同的行为和外观设置，请利用组件的AdornerUIManager.ValidationHintProperties和AdornerUIManager.ValidationHintAppearances属性，这些全局设置的优先级低于单个验证提示的相应设置。

您还可以利用ValidationHintDefaultProperties.State属性显式地将验证提示切换到所需的验证状态。

指南

参考线是 adorner 元素，旨在突出显示和强调父表单中的特定点或区域，并为这些区域提供可选的描述。