Поделиться через


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

В этом разделе описываются значения констант, используемые для описания ролей различных объектов пользовательского интерфейса в приложении. Константы роли определяются в файле 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