更新：2007 年 11 月
本主题介绍 Microsoft UI 自动化对 Menu 控件类型的支持。本主题描述控件的 Microsoft UI 自动化树结构并为特定的控件方案提供属性和控件模式。
使用菜单控件，可以对那些与命令和事件处理程序相关联的元素以分层方式进行组织。在典型的 Microsoft Windows 应用程序中，菜单栏包含多个菜单按钮（如“文件”、“编辑”和“窗口”），单击每个菜单按钮都显示一个菜单。菜单包含一系列菜单项（如“新建”、“打开”和“关闭”），可以通过展开这些菜单项来显示额外的菜单项，或者通过单击它们来执行特定的操作。
以下几节定义了 Menu 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有列表控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与菜单控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
|
|
菜单控件始终出现在 UI 自动化树的控件视图和内容视图中。菜单控件类型应当出现在其信息所指向的控件下面。UI 自动化客户端必须侦听 MenuOpenedEvent 才能确保以一致的方式获取由菜单控件传达的信息。上下文菜单控件是一个特例，它们显示为桌面的子级。
必需的 UI 自动化属性
下表列出了值或定义与 Menu 控件类型密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。
UI 自动化属性 |
值 |
说明 |
|---|---|---|
不支持 |
菜单控件不要求设置 Name 属性。 |
|
Null |
无标签。 |
|
Menu |
此值对于所有的 UI 框架均相同。 |
|
False |
菜单控件不包括在 UI 自动化树的内容视图中。 |
|
True |
菜单控件始终包括在 UI 自动化树的控件视图中。 |
必需的 UI 自动化控件模式
Menu 控件类型不需要任何控件模式。
必需的 UI 自动化事件
当菜单控件出现在屏幕上时，它们必须引发 MenuOpenedEvent。MenuOpenedEvent 将包括控件的文本。当菜单从屏幕上消失时，它们必须引发 MenuClosedEvent。
下表列出了必须由所有的菜单控件支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。
UI 自动化事件 |
支持/值 |
说明 |
|---|---|---|
必需 |
无 |
|
必需 |
无 |
|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledPropertyproperty-changed 事件。 |
必需 |
无 |
必需 |
无 |
|
必需 |
无 |