InsertMenu
9/9/2008
Essa função insere um novo item de menu em um menu, mover outros itens para baixo o menu.
Syntax
BOOL InsertMenu(
HMENU hMenu,
UINT uPosition,
UINT uFlags,
UINT uIDNewItem,
LPCTSTR lpNewItem
);
Parameters
- hMenu
[no] Identificador para o menu a ser alterada.
- uPosition
[no] O item de menu antes que o novo item de menu é a ser inserido, conforme determinado pelo uFlags parâmetro. Se uPosition é 0xFFFFFFFF, o novo item de menu é acrescentado ao final do menu.
uFlags
[no] Especifica os sinalizadores para controle a interpretação das uPosition parâmetro de de conteúdo, aparência e comportamento do novo item de menu. Este parâmetro deve ser uma combinação de um do exigido constantes MF_BYCOMMAND ou MF_BYPOSITION e pelo menos uma das outras constantes listadas no Constantes menus.Se este parâmetro inclui a constante MF_SEPARATOR, InsertMenu ignora os valores de lpNewItem e uIDNewItem Parâmetros. Se este parâmetro inclui a constante MF_STRING, o lpNewItem parâmetro aponta para o seqüência de caracteres.
- uIDNewItem
[no] Ambos o identificador do novo item de menu ou, se a uFlags parâmetro tem o MF_POPUP constante definida, o identificador para a drop-down menu ou submenu.
- lpNewItem
[no] Ponteiro longo para o de conteúdo de item de menu o novo. Se uFlags Inclui a constante MF_STRING, lpNewItem aponta para um seqüência de caracteres NULL-Terminated (o usar como padrão). Se uFlags Inclui a constante MF_OWNERDRAW, lpNewItem aponta para um 32-bit valor que pode ser usado para manter dados adicionais relacionado para o item de menu.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
O aplicativo deve chamar o DrawMenuBar função sempre que um menu for alterado, Whether or not o menu está em uma janela exibida.
Windows CE 1.0 e 1.01 não em cascata suporte menus. Se você estiver usando Windows CE 1.0 ou 1.01, não é possível inserir um menu MF_POPUP em outro menu pop-up. Se usar Windows CE 2.0 ou posterior, você pode.
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 |
See Also
Reference
AppendMenu
CreateMenu
DeleteMenu
RemoveMenu
WM_DRAWITEM
WM_MEASUREITEM
Menus Functions
Menus Constants