Caixa de diálogo (Referência de elemento da interface do usuário do MSAA)
Observação
Este tópico descreve objetos caixa de diálogo para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos caixa de diálogo 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.
Uma caixa de diálogo é uma janela temporária que um aplicativo cria para recuperar a entrada do usuário. Um aplicativo usa caixas de diálogo para solicitar ao usuário informações adicionais sobre comandos escolhidos pelo usuário em um menu. Uma caixa de diálogo contém um ou mais controles (janelas filho) com os quais o usuário insere texto, escolhe opções ou direciona a ação do comando.
O nome da classe de janela para caixas de diálogo é "#32770".
Métodos IAccessible
Uma caixa de diálogo dá suporte aos seguintes métodos IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | Se a caixa de diálogo contiver um botão de push padrão, o método accDoDefaultAction chamará PostMessage com a mensagem do botão BM_CLICK para clicar no botão de push padrão. |
| Acchittest | |
| Acclocation | |
| Accnavigate | |
| Accselect |
Propriedades IAccessible
Uma caixa de diálogo dá suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChildCount | A propriedade ChildCount é igual ao número de controles de janela filho na caixa de diálogo. |
| get_accDefaultAction | Se a caixa de diálogo contiver um botão de push padrão, a propriedade DefaultAction será "Press". |
| Get_accfocus | |
| Get_acckeyboardshortcut | Normalmente, as caixas de diálogo não têm atalhos de teclado. Se o texto da janela da caixa de diálogo contiver um caractere e comercial (&), a Acessibilidade Ativa da Microsoft retornará uma cadeia de caracteres não Null como a propriedade KeyboardShortcut . |
| Get_accname | A propriedade Name é o texto da janela ou legenda, exibido na barra de título da caixa de diálogo. |
| get_accParent | A propriedade Parent é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve a caixa de diálogo e tem a mesma propriedade Name e nome de classe de janela que a caixa de diálogo. |
| Get_accrole | A propriedade Role é ROLE_SYSTEM_DIALOG ou ROLE_SYSTEM_PROPERTYPAGE. |
| Get_accstate | A propriedade State é uma combinação de um ou mais dos seguintes valores:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Comentários
O objeto de caixa de diálogo não dá suporte ao método get_accChild . Para obter um ponteiro de interface IAccessible para um controle em uma caixa de diálogo, os clientes devem obter o identificador de janela do controle e chamar AccessibleObjectFromWindow.