Propriedade Role

A propriedade Role descreve o elemento de interface do usuário de um objeto. Todos os objetos dão suporte à propriedade Role .

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

A propriedade Role é recuperada chamando IAccessible::get_accRole.

Identificando a função de um objeto

A Acessibilidade Ativa da Microsoft 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. Gráficos que ocasionalmente são animados são descritos como ROLE_SYSTEM_GRAPHIC com a propriedade State definida como STATE_SYSTEM_ANIMATED.

Observe que algumas funções não são fáceis de descrever. Por exemplo, a exibição de ícone grande de uma pasta permite a disposição arbitrária de ícones, para que sua função possa 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.