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:

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

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