Adorner UI管理器

---

立即下載DevExpress WinForms

Adorner UI管理器(AdornerUIManager)提供了一個(gè)自定義的adorner層——一個(gè)繪制在所有UI元素之上的透明層，這一層可以用來繪制自定義項(xiàng)目和可視化效果。下圖展示了一個(gè)示例，在這里，裝飾層包含紅色矩形元素，顯示“From”列上方的緊急郵件數(shù)量，以及“Mail”按鈕和“Send\Receive”頁面上方的圓形藍(lán)色元素，顯示新郵件的總數(shù)。

添加Adorner元素

單擊管理器智能標(biāo)簽中的“Edit Elements”鏈接，并在彈出的設(shè)計(jì)器中使用元素類型選擇器。

您可以添加三種類型的adorner元素：

• 徽章
• 驗(yàn)證提示
• 指南

所有Adorner元素都使用AdornerElement.TargetElement屬性綁定到特定的控件。當(dāng)設(shè)置了 adorner元素的父UI元素時(shí)，可以使用Location屬性來使裝飾器元素相對(duì)于其父元素對(duì)齊，使用Offset屬性將裝飾元素從初始位置移動(dòng)。

要在adorner管理器能夠繪制其元素的項(xiàng)上方設(shè)置容器控件，請(qǐng)使用AdornerUIManager.Owner屬性。

提示：

如果您希望在MDI應(yīng)用程序中顯示子表單的裝飾元素，我們建議使用應(yīng)用程序UI管理器。當(dāng)子表單被隱藏或重疊時(shí)，此管理器會(huì)自動(dòng)隱藏adorner元素，如果應(yīng)用程序使用 native MDI forms ，應(yīng)該手動(dòng)顯示/隱藏adorner元素。

徽章

徽章是Badge類的元素，表示簡單的靜態(tài)信息。

如果沒有指定BadgeDefaultProperties.Image屬性，則徽章具有圓形，可以通過修改BadgeDefaultProperties.PaintStyle屬性來著色。

驗(yàn)證提示

驗(yàn)證提示是ValidationHint類的對(duì)象，它根據(jù)這些控件的驗(yàn)證狀態(tài)對(duì)目標(biāo)控件應(yīng)用特定的視覺效果。驗(yàn)證提示不僅可以連接到DevExpress控件，還可以連接到任何支持驗(yàn)證的標(biāo)準(zhǔn)或第三方控件(參見 Control.Validating MSDN 主題)，下圖展示了一個(gè)示例。

支持驗(yàn)證的控件有三種可能的驗(yàn)證狀態(tài)：不確定、已驗(yàn)證和無效。對(duì)于每一種狀態(tài)，驗(yàn)證提示可以為其目標(biāo)控件應(yīng)用兩種視覺效果：

• 邊框：圍繞元素畫的邊框。
• 帶有圖像、文本和背景的提示。

展開驗(yàn)證提示的ValidationHint.Properties組訪問三個(gè)相關(guān)控件驗(yàn)證狀態(tài)命名的屬性子組(如下圖所示)。每個(gè)子組存儲(chǔ)一個(gè)ValidationHintBaseDefaultProperties對(duì)象，該對(duì)象提供對(duì)管理此特定驗(yàn)證狀態(tài)的提示行為的屬性的訪問。例如，您可以使用ValidationHintBaseDefaultProperties.ShowBorder和ValidationHintBaseDefaultProperties.ShowHint屬性來選擇是否要顯示驗(yàn)證邊界、提示或不顯示它們(默認(rèn)情況下，兩種效果都顯示)。在上圖中，“City”數(shù)據(jù)字段的驗(yàn)證提示僅顯示有效狀態(tài)的邊框，而不確定的“state”和無效的“ZIP”編輯器同時(shí)顯示邊框和提示。

同樣的方法也用于visual hint appearances，ValidationHint.Appearances 屬性提供了對(duì)三個(gè)AppearanceObject的訪問，它們?cè)试S您分別為每個(gè)控件驗(yàn)證狀態(tài)定制效果。默認(rèn)情況下，提示為不確定控件繪制藍(lán)色邊框，為已驗(yàn)證控件繪制綠色邊框，為無效控件繪制紅色邊框。

默認(rèn)情況下，在提示的Appearances組中設(shè)置的背景色將被忽略。使用ValidationHintBaseProperties.ShowBackgroundMode和ValidationHintBaseDefaultProperties.ShowBackgroundMode屬性，您可以指定這種顏色是否應(yīng)該應(yīng)用于提示，目標(biāo)UI元素或兩者。下圖展示了通過將這些屬性設(shè)置為不同的值可以獲得的不同外觀。請(qǐng)注意，如果選擇將背景顏色應(yīng)用于目標(biāo)UI元素，請(qǐng)使用半透明的ARGB顏色而不是純RGB顏色。

要一次對(duì)所有驗(yàn)證提示應(yīng)用相同的行為和外觀設(shè)置，請(qǐng)利用組件的AdornerUIManager.ValidationHintProperties和AdornerUIManager.ValidationHintAppearances屬性，這些全局設(shè)置的優(yōu)先級(jí)低于單個(gè)驗(yàn)證提示的相應(yīng)設(shè)置。

您還可以利用ValidationHintDefaultProperties.State屬性顯式地將驗(yàn)證提示切換到所需的驗(yàn)證狀態(tài)。

指南

參考線是 adorner 元素，旨在突出顯示和強(qiáng)調(diào)父表單中的特定點(diǎn)或區(qū)域，并為這些區(qū)域提供可選的描述。