Compartilhar via


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 de Função é 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 são ocasionalmente 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, de modo 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.