MENUINFO-Struktur (winuser.h)

  • Artikel

Enthält Informationen zu einem Menü.

Syntax

typedef struct tagMENUINFO {
  DWORD     cbSize;
  DWORD     fMask;
  DWORD     dwStyle;
  UINT      cyMax;
  HBRUSH    hbrBack;
  DWORD     dwContextHelpID;
  ULONG_PTR dwMenuData;
} MENUINFO, *LPMENUINFO;

Member

cbSize

Art: DWORD

Die Größe der Struktur in Bytes. Der Aufrufer muss diesen Member auf sizeof(MENUINFO)festlegen.

fMask

Art: DWORD

Gibt die elemente an, die abgerufen oder festgelegt werden sollen (mit Ausnahme von MIM_APPLYTOSUBMENUS). Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
MIM_APPLYTOSUBMENUS
0x80000000
 Einstellungen gelten für das Menü und alle zugehörigen Untermenüs. SetMenuInfo verwendet dieses Flag, und GetMenuInfo ignoriert dieses Flag.
MIM_BACKGROUND
0x00000002
 Ruft das hbrBack-Element ab oder legt es fest.
MIM_HELPID
0x00000004
 Ruft den dwContextHelpID-Member ab oder legt es fest.
MIM_MAXHEIGHT
0x00000001
 Ruft das cyMax-Element ab oder legt es fest.
MIM_MENUDATA
0x00000008
 Ruft das dwMenuData-Element ab oder legt es fest.
MIM_STYLE
0x00000010
 Ruft das dwStyle-Element ab oder legt es fest.

dwStyle

Art: DWORD

Das Menüformat. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
MNS_AUTODISMISS
0x10000000
 Das Menü wird automatisch beendet, wenn sich die Maus ca. 10 Sekunden außerhalb des Menüs befindet.
MNS_CHECKORBMP
0x04000000
 Derselbe Platz ist für das Häkchen und die Bitmap reserviert. Wenn das Häkchen gezeichnet ist, ist die Bitmap nicht. Alle Häkchen und Bitmaps sind ausgerichtet. Wird für Menüs verwendet, in denen einige Elemente Häkchen und einige Bitmaps verwenden.
MNS_DRAGDROP
0x20000000
 Menüelemente sind OLE-Ablageziele oder Ziehquellen. Der Menübesitzer empfängt WM_MENUDRAG und WM_MENUGETOBJECT Nachrichten.
MNS_MODELESS
0x40000000
 Menü ist moduslos; Das heißt, es gibt keine modale Menümeldungsschleife, während das Menü aktiv ist.
MNS_NOCHECK
0x80000000
 Links neben einem Element ist kein Platz für ein Häkchen reserviert. Das Element kann weiterhin ausgewählt werden, aber das Häkchen wird nicht neben dem Element angezeigt.
MNS_NOTIFYBYPOS
0x08000000
 Der Menübesitzer empfängt eine WM_MENUCOMMAND-Nachricht anstelle einer WM_COMMAND Nachricht, wenn der Benutzer eine Auswahl trifft. MNS_NOTIFYBYPOS ist ein Menüheaderstil und hat keine Auswirkungen, wenn es auf einzelne Untermenüs angewendet wird.

cyMax

Typ: UINT

Die maximale Höhe des Menüs in Pixel. Wenn die Menüelemente den verfügbaren Speicherplatz überschreiten, werden automatisch Bildlaufleisten verwendet. Die Standardeinstellung (0) ist die Bildschirmhöhe.

hbrBack

Typ: HBRUSH

Ein Handle für den Pinsel, der für den Hintergrund des Menüs verwendet werden soll.

dwContextHelpID

Art: DWORD

Der Kontexthilfebezeichner. Dies ist der gleiche Wert, der in den Funktionen GetMenuContextHelpId und SetMenuContextHelpId verwendet wird.

dwMenuData

Typ: ULONG_PTR

Ein anwendungsdefinierter Wert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile winuser.h (einschließlich Windows.h)

Weitere Informationen

Menüübersicht