Partilhar via


Caixa de diálogo (referência de elemento da interface do usuário do MSAA)

Observação

Este tópico descreve caixa de diálogo objetos para fins de referência de elemento da interface do usuário do MSAA. Como criar caixa de diálogo objetos 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 da 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 que o usuário escolheu em um menu. Uma caixa de diálogo contém um ou mais controles (janelas filhas) 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 suporta os seguintes IAccessible métodos:

Método Observações
accDoDefaultAction Se a caixa de diálogo contiver um botão padrão, o métodoaccDoDefaultActionchamará PostMessage com a mensagem do botão BM_CLICK para clicar no botão padrão.
accHitTest
accLocalização
accNavigate
accSelecione

Propriedades IAccessible

Uma caixa de diálogo suporta os seguintes propriedades IAccessible:

Propriedade Observações
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 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 para a caixa de diálogo contiver um caractere comercial (&), o Microsoft Ative Accessibility retornará uma cadeia de caracteres não Nula 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 circunda a caixa de diálogo e tem a mesma propriedade Name e window class name 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 de :STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE

Comentários

O objeto de diálogo não suporta o 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, em seguida, chamar AccessibleObjectFromWindow.

Interface IAccessible