Adorner指南

---

立即下載DevExpress WinForms

指南是裝飾元素，旨在突出和強調父表單中的特定點或區域，并為這些區域提供可選描述。 在下面的動畫中，五種不同的指南將自動一一顯示， 這次交互式導覽突出顯示了主要的應用程序區域，并指定了它們所基于的DevExpress控件。

指南是Guide類的對象，與其他Adorner UI Manager子項相同，每個指南都有一個目標——分配給該指南的AdornerElement.TargetElement屬性的UI元素。 要創建和修改指南，請單擊組件的智能標記上的Choose Elements鏈接，然后使用調用的Collection Editor對話框。

Demo： Guides（需要安裝16.2版或更高版本的DevExpress Demo Center）

共同概念

最初，所有adorner指南都在運行時隱藏，要打開這些指南，請將AdornerUIManager.ShowGuides屬性設置為true，完成此操作后，半透明的灰色層將使您的整個表單變暗（用戶控件）。 選定的引導線通過用透明顏色繪制其目標元素的區域在此基礎層中切出一個“hole”，這將為目標區域創建突出顯示效果，當前未選擇的參考線僅顯示其邊框。下圖說明了一個示例。

最終用戶可以單擊指南來選擇它們，要隱藏所有參考線及其下方的灰色層，最終用戶必須按Escape鍵。 請注意顯示指南時，最終用戶不能使用表單的任何UI元素，因為所有mouse事件都被 adorner layer攔截。

要循環瀏覽現有指南，請使用管理器的AdornerUIManager.SelectNext和AdornerUIManager.SelectPrev 方法，這些方法根據其TabIndex屬性值顯示指南。AdornerUIManager.SelectElement 方法可讓您更加具體，并直接導航到所需的指南。

彈出式窗口

如果指南的GuideDefaultProperties.AllowFlyoutPanel 屬性不等于DefaultBoolean.False，則每個指南在激活時都會顯示彈出面板， 最初此面板為空，如下所示。

要為任何現有指南填充彈出面板，請處理管理器的AdornerUIManager.QueryGuideFlyoutControl 事件， 此事件提供e.SelectedElement屬性并標識為其彈出指南的面板。 e.Control屬性接受任何控件，這些控件將顯示在所需指南的彈出面板中。 下面的代碼示例說明了如何使用HTML格式的文本字符串填充指南彈出窗口。

C#：

void adornerUIManager1_QueryGuideFlyoutControl(object sender, QueryGuideFlyoutControlEventArgs e) {
if(e.SelectedElement.TargetElement == navBarControl) e.Control = new LabelControl() {
AllowHtmlString = true,
Width = 350,
AutoSizeMode = LabelAutoSizeMode.Vertical,
Padding = new Padding(20),
Text = "<b>Navigation Bar</b><br>" +
"A side navigation control that supports integration with Office Navigation Bar<br><br>" +
"Shows navigation options for your currently selected module"
};
}

VB.NET：

Private Sub adornerUIManager1_QueryGuideFlyoutControl(ByVal sender As Object, ByVal e As QueryGuideFlyoutControlEventArgs)
If e.SelectedElement.TargetElement = navBarControl Then
e.Control = New LabelControl() With {
.AllowHtmlString = True,
.Width = 350,
.AutoSizeMode = LabelAutoSizeMode.Vertical,
.Padding = New Padding(20),
.Text = "<b>Navigation Bar</b><br>" & "A side navigation control that supports integration with Office Navigation Bar<br><br>" & "Shows navigation options for your currently selected module"}
End If
End Sub

彈出面板可以承載更復雜的內容，而不是簡單的標簽。 在下圖上，彈出按鈕顯示三個按鈕和一個WindowsUI Button Panel。

彈出面板的大小會自動調整來適合其內容，要設置彈出顯示位置，請使用GuideDefaultProperties.FlyoutLocation屬性。

外觀設置

您可以自定義任何引導元素的外觀以及外部圖層的外觀。 要重新繪制參考線（其邊界和內部區域），請訪問Guide.Appearances（對于單個參考線）和AdornerUIManager.GuideAppearances（對于所有參考線）組中的屬性，個別指南外觀設置會覆蓋相對的全局設置。下圖顯示了自定義指南。

重要提示：

在為參考線設置自定義背景色時，請使用四位數的ARGB值分配半透明色。

C#：

guide1.Appearances.Selected.BackColor = Color.FromArgb(100, 150, 0, 0);

VB.NET：

guide1.Appearances.Selected.BackColor = Color.FromArgb(100, 150, 0, 0)

可以使用分配給GuideAppearances.Layer屬性的AppearanceObject繪制外部層。 與自定義參考色相同，在設置自定義圖層背景時，請使用ARGB值代替純色。

最后，要自定義指南彈出面板，請使用AdornerUIManager.GuideProperties組。 在這里，可以利用GuideDefaultProperties.FlyoutBackColor和GuideDefaultProperties.FlyoutBorderColor 屬性來應用自定義外觀設置， GuideDefaultProperties.FlyoutOpacity屬性使您可以創建半透明的彈出面板，下圖說明了具有海軍藍邊界和天藍色背景的非透明引導彈出。