IAccessible::get_accSelection-Methode (oleacc.h)
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 |
---|---|
|
Es sind keine untergeordneten Elemente ausgewählt. |
|
Ein untergeordnetes Objekt ist ausgewählt, und die Adresse der IDispatch-Schnittstelle wird im pdispVal-Element festgelegt. |
|
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. |
|
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 |
---|---|
|
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 |