POPUPMENUITEM-Struktur

Enthält Informationen zu den Menüelementen in einer Menüressource, die ein Menü oder ein Untermenü öffnen. Die hier bereitgestellte Strukturdefinition dient nur zur Erläuterung. es ist in keiner Standardheaderdatei vorhanden.

Syntax

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

Member

type

Art: DWORD

Beschreibt das Menüelement. Einige der Werte, die dieser 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-Element der MENUITEMINFO-Struktur aufgeführt sind. Die Typwerte sind die Werte, die mit MFT_ beginnen. Um diese vordefinierten MFT_*-Typwerte zu verwenden, fügen 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

Art: DWORD

Beschreibt das Menüelement. Dieser Member kann eine Kombination der Zustandswerte sein, die mit dem dwState-Element der MENUITEMINFO-Struktur aufgeführt sind. Die Statuswerte sind die Werte, die mit MFS_ beginnen. Um diese vordefinierten MFS_*-Zustandswerte zu verwenden, fügen Sie die folgende Anweisung in Ihre RC-Datei ein:

#include "winuser.h"

ID

Art: DWORD

Ein numerischer Ausdruck, der das Menüelement identifiziert, das in der WM_COMMAND Nachricht ü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
MFR_END 0x80	Das Menüelement ist das letzte in diesem Untermenü oder dieser Menüressource. dieses Flag wird intern vom System verwendet.
MFR_POPUP 0x01	Das Menüelement öffnet ein Menü oder ein Untermenü; das Flag wird intern vom System verwendet.

menuText

Typ: szOrOrd

Eine mit NULL endende 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.

Bemerkungen

Es gibt eine POPUPMENUITEM-Struktur für jedes Menüelement, das ein Menü oder ein Untermenü öffnet. Identifizieren Sie diesen Typ von Menüelement, indem Sie den Typmember auf MF_POPUP und das MFR_POPUP Bit im resInfo-Element auf 0x0001 festlegen. In diesem Fall sind die endgültigen Daten, die in die RT_MENU-Ressource für das Menü oder Untermenü geschrieben werden, die MENUHELPID-Struktur . MENUHELPID enthält einen numerischen Ausdruck, der das Menü während der verarbeitung WM_HELP identifiziert.

Darüber hinaus folgt auf jede POPUPMENUITEM-Struktur , deren MFR_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 das MFR_END Bit im resInfo-Element festgelegt. Um das Ende der Ressource zu finden, suchen Sie nach einem übereinstimmenden MFR_END für jede MFR_POPUP sowie nach einem zusätzlichen MFR_END , der dem äußersten Satz von Menüelementen entspricht.

Geben Sie das letzte Menüelement an, indem Sie den Typmember auf MF_END festlegen. Da Sie Untermenüs verschachteln 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

Konzept

Ressourcen