CMenu::AppendMenu

Artigo
08/25/2010

Acrescenta um novo item ao participante de um menu.

BOOL AppendMenu(
   UINT nFlags,
   UINT_PTR nIDNewItem = 0,
   LPCTSTR lpszNewItem = NULL 
);
BOOL AppendMenu(
   UINT nFlags,
   UINT_PTR nIDNewItem,
   const CBitmap* pBmp 
);

Parâmetros

nFlags
Especifica informações sobre o estado do novo item de menu quando ele é adicionado ao menu.Ele consiste em um ou mais dos valores listados na seção comentários.
nIDNewItem
Especifica a ID de comando do novo item de menu ou, se nFlags é conjunto para MF_POPUP, o identificador de menu (HMENU) de um menu pop-up. The nIDNewItem parâmetro é ignorado (não necessários) se nFlags é conjunto para MF_SEPARATOR.

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

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

pBmp
Aponta para um CBitmap objeto que será usado sistema autônomo o item de menu.

Valor de retorno

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

Comentários

O aplicativo pode especificar o estado do item de menu, definindo valores em nFlags. Quando nIDNewItem Especifica um menu pop-up, ele se torna parte do menu ao qual ele é acrescentado. Se esse menu é destruído, o menu acrescentado também será destruído.Um menu acrescentado deve ser desanexado de um CMenu objeto para evitar o conflito. Observe que MF_STRING and MF_OWNERDRAW inválido são válido para a versão do bitmap AppendMenu.

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

MF_CHECKED Funciona sistema autônomo uma alternância com MF_UNCHECKED para colocar a marca de seleção padrão próxima ao item.Quando o aplicativo fornece bitmaps de marca de seleção (consulte o SetMenuItemBitmapsfunção de membro ), o bitmap de "marca de seleção em" é exibido.
MF_UNCHECKED Funciona sistema autônomo uma alternância com MF_CHECKED para remover uma marca de seleção próxima ao item.Quando o aplicativo fornece bitmaps de marca de seleção (consulte o SetMenuItemBitmapsfunção de membro), 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 esmaecer.
MF_ENABLED Permite que o item de menu para que ele pode ser selecionado e restaura o estado esmaecido.
MF_GRAYED Desabilita o item de menu para que ele não pode ser selecionado e escurece a ele.
MF_MENUBARBREAK Posiciona o item em uma nova linha em menus estático 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_MENUBREAK Posiciona o item em uma nova linha em menus estático ou em uma nova coluna nos menus pop-up.Nenhuma linha divisória é colocada entre as colunas.
MF_OWNERDRAW Especifica que o item é um item de desenho proprietário. Quando o menu é exibido para o primeiro time, a janela que é proprietária do menu recebe um WM_MEASUREITEM mensagem, que recupera a altura e largura do item de menu. The WM_DRAWITEM mensagem será enviada sempre que o proprietário deve atualizar a aparência visual do item de menu. Essa opção inválido é válida para um item de menu de nível superior.
MF_POPUP Especifica que o item de menu tem um menu pop-up associado a ele.O parâmetro ID Especifica um identificador para um menu pop-up a ser associado ao item.Isso é usado para adicionar um menu pop-up de nível superior ou em um menu de pop-up hierárquico em um item de menu pop-up.
MF_SEPARATOR Desenha uma linha divisória horizontal.Só pode ser usado em um menu pop-up.Essa linha não pode ser esmaecida, desabilitado ou realçada.Outros parâmetros serão ignorados.
MF_STRING Especifica que o item de menu é uma seqüência de caractere.