AppendMenu

La funzione AppendMenu aggiunge un nuovo elemento alla fine della barra dei menu specificata, menu a discesa, sottomenu o menu di scelta rapida. È possibile utilizzare questa funzione per specificare il contenuto, l'aspetto e il comportamento della voce di menu.

La funzione AppendMenu è stata sostituita dalla funzione InsertMenuItem . È comunque possibile utilizzare AppendMenu, tuttavia, se non è necessario le funzionalità estese di InsertMenuItem.

 (BOOL AppendMenu HMENU  hMenu, / / handle al menu da modificareUINTuFlags, / / voci di menu flagsUINTuIDNewItem, / / identificatore di voci di menu o handle a discesa menu o sottomenuLPCTSTRlpNewItem / / contenuto della voce di menu);
 

Parametri

hMenu
Handle per la barra dei menu, menu a discesa, sottomenu o menu di scelta rapida da modificare.
uFlags
Specifica i flag per controllare l'aspetto e il comportamento della nuova voce di menu. Questo parametro può essere una combinazione dei valori elencati nella seguente sezione Osservazioni.
uIDNewItem
Specifica l'identificatore della nuova voce di menu o, se il parametro uFlags è impostato su MF_POPUP, l'handle per il menu a discesa menu o sottomenu.
lpNewItem
Specifica il contenuto della nuova voce di menu. L'interpretazione di lpNewItem dipende se il parametro uFlags include il flag MF_BITMAP, MF_OWNERDRAW o MF_STRING, come segue:
Valore Descrizione
MF_BITMAP Contiene un handle bitmap.
MF_OWNERDRAW Contiene un valore a 32 bit fornito dall'applicazione che può essere utilizzato per gestire i dati aggiuntivi relativi alla voce di menu. Il valore è nel membro itemData la struttura a cui puntata il parametro lparam del WM_MEASURE o il messaggio WM_DRAWITEM inviato quando viene creato il menu o il suo aspetto è aggiornato.
MF_STRING Contiene un puntatore a una stringa null-terminated.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

L'applicazione deve chiamare la funzione DrawMenuBar ogni volta che un menu varia, o meno il menu è in una finestra visualizzata.

Per ottenere i tasti di scelta rapida per lavorare con bitmap o voci di menu creati dal proprietario, il proprietario del menu deve elaborare il messaggio WM_MENUCHAR. Per ulteriori informazioni, vedere Owner-Drawn menu e il messaggio di WM_MENUCHAR.

I seguenti flag possono essere impostati nel parametro uFlags:

Valore Descrizione
MF_BITMAP Utilizza una bitmap come la voce di menu. Il parametro lpNewItem contiene l'handle alla bitmap.
MF_CHECKED Inserisce un segno di spunta accanto alla voce di menu. Se l'applicazione fornisce le bitmap di segno di spunta (v. SetMenuItemBitmaps, questo display bandiera bitmap di segno di spunta accanto alla voce di menu.
MF_DISABLED Disabilita la voce di menu, quindi non può essere selezionato, ma la bandiera non di grigio.
MF_ENABLED Consente la voce di menu, quindi può essere selezionata e Ripristina dal suo stato grigio.
MF_GRAYED Consente di disattivare la voce di menu e grigi e quindi non può essere selezionata.
MF_MENUBARBREAK Funzioni lo stesso come il MF_MENUBREAK bandiera per una barra dei menu. Per un menu a discesa, sottomenu o menu di scelta rapida, la nuova colonna è separata dalla vecchia colonna da una linea verticale.
MF_MENUBREAK Pone la voce su una nuova linea (per una barra dei menu) o in una nuova colonna (per un menu a discesa, sottomenu o menu di scelta rapida) senza separare colonne.
MF_OWNERDRAW Specifica che l'elemento è un elemento dal proprietario. Prima che il menu viene visualizzato per la prima volta, la finestra che possiede il menu riceve un messaggio WM_MEASUREITEM per recuperare la larghezza e l'altezza della voce di menu. Il messaggio WM_DRAWITEM viene quindi inviato alla routine della finestra della finestra proprietario ogni volta che l'aspetto della voce di menu deve essere aggiornato.
MF_POPUP Specifica che la voce di menu si apre un menu a discesa menu o sottomenu. Il parametro uIDNewItem specifica l'handle per il menu a discesa menu o sottomenu. Questo flag viene utilizzato per aggiungere un nome di menu a una barra dei menu, o una voce di menu che si apre un sottomenu in un menu a discesa, sottomenu o menu di scelta rapida.
MF_SEPARATOR Disegna una linea di divisione orizzontale. Questo flag viene utilizzato solo in un menu a discesa, sottomenu o menu di scelta rapida. La linea non può essere in grigio, disabilitata o evidenziata. Vengono ignorati i parametri lpNewItem e uIDNewItem.
MF_STRING Specifica che la voce di menu è una stringa di testo; il parametro lpNewItem punta alla stringa.
MF_UNCHECKED Non inserire un segno di spunta accanto all'elemento (impostazione predefinita). Se l'applicazione fornisce le bitmap di segno di spunta (vedi SetMenuItemBitmaps), questo flag consente di visualizzare l'immagine bitmap incontrollata accanto alla voce di menu.

I seguenti gruppi di bandiere non possono essere utilizzati insieme:

Windows CE: I flag seguenti non sono supportati per il parametro fuFlags

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED può essere utilizzato al posto di MF_DISABLED e MFS_GRAYED.

Windows CE 1.0 non supporta il menu a cascata. Se si utilizza Windows CE 1.0, è non è possibile inserire un menu MF_POPUP in un altro menu a comparsa.

In Windows CE 1.0, non sono supportati i seguenti flag:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Nelle versioni di Windows CE 2.0 e versioni successive, questi flag sono supportati. Sono supportati anche i menu a cascata.

Vedi anche

Panoramica di menu, Menu funzioni, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index