Recupero di un puntatore all'interfaccia oggetto accessibile
Le applicazioni client di Microsoft Active Accessibility recuperano puntatori di interfaccia agli oggetti accessibili usando una delle funzioni seguenti.
AccessibleObjectFromEvent
Molti client cercano informazioni su oggetti accessibili specifici che generano eventi. Poiché l'interfaccia IAccessible è il "gateway" per gli oggetti accessibili, i client devono avere un modo semplice per associare WinEvents all'interfaccia IAccessible dell'oggetto che genera gli eventi. Microsoft Active Accessibility fornisce la funzione AccessibleObjectFromEvent specificamente a questo scopo.
Nota
I client con funzioni hook nel contesto devono chiamare la funzione IsWindow prima di chiamare AccessibleObjectFromEvent.
La funzione AccessibleObjectFromEvent accetta molte delle stesse informazioni ricevute dalla funzione hook di un client. Quando una funzione hook client riceve una notifica degli eventi, passa i parametri appropriati dagli eventi a AccessibleObjectFromEvent.
La funzione recupera l'interfaccia IAccessible dell'elemento dell'interfaccia utente che ha generato l'evento o l'interfaccia dell'oggetto padre dell'elemento. Se viene restituito il puntatore all'interfaccia dell'oggetto padre, il client chiama le proprietà e i metodi dell'elemento padre per ottenere informazioni sull'elemento figlio che ha generato l'evento.
AccessibleObjectFromPoint
Per recuperare l'indirizzo dell'interfaccia IAccessible di un oggetto in un punto specificato sullo schermo, i client usano la funzione AccessibleObjectFromPoint .
AccessibleObjectFromWindow
Per recuperare l'interfaccia IAccessible di un oggetto da un handle di finestra, i client usano la funzione AccessibleObjectFromWindow .
È possibile che i server restituisca puntatori di interfaccia distinti per lo stesso elemento dell'interfaccia utente ogni volta che viene chiamata la funzione AccessibleObjectFromEvent, AccessibleObjectFromPoint o AccessibleObjectFromWindow . Per determinare se due puntatori fanno riferimento allo stesso elemento dell'interfaccia utente, gli sviluppatori client devono confrontare le proprietà IAccessible dell'oggetto, non i puntatori.