Свойство Роли

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

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

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

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

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

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

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