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

Свойство Role

  • Статья

Свойство role описывает элемент пользовательского интерфейса объекта. Все объекты поддерживают свойство Role.

Во многих случаях роль объекта очевидна. Например, окна имеют роль ROLE_SYSTEM_WINDOW и кнопки push-уведомлений имеют роль ROLE_SYSTEM_PUSHBUTTON.

Свойство роли извлекается путем вызова IAccessible::get_accRole.

Определение роли объекта

Microsoft Active Accessibility предоставляет константы ролей , определенные в oleacc.h, которые определяют общие роли объектов. Рекомендуется, чтобы разработчики серверов использовали эти предопределенные значения ролей. Если возвращается предопределенная константа роли, клиенты используют функцию GetRoleText для получения локализованной строки, описывающей роль.

Для элементов управления анимацией, таких как элемент управления анимацией, отображаемый при копировании файлов, используйте ROLE_SYSTEM_ANIMATION. Графики, которые иногда анимируются, описываются как ROLE_SYSTEM_GRAPHIC с свойствомсостояния, равным STATE_SYSTEM_ANIMATED.

Обратите внимание, что некоторые роли не легко описать. Например, представление большого значка папки позволяет произвольно упорядочить значки, поэтому ее роль может быть описана как ROLE_SYSTEM_GROUPING. Или элемент управления, предоставляющий элементы в фиксированных строках и столбцах, может иметь роль ROLE_SYSTEM_TABLE. Так как роль используется для взаимодействия модели использования с конечным пользователем, важно использовать соответствующую роль. Например, если элемент управления действует как кнопка, используйте ROLE_SYSTEM_PUSHBUTTON.