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