AppendMenu

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);
 

Parâmetros

hMenu
Identificador para o barra de menus, drop-down menu, submenu ou menu atalho a ser alterado.
uFlags
Especifica os sinalizadores para controlar a aparência e o comportamento do novo item de menu. Este parâmetro pode ser uma combinação dos valores listados na seguinte seção Comentários.
uIDNewItem
Especifica ambos o identificador do novo item de menu ou, se a uFlags parâmetro está definido como MF_POPUP, o identificador para o drop-down menu ou submenu.
lpNewItem
Especifica o conteúdo do novo item de menu. A interpretação de lpNewItem depende se a uFlags parâmetro inclui o sinalizador MF_BITMAP, MF_OWNERDRAW ou MF_STRING, da seguinte forma:
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.

Retornar valores

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.

Observações

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.

Ver também

Visão geral de menus, funções de Menu, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index