Роли объектов

В этом разделе описываются значения констант, используемые для описания ролей различных объектов пользовательского интерфейса в приложении. Константы роли определяются в файле Oleacc.h.

Следует использовать только перечисленные здесь константы ролей; не добавлять настраиваемые роли или роли, которые не являются предопределенными.

Перед использованием этих ролей объектов разработчики клиентских приложений должны использовать средство Проверка , чтобы убедиться, что роли объектов используются элементами пользовательского интерфейса.

Чтобы получить роль объекта, клиенты вызывают метод IAccess::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	Объект представляет элемент управления проверка box: параметр, который выбирается или очищается независимо от других параметров.
ROLE_SYSTEM_CLIENT	Объект представляет клиентскую область окна. 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	Объект представляет элемент управления calendar 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	Объект представляет элемент, который перемещается как элемент структуры. Клавиши СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ используются для навигации по структуре. Однако вместо развертывания и сворачивания при нажатии клавиш СТРЕЛКА ВЛЕВО и СТРЕЛКА ВПРАВО эти меню разворачиваются или сворачиваются при нажатии клавиши ПРОБЕЛ или ВВОД и фокусе элемента.
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	Объект представляет элемент управления push-кнопкой.
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	Объект представляет панель инструментов, которая представляет собой группу элементов управления, которая обеспечивает простой доступ к часто используемым функциям.
Tool barROLE_SYSTEM_TOOLTIP	Объект представляет подсказку, которая предоставляет полезные подсказки.
ROLE_SYSTEM_WHITESPACE	Объект представляет пустое пространство между другими объектами.
ROLE_SYSTEM_WINDOW	Объект представляет рамку окна, которая содержит дочерние объекты, такие как строка заголовка, клиент и другие объекты окна.

Требования

Требование	Значение
Заголовок	Oleacc.h