UI 自动化对 Menu 控件类型的支持

注意
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。

本主题介绍 Microsoft UI Automation对 Menu 控件类型的支持。 本主题描述控件的 Microsoft UI Automation树结构并为特定的控件方案提供属性和控件模式。

使用菜单控件，可以对那些与命令和事件处理程序相关联的元素以分层方式进行组织。 在典型的 Microsoft Windows 应用程序中，菜单栏包含多个菜单按钮（如**“文件”、“编辑”和“窗口”），单击每个菜单按钮都显示一个菜单。 菜单包含一系列菜单项（如“新建”、“打开”和“关闭”**），可以通过展开这些菜单项来显示额外的菜单项，或者通过单击它们来执行特定的操作。

以下几节定义了 Menu 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation的要求适用于所有列表控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms。

本主题包括下列各节。

• 必需的 UI 自动化树结构
• 必需的 UI 自动化属性
• 必需的 UI 自动化控件模式
• 必需的 UI 自动化事件
• 相关主题

必需的 UI 自动化树结构

下表描述了与菜单控件有关的 UI Automation树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI Automation树的更多信息，请参见 UI 自动化树概述。

菜单控件始终出现在 UI Automation树的控件视图和内容视图中。 菜单控件类型应当出现在其信息所指向的控件下面。 UI 自动化客户端必须侦听 MenuOpenedEvent 才能确保以一致的方式获取由菜单控件传达的信息。 上下文菜单控件是一个特例， 它们显示为桌面的子级。

必需的 UI 自动化属性

下表列出了值或定义与 Menu 控件类型密切相关的 UI Automation属性。 有关 UI Automation属性的更多信息，请参见 客户端的 UI 自动化属性。

必需的 UI 自动化控件模式

Menu 控件类型不需要任何控件模式。

必需的 UI 自动化事件

当菜单控件出现在屏幕上时，它们必须引发 MenuOpenedEvent。 MenuOpenedEvent 将包括控件的文本。 当菜单从屏幕上消失时，它们必须引发 MenuClosedEvent。

下表列出了必须由所有的菜单控件支持的 UI Automation事件。 有关事件的更多信息，请参见 UI 自动化事件概述。

请参见

参考

Menu

概念

UI 自动化控件模式概述

UI 自动化控件类型概述

UI 自动化概述