Compartir a través de

Estructura POPUPMENUITEM

  • Artículo

Contiene información sobre los elementos de menú de un recurso de menú que abren un menú o un submenú. La definición de estructura proporcionada aquí es solo para explicación; no está presente en ningún archivo de encabezado estándar.

Sintaxis

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

Miembros

type

Tipo: DWORD

Describe el elemento de menú. Algunos de los valores que puede tener este miembro pueden incluir los que se muestran en la lista siguiente.

Además de los valores mostrados, este miembro también puede ser una combinación de los valores de tipo enumerados con el miembro fType de la estructura MENUITEMINFO . Los valores de tipo son aquellos que comienzan por MFT_. Para usar estos valores de tipo predefinidos MFT_*, incluya la siguiente instrucción en el archivo .rc:

#include "winuser.h"

Valor Significado
MF_END
0x80
 El elemento de menú es el último del menú; el sistema usa internamente la marca .
MF_POPUP
0x01
 El elemento de menú abre un menú o un submenú; el sistema usa internamente la marca .

state

Tipo: DWORD

Describe el elemento de menú. Este miembro puede ser una combinación de los valores de estado enumerados con el miembro dwState de la estructura MENUITEMINFO . Los valores de estado son aquellos que comienzan por MFS_. Para usar estos valores de estado predefinidos MFS_*, incluya la siguiente instrucción en el archivo .rc:

#include "winuser.h"

id

Tipo: DWORD

Expresión numérica que identifica el elemento de menú que se pasa en el mensaje WM_COMMAND .

resInfo

Tipo: WORD

Conjunto de marcas de bits que especifican el tipo de elemento de menú. Este miembro puede ser uno de los siguientes valores.

Valor Significado
MFR_END
0x80
 El elemento de menú es el último de este submenú o recurso de menú; el sistema usa internamente esta marca.
MFR_POPUP
0x01
 El elemento de menú abre un menú o un submenú; el sistema usa internamente la marca .

menuText

Tipo: szOrOrd

Cadena Unicode terminada en null que contiene el texto de este elemento de menú. No hay ningún límite fijo en el tamaño de esta cadena.

Observaciones

Hay una estructura POPUPMENUITEM para cada elemento de menú que abre un menú o un submenú. Identifique este tipo de elemento de menú estableciendo el miembro de tipoen MF_POPUP y estableciendo el bit de MFR_POPUP en el miembro resInfo en 0x0001. En este caso, los datos finales escritos en el recurso RT_MENU para el menú o submenú son la estructura MENUHELPID . MENUHELPID contiene una expresión numérica que identifica el menú durante WM_HELP procesamiento.

Además, cada estructura POPUPMENUITEM que tenga el bit MFR_POPUP establecido en el miembro resInfo irá seguido de una estructura MENUHELPID más un número adicional de estructuras POPUPMENUITEM , una para cada elemento de menú de ese submenú. La última estructura POPUPMENUITEM del submenú tendrá el bit MFR_END establecido en el miembro resInfo . Para buscar el final del recurso, busque una MFR_END coincidente para cada MFR_POPUP más una MFR_END adicional que coincida con el conjunto más externo de elementos de menú.

Indique el último elemento de menú estableciendo el miembro de tipoen MF_END. Dado que puede anidar submenús, puede haber varios niveles de MF_END. En estos casos, los elementos de menú son secuenciales.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]

Consulte también

Referencia

MENUHEADER

MENUHELPID

MENUITEMINFO

NORMALMENUITEM

Conceptual

Recursos