POPUPMENUITEM-Struktur

Enthält Informationen zu den Menüelementen in einer Menüressource, die ein Menü oder ein Untermenü öffnen. Die hier bereitgestellte Strukturdefinition ist nur zur Erklärung vorgesehen. sie ist in einer Standardheaderdatei nicht vorhanden.

Syntax

typedef struct {
  DWORD   type;
  DWORD   state;
  DWORD   id;
  WORD    resInfo;
  szOrOrd menuText;
} POPUPMENUITEM;

Member

type

Typ: DWORD

Beschreibt das Menüelement. Einige der Werte, die dieses Member haben kann, enthalten die werte, die in der folgenden Liste angezeigt werden.

Zusätzlich zu den angezeigten Werten kann dieser Member auch eine Kombination der Typwerte sein, die mit dem fType-Member der MENUITEMINFO-Struktur aufgelistet sind. Die Typwerte beginnen mit _ MFT. Um diese vordefinierten _ * MFT-Typwerte zu verwenden, schließen Sie die folgende Anweisung in ihre RC-Datei ein:

#include "winuser.h"

Wert Bedeutung
MF _ END
0x80
Das Menüelement ist das letzte im Menü. das Flag wird intern vom System verwendet.
MF _ POPUP
0x01
Das Menüelement öffnet ein Menü oder ein Untermenü. das Flag wird intern vom System verwendet.

state

Typ: DWORD

Beschreibt das Menüelement. Dieser Member kann eine Kombination der Zustandswerte sein, die mit dem dwState-Element der MENUITEMINFO-Struktur aufgelistet sind. Bei den Zustandswerten handelt es sich um die Werte, die mit MFS _ beginnen. Um diese vordefinierten MFS-Zustandswerte _ * zu verwenden, schließen Sie die folgende Anweisung in ihre RC-Datei ein:

#include "winuser.h"

id

Typ: DWORD

Ein numerischer Ausdruck, der das Menüelement identifiziert, das in der WM _ COMMAND-Meldung übergeben wird.

Resinfo

Typ: WORD

Ein Satz von Bitflags, die den Typ des Menüelements angeben. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
BESEN _ END
0x80
Das Menüelement ist das letzte in diesem Untermenü oder dieser Menüressource. dieses Flag wird intern vom System verwendet.
BESEN _ POPUP
0x01
Das Menüelement öffnet ein Menü oder ein Untermenü. das Flag wird intern vom System verwendet.

menuText

Typ: szOrOrd

Eine mit NULL beendete Unicode-Zeichenfolge, die den Text für dieses Menüelement enthält. Es gibt keine feste Beschränkung für die Größe dieser Zeichenfolge.

Hinweise

Es gibt eine POPUPMENUITEM-Struktur für jedes Menüelement, das ein Menü oder ein Untermenü öffnet. Identifizieren Sie diese Art von Menüelement, indem Sie das Typelement auf MF _ POPUP und das POPUP-Bit im _ resInfo-Element auf 0x0001. In diesem Fall sind die endgültigen Daten, die in die RESSOURCE RT _ MENU für das Menü oder Untermenü geschrieben werden, die MENUHELPID-Struktur. MENUHELPID enthält einen numerischen Ausdruck, der das Menü während der WM _ HELP-Verarbeitung identifiziert.

Darüber hinaus folgt auf jede POPUPMENUITEM-Struktur, für die das POPUP _ POPUP-Bit im resInfo-Element festgelegt ist, eine MENUHELPID-Struktur sowie eine zusätzliche Anzahl von POPUPMENUITEM-Strukturen, eine für jedes Menüelement in diesem Untermenü. Für die letzte POPUPMENUITEM-Struktur im Untermenü wird im resInfo-Member das BIT DES _ ENDES festgelegt. Um das Ende der Ressource zu finden, suchen Sie nach einem passenden BEENDEN für jedes _ POPUP-Popup und nach einem zusätzlichen DANN _ END, das mit dem äußersten Satz von Menüelementen übereinstimmen. _

Geben Sie das letzte Menüelement an, indem Sie das Typelement auf MF _ END festlegen. Da Sie Untermenüs schachteln können, kann es mehrere Ebenen von MF _ END geben. In diesen Fällen sind die Menüelemente sequenziell.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]

Siehe auch

Referenz

MENUHEADER

MENUHELPID

MENUITEMINFO

NORMALMENUITEM

Konzeptionellen

Ressourcen