IAccessible::get_accSelection-Methode (oleacc.h)

Artikel
08/25/2023

Die IAccessible::get_accSelection-Methode ruft die ausgewählten untergeordneten Elemente dieses Objekts ab. Alle Objekte, die die Auswahl unterstützen, müssen diese Eigenschaft unterstützen.

Syntax

HRESULT get_accSelection(
  [out, retval] VARIANT *pvarChildren
);

Parameter

[out, retval] pvarChildren

Typ: VARIANT*

Adresse einer VARIANT-Struktur , die Informationen darüber empfängt, welche untergeordneten Elemente ausgewählt werden. In der folgenden Tabelle werden die in pvarChildren zurückgegebenen Informationen beschrieben.

vt-Member	Wertelement
VT_EMPTY	Es sind keine untergeordneten Elemente ausgewählt.
VT_DISPATCH	Ein untergeordnetes Objekt ist ausgewählt, und die Adresse der IDispatch-Schnittstelle wird im pdispVal-Element festgelegt.
VT_I4	lVal enthält die untergeordnete ID des ausgewählten untergeordneten Elements. Wenn lVal CHILDID_SELF ist, bedeutet dies, dass das Objekt selbst ausgewählt ist.
VT_UNKNOWN	Mehrere untergeordnete Objekte sind ausgewählt, und das PunkVal-Element enthält die Adresse der IUnknown-Schnittstelle . Der Client fragt diese Schnittstelle nach der IEnumVARIANT-Schnittstelle ab, die zum Auflisten der ausgewählten Objekte verwendet wird.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der Werte in der folgenden Tabelle oder einen anderen COM-Standardfehlercode zurück. Server geben diese Werte zurück, aber Clients müssen ausgabeparameter immer überprüfen, um sicherzustellen, dass sie gültige Werte enthalten. Weitere Informationen finden Sie unter Überprüfen von IAccessible-Rückgabewerten.

Fehler	BESCHREIBUNG
DISP_E_MEMBERNOTFOUND	Diese Eigenschaft wird vom Objekt nicht unterstützt.

Hinweise

Diese Methode muss die IEnumVARIANT-Schnittstelle unterstützen.

Diese Methode gibt entweder einen IDispatch-Schnittstellenzeiger oder eine untergeordnete ID für den pvarChildren-Parameter zurück. Weitere Informationen zur Verwendung des IDispatch-Schnittstellenzeigers oder der untergeordneten ID finden Sie unter Verwenden untergeordneter IDs in Parametern.

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.

Hinweis: Diese Methode ruft ein ausgewähltes Element und keinen markierten Text ab.

Serverbeispiel

Der folgende Beispielcode zeigt eine mögliche Implementierung dieser Methode für ein benutzerdefiniertes Einzelauswahllistenfeld. Die GetSelectedIndex-Methode gibt -1 zurück, wenn kein Element ausgewählt ist.


// m_pControl is the control that returns this accessible object. 

HRESULT STDMETHODCALLTYPE AccServer::get_accSelection(VARIANT *pvarChildren)
{
    int childID = m_pControl->GetSelectedIndex() + 1; // Convert from 0-based. 
    if (childID <= 0)
    {
        pvarChildren->vt = VT_EMPTY;
    }
    else 
    {
        pvarChildren->vt = VT_I4;
        pvarChildren->lVal = childID;
    }
    return S_OK;
};

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