IAccessible::get_accDefaultAction-Methode (oleacc.h)
Die IAccessible::get_accDefaultAction-Methode ruft eine Zeichenfolge ab, die die Standardaktion des Objekts angibt. Nicht alle Objekte verfügen über eine Standardaktion.
Syntax
HRESULT get_accDefaultAction(
[in] VARIANT varChild,
[out, retval] BSTR *pszDefaultAction
);
Parameter
[in] varChild
Typ: VARIANT
Gibt an, ob die abgerufene Standardaktion vom -Objekt oder von einem der untergeordneten Elemente des Objekts ausgeführt wird. Dieser Parameter ist entweder CHILDID_SELF (zum Abrufen von Informationen über das Objekt) oder eine untergeordnete ID (zum Abrufen von Informationen über das untergeordnete Element des Objekts). Weitere Informationen zum Initialisieren der VARIANT-Struktur finden Sie unter Verwenden untergeordneter IDs in Parametern.
[out, retval] pszDefaultAction
Typ: BSTR*
Adresse eines BSTR , der eine lokalisierte Zeichenfolge empfängt, die die Standardaktion für das angegebene Objekt beschreibt; Wenn dieses Objekt keine Standardaktion aufweist, ist der Wert NULL.
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 die 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 |
|---|---|
|
Das angegebene Objekt verfügt nicht über eine Standardaktion. |
|
Ein Argument ist ungültig. |
|
Das angegebene Objekt unterstützt diese Eigenschaft nicht. |
Hinweise
Die abgerufene Zeichenfolge beschreibt die Aktion, die für ein Objekt ausgeführt wird, und nicht, was das Objekt als Ergebnis ausführt. Beispielsweise weist eine Symbolleistenschaltfläche, die ein Dokument druckt, die Standardaktion "Drücken" statt "Druckt das aktuelle Dokument" auf.
Verwechseln Sie die Standardaktion eines Objekts nicht mit seinem Wert. Weitere Informationen finden Sie unter DefaultAction-Eigenschaft.
Nur Steuerelemente, die Aktionen ausführen, unterstützen diese Methode.
Hinweis für Serverentwickler: Lokalisieren Sie die von dieser Eigenschaft zurückgegebene Zeichenfolge.
Serverbeispiel
Der folgende Beispielcode zeigt eine mögliche Implementierung dieser Methode für ein benutzerdefiniertes Listenfeld. Der Einfachheit halber sind die Zeichenfolgen nicht lokalisiert.
HRESULT STDMETHODCALLTYPE AccServer::get_accDefaultAction(
VARIANT varChild,
BSTR *pszDefaultAction)
{
if (varChild.vt != VT_I4)
{
*pszDefaultAction = NULL;
return E_INVALIDARG;
}
if (varChild.lVal == CHILDID_SELF)
{
*pszDefaultAction = SysAllocString(L"None.");
}
else
{
*pszDefaultAction = SysAllocString(L"Double-click");
}
return S_OK;
};
Anforderungen
| 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 |