Funzione AccessibleObjectFromPoint (oleacc.h)

Articolo
08/25/2023

Recupera l'indirizzo del puntatore dell'interfaccia IAccessibile per l'oggetto visualizzato in un punto specificato sullo schermo.

Sintassi

HRESULT AccessibleObjectFromPoint(
  [in]  POINT       ptScreen,
  [out] IAccessible **ppacc,
  [out] VARIANT     *pvarChild
);

Parametri

[in] ptScreen

Specifica, nelle coordinate dello schermo fisico, il punto esaminato.

[out] ppacc

Indirizzo di una variabile puntatore che riceve l'indirizzo dell'interfaccia IAccess dell'oggetto.

[out] pvarChild

Indirizzo di una struttura VARIANT che specifica se il puntatore dell'interfaccia IAccessibile restituito in ppacc appartiene all'oggetto visualizzato al punto specificato o all'elemento padre dell'elemento al punto specificato. Il membro vt della VARIANT è sempre VT_I4. Se il membro lVal è CHILDID_SELF, il puntatore dell'interfaccia IAccessibile a ppacc appartiene all'oggetto al punto. Se il membro lVal non è CHILDID_SELF, ppacc è l'indirizzo dell'interfaccia IAccess dell'oggetto padre dell'elemento figlio. I client devono chiamare VariantClear nel parametro VARIANT recuperato al termine dell'uso.

Valore restituito

Se ha esito positivo, restituisce S_OK.

In caso contrario, restituisce uno dei codici di errore COM seguenti o un altro codice di errore COM standard.

Codice restituito	Descrizione
E_INVALIDARG	Un argomento non è valido.

Commenti

Questa funzione recupera l'oggetto accessibile a livello più basso nella gerarchia di oggetti in un determinato punto. Se l'elemento al punto non è un oggetto accessibile, ovvero non supporta IAccess, la funzione recupera l'interfaccia IAccessibile dell'oggetto padre. L'oggetto padre deve fornire informazioni sull'elemento figlio tramite l'interfaccia IAccessibile . Chiamare IAccess::accHitTest per identificare l'elemento figlio nelle coordinate dello schermo specificate.

Come per altri metodi e funzioni IAccessi , i client potrebbero ricevere errori per i puntatori di interfaccia IAccessi a causa di un'azione utente. Per altre informazioni, vedere Ricezione di errori per i puntatori dell'interfaccia IAccessibile.

Esempio client

La funzione di esempio seguente seleziona l'elemento in un punto specificato sullo schermo. Si presuppone che una singola selezione sia desiderata.


HRESULT SelectItemAtPoint(POINT point)
{
    VARIANT varItem;
    IAccessible* pAcc;
    HRESULT hr = AccessibleObjectFromPoint(point, &pAcc, &varItem);
    if ((hr == S_OK))
    {
        hr = pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varItem);
        VariantClear(&varItem);
        pAcc->Release();
    }
    return hr;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95