IAccPropServices::SetHwndProp-Methode (oleacc.h)

Diese Methode umschließt SetPropValue und stellt einen bequemen Einstiegspunkt für Aufrufer bereit, die HWND-basierte barrierefreie Elemente kommentieren. Wenn der neue Wert eine Zeichenfolge ist, können Sie stattdessen IAccPropServices::SetHwndPropStr verwenden.

Syntax

HRESULT SetHwndProp(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

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] idProp

Typ: MSAAPROPID

Gibt an, welche Eigenschaft des betreffenden Elements mit Anmerkungen versehen werden soll.

[in] var

Typ: VARIANT

Gibt einen neuen Wert für die betreffende Eigenschaft an.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn die idProp-Eigenschaft nicht unterstützt wird.

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

SetHwndPropServer

SetHwndPropStr

SetPropValue