CMenu::AppendMenu

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

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

Valor devuelto

Distinto de cero si la función es correcta; caso contrario 0.

Parámetros

nFlags

Especifica información sobre el estado del nuevo elemento de menú cuando se agrega al menú. Se compone de uno o más de los valores enumeran en la sección de comentarios.

nIDNewItem

Especifica el identificador de comando del nuevo elemento de menú o, si nFlags se establece en MF_POPUP, el identificador (HMENU) del menú de un menú emergente. El parámetro nIDNewItem se omite (no necesaria) si nFlags se establece en MF_SEPARATOR.

lpszNewItem

Especifica el contenido del elemento de menú nuevo. El parámetro nFlags se utiliza para interpretar lpszNewItem de la siguiente manera:

nFlags Interpretación de lpszNewItem
MF_OWNERDRAW Contiene un valor de 32 bits suministrados de aplicación que la aplicación puede utilizar para mantener información adicional asociada al elemento de menú. Este valor de 32 bits está disponible para la aplicación cuando procesa mensajes WM_MEASUREITEM y WM_DRAWITEM . El valor se almacena en el miembro itemData de la estructura que se suministra con esos mensajes.
MF_STRING Contiene un puntero a una cadena terminada en nulo. Esta es la interpretación predeterminada.
MF_SEPARATOR Se omite el parámetro lpszNewItem (no es necesario).

pBmp

Apunta a un objeto CBitmap que se utilizará como el elemento de menú.

Observaciones

Agrega un nuevo elemento al final de un menú. La aplicación puede especificar el estado del elemento de menú estableciendo valores en nFlags. NIDNewItem especifica un menú emergente, se convierte en parte del menú al que se adjunta. Si se destruye ese menú, el menú anexado también será destruido. Un menú anexado debe separa un objeto CMenu para evitar conflictos. Tenga en cuenta que no son válidos para la versión de mapa de bits de AppendMenu MF_STRING y MF_OWNERDRAW.

La lista siguiente describe los indicadores que se pueden establecer en nFlags:

Cada uno de los siguientes grupos de listas de indicadores que son mutuamente excluyentes y no pueden utilizarse juntos:

Cuando se cambia un menú que reside en una ventana (o no se muestra la ventana), la aplicación debe llamar a CWnd::DrawMenuBar.

Introducción a CMenu |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index