Obtendo um ponteiro de interface de objeto acessível

Os aplicativos cliente do Microsoft Active Accessibility recuperam ponteiros de interface para objetos acessíveis usando uma das funções a seguir.

AccessibleObjectFromEvent

Muitos clientes pesquisam informações sobre objetos acessíveis específicos que geram eventos. Como a interface IAccessible é o "gateway" para objetos acessíveis, os clientes devem ter uma maneira fácil de associar WinEvents à interface IAccessible do objeto que gera os eventos. A Acessibilidade Ativa da Microsoft fornece a função AccessibleObjectFromEvent especificamente para essa finalidade.

Observação

Clientes com funções de gancho no contexto devem chamar a função IsWindow antes de chamar AccessibleObjectFromEvent.

 

A função AccessibleObjectFromEvent aceita muitas das mesmas informações que a função de gancho de um cliente recebe. Quando uma função de gancho de cliente recebe uma notificação de evento, ela passa os parâmetros apropriados de eventos para AccessibleObjectFromEvent.

A função recupera a interface IAccessible do elemento de interface do usuário que gerou o evento ou a interface do objeto pai do elemento. Se o ponteiro de interface do objeto pai for retornado, o cliente chamará as propriedades e os métodos do pai para obter informações sobre o elemento filho que gerou o evento.

AccessibleObjectFromPoint

Para recuperar o endereço da interface IAccessible de um objeto em um ponto especificado na tela, os clientes usam a função AccessibleObjectFromPoint .

AccessibleObjectFromWindow

Para recuperar a interface IAccessible de um objeto de um identificador de janela, os clientes usam a função AccessibleObjectFromWindow .

É possível que os servidores retornem ponteiros de interface distintos para o mesmo elemento de interface do usuário sempre que a função AccessibleObjectFromEvent, AccessibleObjectFromPoint ou AccessibleObjectFromWindow for chamada. Para determinar se dois ponteiros se referem ao mesmo elemento de interface do usuário, os desenvolvedores cliente devem comparar as propriedades IAccessible do objeto, não ponteiros.