AccessibleObjectFromPoint-Funktion (oleacc.h)

Artikel
08/25/2023

Ruft die Adresse des IAccessible-Schnittstellenzeigers für das Objekt ab, das an einem angegebenen Punkt auf dem Bildschirm angezeigt wird.

Syntax

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

Parameter

[in] ptScreen

Gibt in physischen Bildschirmkoordinaten den punkt an, der untersucht wird.

[out] ppacc

Adresse einer Zeigervariablen, die die Adresse der IAccessible-Schnittstelle des Objekts empfängt.

[out] pvarChild

Adresse einer VARIANT-Struktur , die angibt, ob der IAccessible-Schnittstellenzeiger , der in ppacc zurückgegeben wird, zu dem Objekt gehört, das am angegebenen Punkt angezeigt wird, oder zum übergeordneten Element am angegebenen Punkt. Das vt-Element des VARIANT-Elements ist immer VT_I4. Wenn der lVal-Member CHILDID_SELF ist, gehört der IAccessible-Schnittstellenzeiger bei ppacc zum -Objekt am Punkt. Wenn der lVal-Member nicht CHILDID_SELF ist, ist ppacc die Adresse der IAccessible-Schnittstelle des übergeordneten Objekts des untergeordneten Elements. Clients müssen VariantClear für den abgerufenen VARIANT-Parameter aufrufen, wenn die Verwendung abgeschlossen ist.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der folgenden oder einen anderen COM-Standardfehlercode zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Ein Argument ist ungültig.

Hinweise

Diese Funktion ruft das auf der niedrigsten Ebene zugängliche Objekt in der Objekthierarchie an einem bestimmten Punkt ab. Wenn das Element an der Stelle kein barrierefreies Objekt ist (d. h. IAccessible wird nicht unterstützt), ruft die Funktion die IAccessible-Schnittstelle des übergeordneten Objekts ab. Das übergeordnete Objekt muss Über die IAccessible-Schnittstelle Informationen über das untergeordnete Element bereitstellen. Rufen Sie IAccessible::accHitTest auf, um das untergeordnete Element an den angegebenen Bildschirmkoordinaten zu identifizieren.

Wie bei anderen IAccessible-Methoden und -Funktionen erhalten Clients aufgrund einer Benutzeraktion möglicherweise Fehler für IAccessible-Schnittstellenzeiger . Weitere Informationen finden Sie unter Empfangen von Fehlern für IAccessible-Schnittstellenzeiger.

Clientbeispiel

Die folgende Beispielfunktion wählt das Element an einem angegebenen Punkt auf dem Bildschirm aus. Es wird davon ausgegangen, dass eine einzelne Auswahl gewünscht wird.


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;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h
Bibliothek	Oleacc.lib
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95