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 元素，旨在突出顯示和強調父表單中的特定點或區域，并為這些區域提供可選的描述。