CMenu:: AppendMenu

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem, const CBitmap * pBmp );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

nFlags

Especifica informações sobre o estado do item de menu novo quando ele é adicionado ao menu. Ele consiste em um ou mais dos valores listados na seção de comentários.

nIDNewItem

Especifica a identificação de comando do novo item de menu ou, se nFlags for definido como MF_POPUP, o identificador de menu (HMENU) de um menu pop-up. O parâmetro nIDNewItem será ignorado (não necessário) se nFlags for definido como MF_SEPARATOR.

lpszNewItem

Especifica o conteúdo do novo item de menu. O parâmetro nFlags é usado para interpretar lpszNewItem da seguinte forma:

nFlags	Interpretação dos lpszNewItem
MF_OWNERDRAW	Contém um valor 32 bits fornecido do aplicativo que o aplicativo pode usar para manter dados adicionais associados com o item de menu. Esse valor de 32 bits está disponível para o aplicativo quando ele processa mensagens WM_MEASUREITEM e WM_DRAWITEM . O valor é armazenado no itemData membro da estrutura fornecido com essas mensagens.
MF_STRING	Contém um ponteiro para uma Cadeia de caracteres terminada por caractere nulo. Esta é a interpretação do padrão.
MF_SEPARATOR	O parâmetro lpszNewItem é ignorado (não necessário).

pBmp

Aponta para um objeto CBitmap que será usado como o item de menu.

Observações

Acrescenta um novo item ao final de um menu. O aplicativo pode especificar o estado do item de menu por configuração valores em nFlags. Quando nIDNewItem especifica um menu pop-up, ele se torna parte do menu ao qual é acrescentado. Se esse menu for destruído, o menu anexado também será destruído. Um menu anexado deve ser desanexado de um objeto de CMenu para evitar conflitos. Observe que MF_STRING e MF_OWNERDRAW não são válidos para a versão de bitmap do AppendMenu.

A lista a seguir descreve os sinalizadores que podem ser definidos em nFlags:

MF_CHECKEDnbsp; Atua como umAlternar com MF_U&NCHECKED para colocar a marca de seleção padrão Avançar ao item. Quando o aplicativo fornece bitmaps de marca de verificação (consulte a função de membro SetMenuItemBitmaps ), o bitmap de "marca de seleção em" é exibido.
MF_U&NCHECKEDnbsp; Atua como umAlternar com MF_CHECKED para remover uma marca de seleção próxima ao item. Quando o aplicativo fornece bitmaps de marca de verificação (consulte a função de membro SetMenuItemBitmaps ), o bitmap de "marca de seleção desativar" é exibido.
MF_DISABLED Desabilita o item de menu para que ele não pode ser selecionado mas não dim-lo.
MF_E&NABLEDnbsp; Permite que o item de menu para que ele pode ser selecionado e restaura-la de seu estado esmaecido.
MF_GRAYED Desabilita o item de menu para que ele não pode ser selecionado e, são obscurecidas-lo.
MF_ME&NUBARBREAKnbsp; Coloca o item em uma Novo linha em menus estáticos ou em uma nova coluna nos menus pop-up. A nova coluna de menu pop-up será separada da coluna antiga por uma linha divisória vertical.
MF_ME&NUBREAKnbsp; Coloca o item em uma Novo linha em menus estáticos ou em uma nova coluna nos menus pop-up. Nenhuma linha divisória é colocada entre as colunas.
MF_OW&NERDRAWnbsp; Especifica que o item é um item de desenho proprietário. Quando o menu é exibido pela primeira vez, a janela que possui o menu recebe uma mensagem WM_MEASUREITEM , que recupera a altura e a largura do item de menu. A mensagem WM_DRAWITEM é aquela enviada sempre que o proprietário deve atualizar a aparência visual do item de menu. Esta opção não é válida para um item de menu de nível superior.
MF_POPUP Especifica que o item de menu tiver um menu pop-up associado com ele. O parâmetro ID Especifica um identificador para um menu pop-up que deve ser associado com o item. Isso é usado para adicionar um menu pop-up de nível superior ou um menu pop-up hierárquico para um item de menu pop-up.
MF_SEPARATOR Desenha uma linha divisória horizontal. Só pode ser usado em um menu pop-up. Esta linha não pode ser esmaecida, desabilitada ou realçada. Outros parâmetros são ignorados.
MF_STRI&NGnbsp; Especifica que o item de menu é uma Cadeia de caracteres.

Cada um dos grupos a seguir lista os sinalizadores que são mutuamente exclusivos e não podem ser usados juntos:

MF_DISABLED, MF_ENABLEDe MF_GRAYED
MF_STRING, MF_OWNERDRAW, MF_SEPARATORe a versão de bitmap
MF_MENUBARBREAK e MF_MENUBREAK
MF_CHECKED e MF_UNCHECKED

Sempre que um menu que reside em uma janela é alterado (se ou não a janela é exibida), o aplicativo deve chamar CWnd:: DrawMenuBar.

Visão geral de CMenu |nbsp; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CWnd:: DrawMenuBar, CMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index