对象角色

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

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

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

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

一直	说明
ROLE_SYSTEM_ALERT	该对象表示应通知用户的警报或条件。 此角色仅用于体现警报但与另一个用户界面元素（如消息框、图形、文本或声音）关联的对象。
ROLE_SYSTEM_ANIMATION	该对象表示一个动画控件，其内容随时间变化，例如显示一系列位图帧的控件。 复制文件时或执行一些其他耗时的任务时，将显示动画控件。
ROLE_SYSTEM_APPLICATION	该对象表示应用程序的主窗口。
ROLE_SYSTEM_BORDER	对象表示窗口边框。 整个边框由单个对象表示，而不是由每个侧的单独对象表示。
ROLE_SYSTEM_BUTTONDROPDOWN	该对象表示展开项列表的按钮。
ROLE_SYSTEM_BUTTONDROPDOWNGRID	该对象表示展开网格的按钮。
ROLE_SYSTEM_BUTTONMENU	该对象表示展开菜单的按钮。
ROLE_SYSTEM_CARET	该对象表示系统插入符号。
ROLE_SYSTEM_CELL	该对象表示表中的单元格。
ROLE_SYSTEM_CHARACTER	该对象表示卡通式图形对象，如Microsoft Office助手，该对象显示为向应用程序用户提供帮助。
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 键且项目具有焦点时展开或折叠。
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	该对象表示一个旋转框，它是一个控件，允许用户递增或递减与旋转框关联的单独“好友”控件中显示的值。
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	该对象表示窗口框架，该框架包含标题栏、客户端和其他窗口对象的子对象。

要求

要求	Value
标头	Oleacc.h