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.
typedef struct {
DWORD type;
DWORD state;
DWORD id;
WORD resInfo;
szOrOrd menuText;
} POPUPMENUITEM;
-
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.
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.
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] |
-
Referência
-
Conceitual