AppendMenu

9/9/2008

Essa função acrescenta um novo item ao final do menu especificado. Você pode usar AppendMenu Para especificar a de conteúdo, aparência e o comportamento da item de menu.

Syntax

BOOL AppendMenu(
  HMENU hMenu, 
  UINT uFlags, 
  UINT uIDNewItem, 
  LPCTSTR lpNewItem 
); 

Parameters

• hMenu
  [no] Identificador para o barra de menus, drop-down menu, submenu ou menu atalho a ser alterada.

• uFlags
  [no] Especifica os sinalizadores para controle de aparência e comportamento do novo item de menu. Este parâmetro deve ser uma combinação dos valores listados na Constantes menus.

  Se este parâmetro inclui a constante MF_SEPARATOR, AppendMenu 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 está definido como MF_POPUP, 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 quando altera um menu, Whether or not o menu está em uma janela exibida.

Para get aceleradores de teclado para trabalho com bitmap ou Owner-drawn menu itens, o proprietário do menu deve processo a WM_MENUCHAR mensagem.

Windows CE 1.0 não em cascata suporte menus. Se você estiver usando Windows CE 1.0, não é possível inserir um menu MF_POPUP em outro menu pop-up. No Windows CE 2.0 e posterior, em cascata os menus são com suporte.

Requirements

Header	winuser.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateMenu
DeleteMenu
DestroyMenu
InsertMenu
RemoveMenu
WM_DRAWITEM
WM_MEASUREITEM
WM_MENUCHAR
Menus Functions
Menus Constants