Ler em inglês

Compartilhar via


Estrutura POPUPMENUITEM

Contém informações sobre os itens de menu em um recurso de menu que abre um menu ou um submenu. A definição de estrutura fornecida aqui é apenas para explicação; ele não está presente em nenhum arquivo de cabeçalho padrão.

Sintaxe

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

Membros

tipo

Tipo: DWORD

Descreve o item de menu. Alguns dos valores que esse membro pode ter incluem os mostrados na lista abaixo.

Além dos valores mostrados, esse membro também pode ser uma combinação dos valores de tipo listados com o membro fType da estrutura MENUITEMINFO . Os valores de tipo são aqueles que começam com MFT_. Para usar esses valores de tipo MFT_* predefinidos, inclua a seguinte instrução no arquivo .rc:

#include "winuser.h"

Valor Significado
MF_END
0x80
O item de menu é o último no menu; o sinalizador é usado internamente pelo sistema.
MF_POPUP
0x01
O item de menu abre um menu ou um submenu; o sinalizador é usado internamente pelo sistema.

state

Tipo: DWORD

Descreve o item de menu. Esse membro pode ser uma combinação dos valores de estado listados com o membro dwState da estrutura MENUITEMINFO . Os valores de estado são aqueles que começam com MFS_. Para usar esses valores de estado de MFS_* predefinidos, inclua a seguinte instrução no arquivo .rc:

#include "winuser.h"

id

Tipo: DWORD

Uma expressão numérica que identifica o item de menu passado na mensagem WM_COMMAND .

Resinfo

Tipo: WORD

Um conjunto de sinalizadores de bits que especificam o tipo de item de menu. Esse membro pode ser um dos seguintes valores.

Valor Significado
MFR_END
0x80
O item de menu é o último neste submenu ou recurso de menu; esse sinalizador é usado internamente pelo sistema.
MFR_POPUP
0x01
O item de menu abre um menu ou um submenu; o sinalizador é usado internamente pelo sistema.

Menutext

Tipo: szOrOrd

Uma cadeia de caracteres Unicode terminada em nulo que contém o texto deste item de menu. Não há um limite fixo no tamanho dessa cadeia de caracteres.

Comentários

Há uma estrutura POPUPMENUITEM para cada item de menu que abre um menu ou um submenu. Identifique esse tipo de item de menu definindo o membro do tipo como MF_POPUP e definindo o bit MFR_POPUP no membro resInfo como 0x0001. Nesse caso, os dados finais gravados no recurso RT_MENU para o menu ou submenu são a estrutura MENUHELPID . MENUHELPID contém uma expressão numérica que identifica o menu durante WM_HELP processamento.

Além disso, cada estrutura POPUPMENUITEM que tem o MFR_POPUP bit definido no membro resInfo será seguida por uma estrutura MENUHELPID mais um número adicional de estruturas POPUPMENUITEM , uma para cada item de menu nesse submenu. A última estrutura POPUPMENUITEM no submenu terá o MFR_END bit definido no membro resInfo . Para encontrar o final do recurso, procure um MFR_END correspondente para cada MFR_POPUP mais um MFR_END adicional que corresponda ao conjunto mais externo de itens de menu.

Indique o último item de menu definindo o membro do tipo como MF_END. Como você pode aninhar submenus, pode haver vários níveis de MF_END. Nessas instâncias, os itens de menu são sequenciais.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

Referência

MENUHEADER

MENUHELPID

MENUITEMINFO

NORMALMENUITEM

Conceitual

Recursos