EnableMenuItem
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função ativa ou desativa o item de menu especificado (cinza).
Syntax
BOOL EnableMenuItem(
HMENU hMenu,
UINT uIDEnableItem,
UINT uEnable
);
Parameters
- hMenu
[no] Identificador para o menu.
- uIDEnableItem
[no] O item de menu ser habilitado, desabilitado ou cinza, conforme determinado pelo uEnable parâmetro. Este parâmetro especifica um item em um menu barra, menu ou submenu.
uEnable
[no] Constantes que controle a interpretação das uIDEnableItem parâmetro e indicar se o item de menu é habilitado, desabilitado ou cinza. Este parâmetro deve ser uma combinação de pelo menos dois do seguinte:- MF_BYCOMMAND ou MF_BYPOSITION
- MF_ENABLED ou MF_GRAYED
Para obter informações sobre essas constantes, consulte Constantes menus.
Return Value
O valor de retorno especifica o estado anterior da item de menu (ele é o MF_ENABLED ou MF_GRAYED). 0xFFFFFFFF indica que o item de menu não existe.
Remarks
Um aplicativo deve usar o sinalizador MF_BYPOSITION para especificar o identificador menu correto. Se o identificador menu para o barra de menus for especificada, o de alto nível item de menu (um item na barra de menus) é afetado. Para definir o estado de um item em um drop-down menu ou submenu por posição, um aplicativo deve especificar o identificador para a drop-down menu ou submenu.
Quando um aplicativo especifica o sinalizador MF_BYCOMMAND, o sistema verifica todos os itens que aberto submenus no menu identificado pelo identificador de menu especificado. Portanto, a menos que duplicado menu itens estiverem presentes, especificando o identificador menu para o barra de menus é suficiente.
O InsertMenu e SetMenuItemInfo funções também podem definir o estado (habilitado ou cinza) de um item de menu.
Itens de menu não podem ser desativados sem sendo cinza. Para desativar um item de menu, use o sinalizador MF_GRAYED.
Requirements
| Header | winuser.h |
| Library | Menu.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |