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
S_FALSE	Das angegebene Objekt verfügt nicht über eine Standardaktion.
E_INVALIDARG	Ein Argument ist ungültig.
DISP_E_MEMBERNOTFOUND	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

Weitere Informationen

DefaultAction-Eigenschaft

Iaccessible

IAccessible::accDoDefaultAction

VARIANTE