IAccPropServices::SetHmenuPropServer-Methode (oleacc.h)

Artikel
02/29/2024

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

Syntax

HRESULT SetHmenuPropServer(
  [in] HMENU            hmenu,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parameter

[in] hmenu

Typ: HMENU

Identifiziert das hmENU-barrierefreie Element, das kommentiert werden soll.

[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 hmenu 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