Obtendo um ponteiro da interface do 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 o WinEvents à interface IAccessible do objeto que gera os eventos. O Microsoft Active Accessibility fornece a função AccessibleObjectFromEvent especificamente para essa finalidade.

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 da interface do objeto pai for retornado, o cliente chamará as propriedades e os métodos 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 a partir 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 cada vez 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 propriedades IAccessible do objeto, não ponteiros.