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 |