POPUPMENUITEM, structure

Contient des informations sur les éléments de menu d’une ressource de menu qui ouvrent un menu ou un sous-menu. La définition de structure fournie ici est fournie à des fins d’explication uniquement ; il n’est présent dans aucun fichier d’en-tête standard.

Syntaxe

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

Membres

type

Type : DWORD

Décrit l’élément de menu. Certaines des valeurs que ce membre peut avoir incluent celles affichées dans la liste ci-dessous.

Outre les valeurs affichées, ce membre peut également être une combinaison des valeurs de type répertoriées avec le membre fType de la structure MENUITEMINFO . Les valeurs de type sont celles qui commencent par MFT_. Pour utiliser ces valeurs de type MFT_* prédéfinies, incluez l’instruction suivante dans votre fichier .rc :

#include "winuser.h"

Valeur	Signification
MF_END 0x80	L’élément de menu est le dernier du menu ; l’indicateur est utilisé en interne par le système.
MF_POPUP 0x01	L’élément de menu ouvre un menu ou un sous-menu ; l’indicateur est utilisé en interne par le système.

state

Type : DWORD

Décrit l’élément de menu. Ce membre peut être une combinaison des valeurs d’état répertoriées avec le membre dwState de la structure MENUITEMINFO . Les valeurs d’état sont celles qui commencent par MFS_. Pour utiliser ces valeurs d’état MFS_* prédéfinies, incluez l’instruction suivante dans votre fichier .rc :

#include "winuser.h"

id

Type : DWORD

Expression numérique qui identifie l’élément de menu passé dans le message WM_COMMAND .

resInfo

Type : WORD

Ensemble d’indicateurs de bits qui spécifient le type d’élément de menu. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
MFR_END 0x80	L’élément de menu est le dernier de ce sous-menu ou de cette ressource de menu ; cet indicateur est utilisé en interne par le système.
MFR_POPUP 0x01	L’élément de menu ouvre un menu ou un sous-menu ; l’indicateur est utilisé en interne par le système.

menuText

Type : szOrOrd

Chaîne Unicode terminée par un caractère Null qui contient le texte de cet élément de menu. Il n’existe aucune limite fixe sur la taille de cette chaîne.

Notes

Il existe une structure POPUPMENUITEM pour chaque élément de menu qui ouvre un menu ou un sous-menu. Identifiez ce type d’élément de menu en définissant le membre de typesur MF_POPUP et en définissant le bit MFR_POPUP dans le membre resInfo sur 0x0001. Dans ce cas, les données finales écrites dans la ressource RT_MENU pour le menu ou le sous-menu sont la structure MENUHELPID . MENUHELPID contient une expression numérique qui identifie le menu pendant WM_HELP traitement.

En outre, chaque structure POPUPMENUITEM qui a le bit MFR_POPUP défini dans le membre resInfo sera suivie d’une structure MENUHELPID plus un nombre supplémentaire de structures POPUPMENUITEM , une pour chaque élément de menu de ce sous-menu. La dernière structure POPUPMENUITEM du sous-menu aura le MFR_END bit défini dans le membre resInfo . Pour trouver la fin de la ressource, recherchez une MFR_END correspondante pour chaque MFR_POPUP plus une MFR_END supplémentaire qui correspond à l’ensemble le plus externe d’éléments de menu.

Indiquez le dernier élément de menu en définissant le membre de typesur MF_END. Étant donné que vous pouvez imbriquer des sous-menus, il peut y avoir plusieurs niveaux de MF_END. Dans ces cas, les éléments de menu sont séquentiels.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

Référence

MENUHEADER

MENUHELPID

MENUITEMINFO

NORMALMENUITEM

Conceptuel

Ressources