MSAAMENUINFO-Struktur (oleacc.h)

Wird von Serverentwicklern verwendet, um die Namen der vom Besitzer gezeichneten Menüelemente verfügbar zu machen.

Syntax

typedef struct tagMSAAMENUINFO {
  DWORD  dwMSAASignature;
  DWORD  cchWText;
  LPWSTR pszWText;
} MSAAMENUINFO, *LPMSAAMENUINFO;

Member

dwMSAASignature

Typ: DWORD

Muss MSAA_MENU_SIG sein, was in oleacc.h definiert ist.

cchWText

Typ: DWORD

Länge des Texts für das Menüelement in Zeichen, ohne das Unicode-Zeichen mit NULL-Beendigung.

pszWText

Typ: LPWSTR

Der Text des Menüelements in Unicode, einschließlich des Unicode-Nullzeichens.

Hinweise

Durch Zuordnen der MSAAMENUINFO-Struktur zu daten von besitzergezeichneten Menüelementen können Serverentwickler die Menüelemente verfügbar machen, ohne IAccessible implementieren zu müssen.

Die MSAAMENUINFO-Struktur ist das erste Element der anwendungsspezifischen Struktur (oder -klasse), das die Daten für ein vom Besitzer gezeichnetes Menüelement enthält, auf das das dwItemData-Element der MENUITEMINFO-Struktur verweist.

Die MSAAMENUINFO-Struktur kann kein Member in einer Klasse sein, die virtuelle Funktionen enthält, da das erste Element der Klasse immer ein vom Compiler generierter Zeiger auf eine Tabelle der virtuellen Funktionen ist. Um dieses Problem zu umgehen, können Sie eine Struktur implementieren, die das MSAAMENUINFO als erstes Element enthält, und einen Zeiger auf die Klasse mit den virtuellen Funktionen als zweites Element, das die vom Besitzer gezeichneten Elementdaten enthält.

Beispiele

Das folgende Codefragment zeigt die Deklaration einer anwendungsspezifischen, vom Besitzer gezeichneten Menüinformationsstruktur, die MSAAMENUINFO enthält:

// Application-specific owner-drawn menu info struct. Owner-drawn data 
// is a pointer to one of these. MSAAMENUINFO must be the first 
// member. 
struct MenuEntry
{
    MSAAMENUINFO m_MSAA;       // MSAA info - must be first element.
    LPTSTR       m_pName;      // Menu text, for display. NULL for
                               //  separator item.
    int          m_CmdID;      // Menu command ID.
    int          m_IconIndex;  // Index of icon in bitmap.
};

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	oleacc.h
Verteilbare Komponente	Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95

Weitere Informationen

Verfügbarmachen Owner-Drawn Menüelemente

Iaccessible