CMenu:: AppendMenu

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

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

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0.

Parametri

nFlags

Specifica le informazioni sullo stato della nuova voce di menu quando viene aggiunto al menu. Esso consiste di uno o più dei valori elencati nella sezione Osservazioni.

nIDNewItem

Specifica l'ID di comando della nuova voce di menu o, se nFlags è impostato su MF_POPUP, la maniglia di menù (HMENU) di un menu a comparsa. Il parametro nIDNewItem viene ignorato (non necessaria) se nFlags è impostato su MF_SEPARATOR.

lpszNewItem

Specifica il contenuto della nuova voce di menu. Viene utilizzato il parametro nFlags per interpretare lpszNewItem nel seguente modo:

nFlags Interpretazione di lpszNewItem
MF_OWNERDRAW Contiene un valore fornito dal applicazione a 32-bit che l'applicazione può utilizzare per gestire i dati aggiuntivi associati con la voce di menu. Questo valore a 32 bit è disponibile all'applicazione quando elabora i messaggi WM_MEASUREITEM e WM_DRAWITEM . Il valore viene memorizzato nel membro della struttura fornito con quei messaggi itemData.
MF_STRING Contiene un puntatore a una stringa null-terminated. Questa è l'interpretazione predefinita.
MF_SEPARATOR Il parametro lpszNewItem viene ignorato (non serve).

pBmp

Punti a un oggetto CBitmap che verrà utilizzata come la voce di menu.

Osservazioni

Aggiunge un nuovo elemento alla fine di un menu. L'applicazione può specificare lo stato della voce di menu impostando valori nFlags. Quando nIDNewItem specifica un menu a comparsa, diventa parte del menu a cui è accodato. Se viene distrutto quel menu, il menu accodato anche sarà distrutti. Un menu accodato dovrebbe essere staccato da un oggetto CMenu per evitare conflitti. Notare che MF_STRING e MF_OWNERDRAW non sono validi per la versione bitmap di AppendMenu.

Nell'elenco seguente vengono descritti i flag che possono essere impostati nel nFlags:

Ciascuno dei seguenti gruppi elenca le bandiere che si escludono a vicenda e non possono essere utilizzate insieme:

Ogni volta che un menu che risiede in una finestra è cambiato (o non viene visualizzata la finestra), l'applicazione deve chiamare CWnd::DrawMenuBar.

CMenu panoramica |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index