GetMenuState

O GetMenuState função recupera os sinalizadores de menu associados com a item de menu especificado. Se o item do menu abre um submenu, essa função também retorna o número de itens no submenu.

A função GetMenuState foi substituída pela GetMenuItemInfo função. Você ainda pode usar GetMenuState, no entanto, se você não precisa de nenhum dos recursos estendidos do GetMenuItemInfo.

(UINT GetMenuState HMENU  hMenu, / / identificador para o menuUINTuId, / / menu item para consulta UINTuFlags / / menu de bandeiras);
 

Parâmetros

hMenu
Identificador para o menu que contém o item de menu cujas sinalizadores são a serem recuperados.
uId
Especifica o item de menu para o qual os sinalizadores de menu devem ser recuperadas, conforme determinado pelo uFlags parâmetro.
uFlags
Especifica como o parâmetro uId é interpretado. Este parâmetro pode ser uma dos seguinte valores:
Valor Descrição
MF_BYCOMMAND Indica que o parâmetro uId fornece o identificador do item de menu. O Sinalizar MF_BYCOMMAND é o padrão se nem o MF_BYCOMMAND ou MF_BYPOSITION Sinalizar for especificado.
MF_BYPOSITION Indica que o parâmetro uId oferece o relativo posição baseada em zero do item de menu.

Retornar valores

Se o item especificado não existir, o valor de retorno é 0xFFFFFFFF.

Se o item do menu abre um submenu, a baixa byte de ordem o valor de retorno contém os sinalizadores de menu associados com o item, e o alto byte ordem contém o número de itens no submenu abertos por item.

Caso contrário, o valor de retorno é uma máscara (booleano ou) de sinalizadores de menu. A seguir estão os sinalizadores de menu associados com o item de menu.

Valor Descrição
MF_CHECKED Coloca uma marca de seleção próxima ao item (para Soltar suspensa menus, submenus e menus de atalho apenas).
MF_DISABLED Desabilita o item de.
MF_GRAYED Desativa e grays o item.
MF_HILITE Destaca o item.
MF_MENUBARBREAK Funções que o mesmo que o MF_MENUBREAK sinalizador, exceto para Soltar suspensa menus, submenus e menus de atalho, onde a nova coluna separada da coluna antiga por uma linha vertical.
MF_MENUBREAK Coloca o item em uma Novo linha (para barras de menus) ou em uma nova coluna (para Soltar suspensa menus, submenus e menus de atalho) sem separar colunas.
MF_SEPARATOR Cria uma linha divisória horizontal (para Soltar suspensa menus, submenus e menus de atalho apenas).

Ver também

Visão geral de menus, funções de Menu, GetMenu, GetMenuItemCount, GetMenuItemID, GetMenuItemInfo

Index