EnableMenuItem

O EnableMenuItem função habilita, desabilita ou grays o item de menu especificado.

(BOOL EnableMenuItem HMENU  hMenu, / / identificador para o menuUINTuIDEnableItem, / / item de menu para ativar, desativar ou cinzaUINTuEnable / / item de menu sinalizadores);
 

Parâmetros

hMenu

Identificador para o menu.

uIDEnableItem

Especifica o item de menu para ser ativado, desativado ou acinzentada, conforme determinado pelo parâmetro uEnable . Esse parâmetro especifica um item em uma barra de menus, um menu ou um submenu.

uEnable

Especifica os sinalizadores que controlam a interpretação do parâmetro uIDEnableItem e indicam se o item de menu é habilitado, desabilitado ou acinzentado. Este parâmetro deve ser uma combinação de MF_BYCOMMAND ou MF_BYPOSITION e MF_ENABLED, MF_DISABLED ou MF_GRAYED.

Valor	Significado
MF_BYCOMMAND	Indica que uIDEnableItem dá o identificador do item de menu. Se nem o MF_BYCOMMAND ou MF_BYPOSITION Sinalizar for especificado, o Sinalizar MF_BYCOMMAND é a bandeira de padrão.
MF_BYPOSITION	Indica que uIDEnableItem dá o relativo posição baseada em zero do item de menu.
MF_DISABLED	Indica que o item de menu é desativado mas não cinza, para que ele não pode ser selecionado.
MF_ENABLED	Indica que o item de menu é habilitado e restaurado a partir de um estado sombreado para que ele pode ser selecionado.
MF_GRAYED	Indica que o item de menu é desativado e acinzentado para que ele não pode ser selecionado.

Retornar valores

O valor de retorno especifica o estado anterior do item de menu (é MF_DISABLED, MF_ENABLED ou MF_GRAYED). Se o item de menu não existir, o valor de retorno é 0xFFFFFFFF.

Observações

Um aplicativo deve usar o sinalizador MF_BYPOSITION para especificar o identificador menu correto. Se o identificador menu para o barra de menus for especificado, o item de menu de nível superior (um item na barra de menus) é afetado. Para definir o estado de um item em um menu drop-down ou submenu por posição, um aplicativo deve especificar o identificador para o drop-down menu ou submenu.

Quando um aplicativo especifica o Sinalizar MF_BYCOMMAND, o sistema verifica todos os itens que abrem submenus no menu identificado pelo identificador de menu especificado. Portanto, a menos que itens de menu duplicados estejam presentes, especificando o identificador menu para o barra de menus é suficiente.

O InsertMenu, InsertMenuItem LoadMenuIndirect, ModifyMenue funções SetMenuItemInfo também podem definir o Estado (habilitado, desabilitado ou acinzentado) de um item de menu.

Windows CE: Windows CE não oferece suporte a bandeira MF_DISABLED para o parâmetro de uEnable . Itens de menu não podem ser desativados sem ser acinzentado. Para desativar um item de menu usar o sinalizador MF_GRAYED.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de menus, funções de Menu, GetMenuItemID, InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifyMenu, SetMenuItemInfo, WM_SYSCOMMAND