Estrutura MENUITEMINFOA (winuser.h)
Contém informações sobre um item de menu.
Sintaxe
typedef struct tagMENUITEMINFOA {
UINT cbSize;
UINT fMask;
UINT fType;
UINT fState;
UINT wID;
HMENU hSubMenu;
HBITMAP hbmpChecked;
HBITMAP hbmpUnchecked;
ULONG_PTR dwItemData;
LPSTR dwTypeData;
UINT cch;
HBITMAP hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;
Membros
cbSize
Tipo: UINT
O tamanho da estrutura, em bytes. O chamador deve definir esse membro como sizeof(MENUITEMINFO).
fMask
Tipo: UINT
Indica os membros a serem recuperados ou definidos. Esse membro pode ser um ou mais dos valores a seguir.
fType
Tipo: UINT
O tipo de item de menu. Esse membro pode ser um ou mais dos valores a seguir.
Os valores MFT_BITMAP, MFT_SEPARATORe MFT_STRING não podem ser combinados entre si. Defina fMask para MIIM_TYPE usar fType.
fType será usado somente se fMask tiver um valor de MIIM_FTYPE.
| Valor | Significado |
|---|---|
|
Exibe o item de menu usando um bitmap. A palavra de baixa ordem do membro MFT_BITMAP é substituído por MIIM_BITMAP e hbmpItem. |
|
Coloca o item de menu em uma nova linha (para uma barra de menus) ou em uma nova coluna (para um menu suspenso, submenu ou menu de atalho). Para um menu suspenso, submenu ou menu de atalho, uma linha vertical separa a nova coluna da antiga. |
|
Coloca o item de menu em uma nova linha (para uma barra de menus) ou em uma nova coluna (para um menu suspenso, submenu ou menu de atalho). Para um menu suspenso, submenu ou menu de atalho, as colunas não são separadas por uma linha vertical. |
|
Atribui a responsabilidade de desenhar o item de menu à janela que possui o menu. A janela recebe uma mensagem WM_MEASUREITEM antes que o menu seja exibido pela primeira vez e uma mensagem de WM_DRAWITEM sempre que a aparência do item de menu precisar ser atualizada. Se esse valor for especificado, o membro dwTypeData conterá um valor definido pelo aplicativo. |
|
Exibe itens de menu selecionados usando uma marca de botão de opção em vez de uma marca de seleção se o membro |
|
Justifica com o botão direito do mouse o item de menu e os itens subsequentes. Esse valor será válido somente se o item de menu estiver em uma barra de menus. |
|
Especifica que os menus são em cascata da direita para a esquerda (o padrão é da esquerda para a direita). Isso é usado para dar suporte a idiomas da direita para a esquerda, como árabe e hebraico. |
|
Especifica que o item de menu é um separador. Um separador de item de menu aparece como uma linha divisória horizontal. Os membros dwTypeData e cch são ignorados. Esse valor é válido apenas em um menu suspenso, submenu ou menu de atalho. |
|
Exibe o item de menu usando uma cadeia de caracteres de texto. O membro dwTypeData MFT_STRING é substituído por MIIM_STRING. |
fState
Tipo: UINT
O estado do item de menu. Esse membro pode ser um ou mais desses valores. Defina fMask para MIIM_STATE usar fState.
wID
Tipo: UINT
Um valor definido pelo aplicativo que identifica o item de menu. Defina fMask para MIIM_ID usar wID .
hSubMenu
Tipo: HMENU
Um identificador para o menu suspenso ou submenu associado ao item de menu. Se o item de menu não for um item que abra um menu suspenso ou submenu, esse membro será NULL. Defina fMask para MIIM_SUBMENU usar hSubMenu.
hbmpChecked
Tipo: HBITMAP
Um identificador para o bitmap a ser exibido ao lado do item se ele estiver selecionado. Se esse membro estiver NULL, um bitmap padrão será usado. Se o valor do tipo MFT_RADIOCHECK for especificado, o bitmap padrão será um marcador. Caso contrário, será uma marca de seleção. Defina fMask para MIIM_CHECKMARKS usar hbmpChecked.
hbmpUnchecked
Tipo: HBITMAP
Um identificador para o bitmap a ser exibido ao lado do item se ele não estiver selecionado. Se esse membro estiver NULL, nenhum bitmap será usado. Defina fMask para MIIM_CHECKMARKS usar hbmpUnchecked.
dwItemData
Tipo: ULONG_PTR
Um valor definido pelo aplicativo associado ao item de menu. Defina fMask para MIIM_DATA usar dwItemData.
dwTypeData
Tipo: LPTSTR
O conteúdo do item de menu. O significado desse membro depende do valor de
Para recuperar um item de menu do tipo MFT_STRING, primeiro localize o tamanho da cadeia de caracteres definindo o dwTypeData membro do MENUITEMINFO NULL e, em seguida, chamando GetMenuItemInfo. O valor de cch+1 é o tamanho necessário. Em seguida, aloque um buffer desse tamanho, coloque o ponteiro para o buffer em dwTypeData, incremente cche chame GetMenuItemInfo mais uma vez para preencher o buffer com a cadeia de caracteres. Se o item de menu recuperado for de algum outro tipo,
Ao usar com a função
cch
Tipo: UINT
O comprimento do texto do item de menu, em caracteres, quando as informações são recebidas sobre um item de menu do tipo MFT_STRING. No entanto,
Observe que, antes de chamar
O membro cch
hbmpItem
Tipo: HBITMAP
Um identificador para o bitmap a ser exibido ou pode ser um dos valores na tabela a seguir. Ele é usado quando o sinalizador de
| Valor | Significado |
|---|---|
|
Um bitmap desenhado pela janela que possui o menu. O aplicativo deve processar as mensagens WM_MEASUREITEM e WM_DRAWITEM. |
|
Botão Fechar para a barra de menus. |
|
Botão Fechar desabilitado para a barra de menus. |
|
Botão Minimizar para a barra de menus. |
|
Botão minimizar desabilitado para a barra de menus. |
|
Botão Restaurar para a barra de menus. |
|
Botão Fechar para o submenu. |
|
Botão Maximizar para o submenu. |
|
Botão Minimizar para o submenu. |
|
Botão Restaurar para o submenu. |
|
Ícone do Windows ou o ícone da janela especificada em dwItemData. |
Observações
A estrutura MENUITEMINFO
O menu pode exibir itens usando texto, bitmaps ou ambos.
Nota
O cabeçalho winuser.h define MENUITEMINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| cabeçalho | winuser.h (inclua Windows.h) |
Consulte também
Conceitual
InsertMenuItem
de referência de