.gif "注意事項") 注意事項 |
|---|
這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊，請參閱 Windows Automation API：使用者介面自動化 (英文)。 |
本主題提供 MenuBar 控制項型別之 UI Automation支援的相關資訊。 在 UI Automation中，控制項型別是一組條件；控制項必須符合這些條件才能使用 ControlTypeProperty 屬性。 這些條件包括 UI Automation樹狀結構、UI Automation屬性值和控制項模式的特定方針。
功能表列控制項是實作 MenuBar 控制項型別的控制項範例。 功能表列可讓使用者啟動應用程式中的命令和選項。
下列章節定義 MenuBar 控制項型別的必要 UI Automation樹狀結構、屬性、控制項模式和事件。 UI Automation需求適用於所有的清單控制項，不論是 Windows Presentation Foundation (WPF)、Win32 或 Windows Forms。
這個主題包含下列章節。
- 必要的 UI 自動化樹狀結構
- 必要的 UI 自動化屬性
- 必要的 UI 自動化控制項模式
- 必要的 UI 自動化事件
- 相關主題
必要的 UI 自動化樹狀結構
下表說明與功能表列控制項相關之 UI Automation樹狀目錄的控制項檢視和內容檢視，並說明每個檢視可以包含的內容。 如需 UI Automation樹狀結構的詳細資訊，請參閱 UI 自動化樹狀目錄概觀。
控制項檢視 |
內容檢視 |
|---|---|
MenuBar
|
MenuBar
|
功能表列控制項可在其結構中包含其他控制項，例如編輯控制項和下拉式方塊。 這些其他控制項就是上述控制項和內容檢視中所列的「其他控制項」。
必要的 UI 自動化屬性
下表列出的 UI Automation屬性，其值或定義與功能表列控制項特別相關。 如需 UI Automation屬性的詳細資訊，請參閱 用戶端的 UI 自動化屬性。
UI Automation屬性 |
值 |
備註 |
|---|---|---|
請參閱備註 |
這個屬性所公開的值必須包含其中所有控制項。 |
|
請參閱備註 |
除非應用程式有一個以上的功能表列，否則功能表列控制項不需要名稱。 如果應用程式中有多個功能表列，則應使用此屬性公開可識別名稱，例如「格式」或「大綱」。 |
|
Null |
功能表列控制項永遠不會有標籤。 |
|
MenuBar |
所有 UI 架構的這個值全都相同。 |
|
"menu bar" |
對應 MenuBar 控制項型別的當地語系化字串。 |
|
True |
功能表列控制項一律包含在 UI Automation樹狀目錄的內容檢視中。 |
|
True |
功能表列控制項一律包含在 UI Automation樹狀目錄的控制項檢視中。 |
|
請參閱備註 |
這個屬性的值會根據控制項是否在畫面上可見而定。 |
|
相依項 |
這個屬性會公開功能表列控制項為水平或垂直。 |
|
True |
功能表列控制項可利用鍵盤設定焦點，因為它所包含的控制項可接受鍵盤焦點。 |
|
請參閱備註 |
功能表列控制項不需要「說明」文字。 |
|
Null |
功能表列永遠不會有快速鍵。 |
|
"ALT" |
按 ALT 鍵應會永遠將焦點移至應用程式中的功能表列。 |
必要的 UI 自動化控制項模式
下表列出功能表列控制項支援所需的 UI Automation控制項模式。 如需控制項模式的詳細資訊，請參閱 UI 自動化控制項模式概觀。
控制項模式 |
支援 |
備註 |
|---|---|---|
相依項 |
如果控制項可以展開或摺疊，會實作 IExpandCollapseProvider。 |
|
相依項 |
如果控制項可以停駐到畫面上的不同部分，會實作 IDockProvider。 |
|
相依項 |
如果控制項可以調整大小、旋轉或移動，則必須實作 ITransformProvider。 |
必要的 UI 自動化事件
下表列出所有功能表列控制項支援所需的 UI Automation事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
UI Automation事件 |
支援/值 |
備註 |
|---|---|---|
BoundingRectangleProperty 屬性變更事件。 |
必要項 |
無 |
IsOffscreenProperty 屬性變更事件。 |
必要項 |
無 |
IsEnabledProperty 屬性變更事件。 |
必要項 |
無 |
ExpandCollapseStateProperty 屬性變更事件。 |
相依項 |
無 |
必要項 |
無 |
|
必要項 |
無 |