对象角色

本主题介绍用于描述应用程序中各种 UI 对象的角色的常量值。 角色常量在 Oleacc.h 文件中定义。

应仅使用此处列出的角色常量;不要添加自定义角色或未预定义的角色。

使用这些对象角色之前，客户端应用程序的开发人员必须使用 检查 工具来验证 UI 元素是否正在使用对象角色。

若要检索对象的角色，客户端调用 IAccessible：：get_accRole 方法，该方法必须返回表中所述的值之一。 若要检索描述对象角色的本地化字符串，客户端使用角色值调用 GetRoleText 函数。 角色值的本地化字符串位于 oleaccrc.dll 文件中。

返回的常量	说明
ROLE_SYSTEM_ALERT	对象表示应通知用户的警报或条件。 此角色仅用于表示警报但不与其他用户界面元素关联的对象，例如消息框、图形、文本或声音。
ROLE_SYSTEM_ANIMATION	对象表示其内容随时间变化的动画控件，例如显示一系列位图帧的控件。 当复制文件或执行一些其他耗时的任务时，将显示动画控件。
ROLE_SYSTEM_APPLICATION	对象表示应用程序的main窗口。
ROLE_SYSTEM_BORDER	对象表示窗口边框。 整个边框由单个对象表示，而不是由每一侧的单独对象表示。
ROLE_SYSTEM_BUTTONDROPDOWN	对象表示一个用于展开项列表的按钮。
ROLE_SYSTEM_BUTTONDROPDOWNGRID	对象表示展开网格的按钮。
ROLE_SYSTEM_BUTTONMENU	对象表示展开菜单的按钮。
ROLE_SYSTEM_CARET	对象表示系统插入符号。
ROLE_SYSTEM_CELL	对象表示表中的单元格。
ROLE_SYSTEM_CHARACTER	对象表示一个类似于卡通的图形对象，例如 Microsoft Office Assistant，该对象显示为向应用程序的用户提供帮助。
ROLE_SYSTEM_CHART	对象表示用于绘制数据的图形图像。
ROLE_SYSTEM_CHECKBUTTON	对象表示检查框控件：一个独立于其他选项选择或清除的选项。
ROLE_SYSTEM_CLIENT	对象表示窗口的工作区。 如果存在有关 UI 元素角色的问题，Microsoft Active Accessibility 将此角色用作默认值。
ROLE_SYSTEM_CLOCK	对象表示显示时间的控件。
ROLE_SYSTEM_COLUMN	对象表示表中单元格的列。
ROLE_SYSTEM_COLUMNHEADER	对象表示列标题，为表中的列提供可视标签。
ROLE_SYSTEM_COMBOBOX	对象表示一个组合框：一个编辑控件，其中包含提供一组预定义选项的关联列表框。
ROLE_SYSTEM_CURSOR	对象表示系统的鼠标指针。
ROLE_SYSTEM_DIAGRAM	对象表示用于绘制数据的图形图像。
ROLE_SYSTEM_DIAL	对象表示拨号盘或旋钮。
ROLE_SYSTEM_DIALOG	对象表示对话框或消息框。
ROLE_SYSTEM_DOCUMENT	对象表示文档窗口。 文档窗口始终包含在应用程序窗口中。 此角色仅适用于 MDI 窗口，并引用包含 MDI 标题栏的对象。
ROLE_SYSTEM_DROPLIST	对象表示日历控件 SysDateTimePick32。 Microsoft Active Accessibility 运行时组件使用此角色来指示已找到日期或日历控件。
ROLE_SYSTEM_EQUATION	对象表示数学公式。
ROLE_SYSTEM_GRAPHIC	对象表示图片。
ROLE_SYSTEM_GRIP	对象表示允许用户操作用户界面元素（如窗口）的特殊鼠标指针。 其中一个示例涉及通过拖动窗口的右下角来调整窗口的大小。
ROLE_SYSTEM_GROUPING	对象以逻辑方式对其他对象进行分组。 分组对象与它包含的对象之间并不总是存在父子关系。
ROLE_SYSTEM_HELPBALLOON	对象以工具提示或帮助气球的形式显示帮助主题。
ROLE_SYSTEM_HOTKEYFIELD	对象表示一个键盘快捷方式字段，该字段允许用户输入组合键或键击序列。
ROLE_SYSTEM_INDICATOR	对象表示指向当前项的指示器，例如指针图形。
ROLE_SYSTEM_IPADDRESS	对象表示为 IP 地址设计的编辑控件。 编辑控件分为多个部分，每个部分用于 IP 地址的特定部分。
ROLE_SYSTEM_LINK	对象表示指向其他内容的链接。 该对象的外观可能像文本或图形，但其操作像按钮。
ROLE_SYSTEM_LIST	对象表示列表框，允许用户选择一个或多个项。
ROLE_SYSTEM_LISTITEM	对象表示列表框或组合框、下拉列表框或下拉组合框的列表部分中的项。
ROLE_SYSTEM_MENUBAR	对象表示位于窗口标题栏下方的菜单栏 () 用户从中选择菜单。
ROLE_SYSTEM_MENUITEM	对象表示一个菜单项：一个菜单项，用户可以选择执行命令、选择一个选项或显示另一个菜单。 从功能上讲，菜单项相当于一个按钮、一个单选按钮、一个检查框或一个菜单。
ROLE_SYSTEM_MENUPOPUP	对象表示一个菜单：选项列表，每个选项都有一个特定的操作。 所有菜单类型都必须具有角色，包括从菜单栏中选择时显示的下拉菜单;和快捷菜单，通过单击鼠标右键显示。
ROLE_SYSTEM_OUTLINE	对象表示显示分层列表并允许用户展开和折叠分支的大纲或树结构（如树视图控件）。
ROLE_SYSTEM_OUTLINEBUTTON	对象表示像大纲项一样导航的项。 向上键和向下键用于在大纲中导航。 但是，在按下空格键或 ENTER 键且项具有焦点时，这些菜单不是展开和折叠，而是在按下空格键或 ENTER 键时展开或折叠。
ROLE_SYSTEM_OUTLINEITEM	对象表示大纲或树结构中的项。
ROLE_SYSTEM_PAGETAB	对象表示页面选项卡。页面选项卡控件的唯一子级是具有关联页面内容的 ROLE_SYSTEM_GROUPING 对象。
ROLE_SYSTEM_PAGETABLIST	对象表示页选项卡控件的容器。
ROLE_SYSTEM_PANE	对象表示框架或文档窗口中的窗格。 用户可以在窗格之间以及当前窗格的内容中定位，但不能在不同窗格中的项之间定位。 因此，窗格表示低于框架或文档窗口但高于单个控件的分组级别。 用户通过按 TAB、F6、或 CTRL + TAB 在窗格间导航，具体取决于上下文。
ROLE_SYSTEM_PROGRESSBAR	对象表示一个进度栏，该进度栏动态显示正在进行的操作已完成多少。 此控件不需要用户输入。
ROLE_SYSTEM_PROPERTYPAGE	对象表示属性表。
ROLE_SYSTEM_PUSHBUTTON	对象表示一键控件。
ROLE_SYSTEM_RADIOBUTTON	对象表示以前 (选项按钮，即单选按钮) 。 它是一组互斥选项之一。 共享同一父级且具有此属性的所有对象都假定为单个互斥组的一部分。 若要将这些对象划分为单独的组，请使用 ROLE_SYSTEM_GROUPING 对象。
ROLE_SYSTEM_ROW	对象表示表中的一行单元格。
ROLE_SYSTEM_ROWHEADER	对象表示一个行标题，该行为表行提供可视标签。
ROLE_SYSTEM_SCROLLBAR	对象表示垂直或水平滚动条，该滚动条是工作区的一部分或在控件中使用。
ROLE_SYSTEM_SEPARATOR	对象用于直观地将空间划分为两个区域。 分隔符对象的示例包括分隔符菜单项和分隔窗口中拆分窗格的条。
ROLE_SYSTEM_SLIDER	对象表示一个滑块，该滑块允许用户在最小值和最大值之间以特定增量调整设置。
ROLE_SYSTEM_SOUND	对象表示与各种系统事件关联的系统声音。
ROLE_SYSTEM_SPINBUTTON	对象表示一个旋转框，它是一个控件，允许用户递增或递减与旋转框关联的单独“buddy”控件中显示的值。
ROLE_SYSTEM_SPLITBUTTON	对象表示工具栏上的按钮，该按钮具有直接相邻的下拉列表图标。
ROLE_SYSTEM_STATICTEXT	对象表示只读文本，例如对话框中其他控件或指令的标签。 无法修改或选择静态文本。
ROLE_SYSTEM_STATUSBAR	对象表示状态栏，该状态栏是窗口底部的一个区域，它显示有关当前操作、应用程序状态或所选对象的信息。 状态栏有多个字段，这些字段显示不同类型的信息。
ROLE_SYSTEM_TABLE	对象表示一个表，其中包含行和单元格的列，以及（可选）行标题和列标题。
ROLE_SYSTEM_TEXT	对象表示允许编辑或指定为只读的可选文本。
ROLE_SYSTEM_TITLEBAR	对象表示窗口的标题或描述文字栏。
ROLE_SYSTEM_TOOLBAR	对象表示工具栏，工具栏是一组控件，可轻松访问常用功能。
ROLE_SYSTEM_TOOLTIP	对象表示提供有用提示的工具提示。
ROLE_SYSTEM_WHITESPACE	对象表示其他对象之间的空白。
ROLE_SYSTEM_WINDOW	对象表示窗口框架，其中包含子对象，例如标题栏、客户端和窗口的其他对象。

要求

要求	值
标头	Oleacc.h