Comunicação Cliente/Servidor

O mecanismo de WinEvents fornece uma maneira para os servidores se comunicarem facilmente com clientes do Microsoft Ative Accessibility. Os clientes geralmente coletam informações reagindo a WinEvents (por exemplo, seguindo o foco), mas eles são livres para solicitar informações de um servidor a qualquer momento.

Para solicitar informações para um objeto acessível que gera um WinEvent, um cliente deve processar o evento e estabelecer uma conexão com o objeto acessível relevante. Para fazer isso, o cliente executa as seguintes seis etapas:

• Um servidor chama NotifyWinEvent para gerar uma notificação WinEvent para cada alteração em seus elementos da interface do usuário.
• O código de gerenciamento WinEvent em USER determina se algum aplicativo cliente registrou uma função WinEvent hook usando SetWinEventHook e chama a função de retorno de chamada registrada.
• Em sua função de retorno de chamada, o cliente solicita acesso ao objeto que gerou o evento chamando AccessibleObjectFromEvent ou outras funções de recuperação de objeto acessível. Para obter mais informações, consulte Recuperando um objeto IAccessible.
• Esta API de Acessibilidade Ativa da Microsoft envia ao aplicativo de servidor uma mensagem WM_GETOBJECT para recuperar o objeto acessível.
• Em resposta a WM_GETOBJECT, o aplicativo de servidor retorna zero ou retorna um valor que atua como uma referência única ao objeto que gerou o evento.
• Se o servidor retornar zero, o Microsoft Ative Accessibility criará um objeto proxy e fornecerá seu endereço ao cliente. Caso contrário, o Microsoft Ative Accessibility usa essa referência para recuperar o endereço de uma interface de objeto, como IAccessible ou IDispatch, e fornece esse endereço ao cliente.

Uma vez que o cliente tem um endereço de interface, ele pode chamar o IAccessible propriedades e métodos do objeto acessível para recuperar informações.

Nesta secção

• WinEvents e de Acessibilidade Ativa
• Como funciona WM_GETOBJECT
• Recuperando um objeto IAccessible