IAccPropServices::SetHwndPropStr-Methode (oleacc.h)

Diese Methode umschließt SetPropValue und bietet einen bequemeren Einstiegspunkt für Aufrufer, die HWND-basierte barrierefreie Elemente kommentieren.

Syntax

HRESULT SetHwndPropStr(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

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

Typ: LPCWSTR

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

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

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

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 (Include OleAcc.h Include Initguid.h first.)
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

SetHwndPropServer

SetPropValue