Struttura POPUPMENUITEM

Contiene informazioni sulle voci di menu in una risorsa di menu che apre un menu o un sottomenu. La definizione della struttura fornita qui è solo per spiegazione; non è presente in alcun file di intestazione standard.

Sintassi

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

Members

type

Tipo: DWORD

Descrive la voce di menu. Alcuni dei valori che questo membro può avere possono includere quelli visualizzati nell'elenco seguente.

Oltre ai valori visualizzati, questo membro può anche essere una combinazione dei valori di tipo elencati con il membro fType della struttura MENUITEMINFO . I valori di tipo sono quelli che iniziano con MFT_. Per usare questi valori di tipo MFT_* predefiniti, includere l'istruzione seguente nel file RC:

#include "winuser.h"

Valore	Significato
MF_END 0x80	La voce di menu è l'ultima del menu; il flag viene utilizzato internamente dal sistema.
MF_POPUP 0x01	La voce di menu apre un menu o un sottomenu; il flag viene utilizzato internamente dal sistema.

state

Tipo: DWORD

Descrive la voce di menu. Questo membro può essere una combinazione dei valori di stato elencati con il membro dwState della struttura MENUITEMINFO . I valori di stato sono quelli che iniziano con MFS_. Per usare questi valori di stato predefiniti MFS_*, includere l'istruzione seguente nel file RC:

#include "winuser.h"

id

Tipo: DWORD

Espressione numerica che identifica la voce di menu passata nel messaggio WM_COMMAND .

Resinfo

Tipo: WORD

Set di flag di bit che specificano il tipo di voce di menu. Questo membro può essere uno dei valori seguenti.

Valore	Significato
MFR_END 0x80	La voce di menu è l'ultima in questo sottomenu o risorsa di menu; questo flag viene usato internamente dal sistema.
MFR_POPUP 0x01	La voce di menu apre un menu o un sottomenu; il flag viene utilizzato internamente dal sistema.

menuText

Tipo: szOrOrd

Stringa Unicode con terminazione Null contenente il testo per questa voce di menu. Non esiste alcun limite fisso per le dimensioni di questa stringa.

Commenti

Esiste una struttura POPUPMENUITEM per ogni voce di menu che apre un menu o un sottomenu. Identificare questo tipo di voce di menu impostando il membro del tiposu MF_POPUP e impostando il bit MFR_POPUP nel membro resInfo su 0x0001. In questo caso, i dati finali scritti nella risorsa RT_MENU per il menu o il sottomenu sono la struttura MENUHELPID . MENUHELPID contiene un'espressione numerica che identifica il menu durante l'elaborazione WM_HELP .

Inoltre, ogni struttura POPUPMENUITEM con il bit MFR_POPUP impostato nel membro resInfo sarà seguita da una struttura MENUHELPID più un numero aggiuntivo di strutture POPUPMENUITEM , una per ogni voce di menu in tale sottomenu. L'ultima struttura POPUPMENUITEM nel sottomenu avrà il bit MFR_END impostato nel membro resInfo . Per trovare la fine della risorsa, cercare un MFR_END corrispondente per ogni MFR_POPUP più un MFR_END aggiuntivo corrispondente al set più esterno di voci di menu.

Indicare l'ultima voce di menu impostando il membro del tipo su MF_END. Poiché è possibile annidare sottomenu, possono essere presenti più livelli di MF_END. In questi casi, le voci di menu sono sequenziali.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

Riferimento

MENUHEADER

MENUHELPID

MENUITEMINFO

NORMALMENUITEM

Informazioni concettuali

Risorse