Propriedade Role

A propriedade Role descreve o elemento da interface do usuário de um objeto. Todos os objetos suportam a propriedade Role.

Em muitos casos, o papel do objeto é óbvio. Por exemplo, as janelas têm a função ROLE_SYSTEM_WINDOW e os botões de pressão têm a função ROLE_SYSTEM_PUSHBUTTON.

A propriedade Role é recuperada chamando IAccessible::get_accRole.

Identificando a função de um objeto

O Microsoft Ative Accessibility fornece constantes de função , definidas em oleacc.h, que identificam funções de objeto comuns. É recomendável que os desenvolvedores de servidor usem esses valores de função predefinidos. Se uma constante de função predefinida for retornada, os clientes usarão a função GetRoleText para recuperar uma cadeia de caracteres localizada que descreve a função.

Para controles de animação, como o controle de animação exibido ao copiar arquivos, use ROLE_SYSTEM_ANIMATION. Os gráficos ocasionalmente animados são descritos como ROLE_SYSTEM_GRAPHIC com a propriedade State definida como STATE_SYSTEM_ANIMATED.

Note que algumas funções não são fáceis de descrever. Por exemplo, a visualização de ícones grandes de uma pasta permite a organização arbitrária de ícones, de modo que sua função pode ser descrita como ROLE_SYSTEM_GROUPING. Ou, um controle que fornece itens em linhas e colunas fixas pode ter a função ROLE_SYSTEM_TABLE. Como uma função é usada para comunicar o modelo de uso a um usuário final, é importante usar a função apropriada. Por exemplo, se o controle agir como um botão, use ROLE_SYSTEM_PUSHBUTTON.