Manipulando a mensagem de WM_GETOBJECT

Tanto a Acessibilidade Ativa da Microsoft quanto a Automação da Interface do Usuário da Microsoft enviam a mensagem WM_GETOBJECT para um servidor ou aplicativo de provedor para recuperar informações sobre um objeto acessível com suporte pelo servidor ou provedor. Os clientes nunca enviam WM_GETOBJECT diretamente. Em vez disso, o Microsoft Active Accessibility envia essa mensagem quando um cliente chama as funções AccessibleObjectFromPoint, AccessibleObjectFromEvent e AccessibleObjectFromWindow . Automação da UI envia WM_GETOBJECT quando um cliente chama IUIAutomation::ElementFromHandle, ElementFromPoint e GetFocusedElement, e ao processar eventos para os quais o cliente se registrou.

A Automação de Interface do Usuário ou Acessibilidade Ativa da Microsoft especifica o tipo de objeto para o qual precisa de informações passando um valor chamado identificador de objeto com a mensagem WM_GETOBJECT . Quando ela recebe a mensagem, o servidor ou provedor examina o identificador de objeto para determinar como responder à mensagem. A resposta depende se o aplicativo receptor implementa a Acessibilidade Ativa da Microsoft (um servidor), a Automação da Interface do Usuário (um provedor) ou nenhum deles, para o objeto especificado.

• Se o aplicativo receptor for um servidor Microsoft Active Accessibility e a mensagem WM_GETOBJECT incluir um identificador de objeto de OBJID_CLIENT, o servidor deverá retornar o valor obtido ao passar a interface IAccessible do objeto para a função LresultFromObject.
• Se o aplicativo receptor for um provedor de Automação de Interface do Usuário e o identificador de objeto for UiaRootObjectId, o provedor deverá retornar a interface IRawElementProviderSimple do objeto. O provedor obtém a interface chamando a função UiaReturnRawElementProvider .
• Se o aplicativo receptor não implementar nem a Acessibilidade Ativa da Microsoft nem a Automação da Interface do Usuário, ele deverá passar a mensagem WM_GETOBJECT para a função DefWindowProc . Passar a mensagem permite que a estrutura de acessibilidade determine se um proxy está disponível para o objeto especificado.
• Se o identificador de objeto não for OBJID_CLIENT nem UiaRootObjectId, o aplicativo receptor deverá passar a mensagem WM_GETOBJECT para a função DefWindowProc . Passar a mensagem permite que a estrutura de acessibilidade use os provedores padrão para elementos de interface do usuário padrão.

A Microsoft Active Accessibility e a Automação de Interface do Usuário podem passar identificadores de objeto personalizados em uma mensagem WM_GETOBJECT para recuperar valores ou objetos definidos pelo aplicativo de um servidor ou provedor. O identificador de objeto OBJID_NATIVEOM ou OBJID_QUERYCLASSNAMEIDX pode ser usado para recuperar uma interface do Modelo de Objeto nativo ou para solicitar um objeto proxy específico compatível com Oleacc.dll.

Ao lidar com os identificadores de objeto OBJID_CLIENT e UiaRootObjectId , uma implementação do servidor de Acessibilidade Ativa da Microsoft pode coexistir junto com uma implementação do provedor de Automação de Interface do Usuário. Como a maioria dos controles padrão do Windows e controles comuns implementados pela biblioteca de controle comum (ComCtl32.dll) não implementa a Acessibilidade Ativa da Microsoft ou a Automação de Interface do Usuário, esses controles normalmente não lidam com a mensagem WM_GETOBJECT . Em vez disso, a estrutura de Automação de Interface do Usuário ou Acessibilidade Ativa da Microsoft verifica se um objeto proxy está disponível para um elemento de interface do usuário específico. Caso contrário, ele fornece o objeto proxy padrão para o objeto da janela do host.