Estrutura MENUINFO (winuser.h)

  • Artigo

Contém informações sobre um menu.

Sintaxe

typedef struct tagMENUINFO {
  DWORD     cbSize;
  DWORD     fMask;
  DWORD     dwStyle;
  UINT      cyMax;
  HBRUSH    hbrBack;
  DWORD     dwContextHelpID;
  ULONG_PTR dwMenuData;
} MENUINFO, *LPMENUINFO;

Membros

cbSize

Tipo: DWORD

O tamanho da estrutura em bytes. O chamador deve definir esse membro como sizeof(MENUINFO).

fMask

Tipo: DWORD

Indica os membros a serem recuperados ou definidos (exceto para MIM_APPLYTOSUBMENUS). Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
MIM_APPLYTOSUBMENUS
0x80000000
 As configurações se aplicam ao menu e a todos os seus submenus. SetMenuInfo usa esse sinalizador e GetMenuInfo ignora esse sinalizador
MIM_BACKGROUND
0x00000002
 Recupera ou define o membro hbrBack .
MIM_HELPID
0x00000004
 Recupera ou define o membro dwContextHelpID .
MIM_MAXHEIGHT
0x00000001
 Recupera ou define o membro cyMax .
MIM_MENUDATA
0x00000008
 Recupera ou define o membro dwMenuData .
MIM_STYLE
0x00000010
 Recupera ou define o membro dwStyle .

dwStyle

Tipo: DWORD

O estilo do menu. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
MNS_AUTODISMISS
0x10000000
 O menu termina automaticamente quando o mouse está fora do menu por aproximadamente 10 segundos.
MNS_CHECKORBMP
0x04000000
 O mesmo espaço é reservado para a marca marcar e o bitmap. Se a marca marcar for desenhada, o bitmap não será. Todas as marcas de seleção e bitmaps estão alinhadas. Usado para menus em que alguns itens usam marcas de seleção e alguns usam bitmaps.
MNS_DRAGDROP
0x20000000
 Os itens de menu são destinos de soltar OLE ou arrastar fontes. O proprietário do menu recebe mensagens WM_MENUDRAG e WM_MENUGETOBJECT .
MNS_MODELESS
0x40000000
 O menu é sem modelo; ou seja, não há nenhum loop de mensagem modal de menu enquanto o menu estiver ativo.
MNS_NOCHECK
0x80000000
 Nenhum espaço é reservado à esquerda de um item para uma marca de marcar. O item ainda pode ser selecionado, mas a marca de marcar não aparecerá ao lado do item.
MNS_NOTIFYBYPOS
0x08000000
 O proprietário do menu recebe uma mensagem WM_MENUCOMMAND em vez de uma mensagem de WM_COMMAND quando o usuário faz uma seleção. MNS_NOTIFYBYPOS é um estilo de cabeçalho de menu e não tem efeito quando aplicado a submenus individuais.

cyMax

Tipo: UINT

A altura máxima do menu em pixels. Quando os itens de menu excedem o espaço disponível, as barras de rolagem são usadas automaticamente. O padrão (0) é a altura da tela.

hbrBack

Tipo: HBRUSH

Um identificador para o pincel a ser usado para a tela de fundo do menu.

dwContextHelpID

Tipo: DWORD

O identificador de ajuda de contexto. Esse é o mesmo valor usado nas funções GetMenuContextHelpId e SetMenuContextHelpId .

dwMenuData

Tipo: ULONG_PTR

Um valor definido pelo aplicativo.

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]
Cabeçalho winuser.h (inclua Windows.h)

Confira também

Visão geral dos menus