A função AppendMenu acrescenta um novo item ao final da barra de menus especificado, soltar-para baixo menu, submenu ou menu de atalho. Você pode usar esta função para especificar o conteúdo, aparência e comportamento do item de menu.
A função AppendMenu foi substituída pela função InsertMenuItem . Você ainda pode usar AppendMenu, no entanto, se você não precisa de nenhum dos recursos estendidos do InsertMenuItem.
(BOOL AppendMenu HMENU hMenu, / / identificador para menu a ser alteradoUINTuFlags, / / item de menu sinalizadoresUINTuIDNewItem, / / item de menu identificador ou identificador para a drop-down menu ou submenuLPCTSTRlpNewItem / / conteúdo do item de menu);
| Valor | Descrição |
|---|---|
| MF_BITMAP | Contém um identificador de bitmap. |
| MF_OWNERDRAW | Contém um valor de 32 bits fornecido pelo aplicativo que pode ser usado para manter dados adicionais relacionados ao item de menu. O valor está no itemData membro da estrutura apontado pelo lparam parâmetro do WM_MEASURE ou mensagem WM_DRAWITEM enviada quando o menu é criado ou sua aparência é atualizada. |
| MF_STRING | Contém um ponteiro para uma Cadeia de caracteres terminada por caractere nulo. |
Se a função for bem-sucedido, o valor de retorno é diferente de zero.
Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.
O aplicativo deve chamar o DrawMenuBar função sempre que um menu muda, ou não o menu está em uma janela exibida.
Para get aceleradores de teclado para trabalhar com bitmap ou owner-drawn menu itens, o proprietário do menu deve processo a mensagem WM_MENUCHAR. Para obter mais informações, consulte Owner-Drawn Menus e a mensagem de WM_MENUCHAR.
Os seguintes sinalizadores podem ser definidos in a uFlags parâmetro:
| Valor | Descrição |
|---|---|
| MF_BITMAP | Usa um bitmap como o item de menu. O lpNewItem parâmetro contém o identificador para o bitmap. |
| MF_CHECKED | Coloca uma marca de seleção próxima ao item de menu. Se o aplicativo fornece bitmaps de marca de verificação (consulte SetMenuItemBitmaps, este exibe bandeira de bitmap a marca de seleção próxima ao item de menu. |
| MF_DISABLED | Desabilita o item de menu assim que ele não pode ser selecionado, mas o Sinalizar não cinza-lo. |
| MF_ENABLED | Permite que o item de menu para que ele pode ser selecionado e restaura-lo de seu estado sombreado. |
| MF_GRAYED | Desabilita o item de menu e grays-lo para que ele não pode ser selecionado. |
| MF_MENUBARBREAK | Funções, o mesmo que o MF_MENUBREAK sinalizador para uma barra de menus. Para um drop-down menu, submenu ou menu de atalho, a nova coluna separada da coluna antiga por uma linha vertical. |
| MF_MENUBREAK | Coloca o item em uma Novo linha (para uma barra de menus) ou em uma nova coluna (para um drop-down menu, submenu ou menu de atalho) sem separar colunas. |
| MF_OWNERDRAW | Especifica que o item é um item owner-drawn. Antes que o menu é exibido pela primeira vez, a janela que possui o menu recebe uma mensagem WM_MEASUREITEM para recuperar a largura e a altura do item de menu. A mensagem WM_DRAWITEM , em seguida, é enviada para o procedimento janela da janela de proprietário, sempre que a aparência do item de menu deve ser atualizada. |
| MF_POPUP | Especifica que o item de menu abre um Soltar-para baixo menu ou submenu. O parâmetro uIDNewItem especifica o identificador para o drop-down menu ou submenu. Este sinalizador é usado para adicionar um nome de menu para uma barra de menus ou um item de menu que abre um submenu para um drop-down menu, submenu ou menu de atalho. |
| MF_SEPARATOR | Desenha uma linha divisória horizontal. Este sinalizador é usado somente em um drop-down menu, submenu ou menu de atalho. A linha não pode ser cinza, desabilitada ou realçada. Os lpNewItem e uIDNewItem parâmetros são ignorados. |
| MF_STRING | Especifica que o item de menu é uma Cadeia de caracteres de texto; o lpNewItem parâmetro aponta para a seqüência de caracteres. |
| MF_UNCHECKED | Não colocar uma marca de seleção próxima ao item (padrão). Se o aplicativo fornece bitmaps de marca de verificação (consulte SetMenuItemBitmaps), este sinalizador exibe o bitmap desmarcado próximo para o item de menu. |
Os seguintes grupos de sinalizadores não podem ser usados juntos:
Windows CE: Não há suporte para os seguintes sinalizadores para o parâmetro fuFlags
MF_BITMAP
MF_DISABLED
MFS_GRAYED
MF_GRAYED pode ser usado no lugar de MF_DISABLED e MFS_GRAYED.
Windows CE 1.0 não suporta menus em cascata. Se você estiver usando o Windows CE 1.0, você não pode inserir um menu MF_POPUP em outro menu pop-up.
Em Windows CE 1.0, os seguintes sinalizadores não são suportados:
MF_POPUP
MF_MENUBREAK
MF_MENUBARBREAK
Em versões do Windows CE 2.0 e posteriores, esses sinalizadores são com suporte. Menus em cascata também são suportados.
Visão geral de menus, funções de Menu, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps