Barra de título (referência de elemento da interface do usuário do MSAA)
Observação
Este tópico descreve objetos da Barra de Título para fins de Referência de Elemento de Interface do Usuário do MSAA. Como criar objetos da Barra de Título em várias estruturas de interface do usuário não é descrito aqui. Consulte a documentação de referência de API para a estrutura de interface do usuário que você está usando.
A barra de título na parte superior de uma janela exibe um ícone definido pelo aplicativo e uma linha de texto. O texto especifica o nome do aplicativo e indica a finalidade da janela. A barra de título também possibilita que o usuário mova a janela usando um mouse ou outro dispositivo apontador.
As barras de título contêm pelo menos três botões pequenos que minimizam, maximizam ou restauram e fecham a janela associada à barra de título. As barras de título também contêm um botão de Ajuda contextual. Os aplicativos em execução na versão Far-East do sistema operacional Windows também podem conter botões IME (Editor de Método de Entrada). A Acessibilidade Ativa da Microsoft expõe esses botões como elementos filho da barra de título.
Métodos IAccessible
As barras de título dão suporte aos seguintes métodos IAccessible :
Propriedades IAccessible
As barras de título dão suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChildCount | A propriedade ChildCount é cinco. A propriedade ChildCount inclui os botões IME e Ajuda contextual, mesmo quando eles não são exibidos. Os botões que não são exibidos têm a propriedade StateSTATE_SYSTEM_INVISIBLE. |
| get_accDescription | A propriedade Description da barra de título em si é: "Exibe o nome da janela e contém controles para manipulá-la". Os botões filho na barra de título têm as seguintes descrições:
|
| Get_accname | A barra de título em si não dá suporte à propriedade Name . Os botões filho na barra de título têm os seguintes nomes:
|
| get_accParent | A propriedade Parent da barra de título é a janela do aplicativo main ( ROLE_SYSTEM_WINDOW ) que tem o mesmo nome de classe de janela definido pelo aplicativo que a barra de título. |
| Get_accrole | A propriedade Role é ROLE_SYSTEM_TITLEBAR. Os botões filho na barra de título têm a propriedade RoleROLE_SYSTEM_PUSHBUTTON. |
| Get_accstate | A propriedade State para a barra de título e os botões filho pode ser uma combinação de um ou mais dos seguintes valores: STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_INVISIBLE STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_PRESSED |
| get_accValue | A propriedade Value é uma cadeia de caracteres que é igual ao texto exibido na barra de título. |
Observações
- Embora a barra de título de um aplicativo tenha o sinalizador de propriedade State STATE_SYSTEM_FOCUSABLE, ele nunca tem o sinalizador StateSTATE_SYSTEM_FOCUSED. Definir o foco para um objeto de barra de título concentra a janela do aplicativo.
- Como o objeto da barra de título não dá suporte a get_accChild, os botões na barra de título são elementos simples. Eles não dão suporte à interface IAccessible por conta própria. O objeto da barra de título fornece informações sobre esses botões filho.
- Como as barras de título não têm foco e não têm nenhuma ação padrão, os métodos accDoDefaultAction e get_accDefaultAction não têm suporte para esse controle.