IAccPropServices::SetHwndPropServer-Methode (oleacc.h)

Diese Methode umschließt SetPropServer und stellt einen bequemen Einstiegspunkt für Aufrufer bereit, die HWND-basierte barrierefreie Elemente kommentieren.

Syntax

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parameter

[in] hwnd

Typ: HWND

Gibt das barrierefreie Element an, das mit Anmerkungen versehen werden soll. Dadurch wird die Identitätszeichenfolge ersetzt.

[in] idObject

Typ: DWORD

Gibt das barrierefreie Element an, das mit Anmerkungen versehen werden soll. Dadurch wird die Identitätszeichenfolge ersetzt.

[in] idChild

Typ: DWORD

Gibt das barrierefreie Element an, das mit Anmerkungen versehen werden soll. Dadurch wird die Identitätszeichenfolge ersetzt.

[in] paProps

Typ: const MSAAPROPID*

Gibt ein Array von Eigenschaften an, das vom angegebenen Rückrufobjekt verarbeitet werden soll.

[in] cProps

Typ: int

Gibt die Anzahl der Eigenschaften im paProps-Array an.

[in] pServer

Typ: IAccPropServer*

Gibt das Rückrufobjekt an, das aufgerufen wird, wenn ein Client eine der überschriebenen Eigenschaften anfordert.

[in] annoScope

Typ: AnnoScope

Kann ANNO_THIS sein, wodurch angegeben wird, dass sich die Anmerkung nur auf das angegebene barrierefreie Element auswirkt, oder ANNO_CONTAINER, wodurch angegeben wird, dass sie sich auf das Element und dessen direkte untergeordnete Elemente bezieht.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn eine der Eigenschaften im paProps-Array nicht unterstützt wird, wenn die Identitätszeichenfolge ungültig ist oder ob annoScope keine ANNO_THIS oder ANNO_CONTAINER ist.

Kann andere Fehlercodes unter außergewöhnlichen Fehlerbedingungen zurückgeben, z. B. unter geringem Arbeitsspeicher.

Hinweise

Mit dieser Methode muss der Aufrufer keine Identitätszeichenfolge abrufen. Sie kann die Parameter hwnd, idObject und idChild direkt angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h (OleAcc.h Include Initguid.h zuerst einschließen.)
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98

Weitere Informationen

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropStr

SetPropServer