Compartilhar via

Barra de título (referência de elemento da interface do usuário do MSAA)

Nota

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 da 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 apontando.

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 deIAccessible:

  • accHitTest
  • accLocation
  • accNavigate
  • accSelect

Propriedades IAccessible

As barras de título dão suporte às seguintes propriedades deIAccessible:

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 descrição propriedade da própria barra de título é: "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:
  • "Move a janela para fora da
  • "Torna a janela cheia
  • "Coloca um minimizado ou
  • "Fecha a janela"
  • "Insere ou deixa o contexto-
  • "Abre o teclado quando pressionado"
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:
  • "Minimizar"
  • "Maximizar" ou "Restaurar",
  • "Fechar"
  • "Ajuda de contexto"
  • "IME"
get_accParent A propriedade Pai da barra de título é a janela principal do aplicativo (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 igual ao texto exibido na barra de título.

Anotações

  • Embora a barra de título de um aplicativo tenha o sinalizador de propriedade StateSTATE_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 deIAccessible. 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, não há suporte para os métodos accDoDefaultAction e get_accDefaultAction para esse controle.

interface IAccessible