InsertMenu

La funzione InsertMenu consente di inserire una nuova voce di menu in un menu, altri oggetti in movimento verso il basso il menu.

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

(BOOL InsertMenu HMENU  hMenu, / / handle al menuUINTuPosition, / / la voce del menu quel menu nuovo elemento precedeUINTuFlags, / / voce di menu flagsUINTuIDNewItem, / / menu item identificatore o gestire a discesa / / menu o sottomenuLPCTSTRlpNewItem / / la voce del menu contenuti);
 

Parametri

hMenu
Gestire il menu da modificare.
uPosition
Specifica la voce di menu prima che la nuova voce di menu è da inserire, come determinato dal parametro uFlags.
uFlags
Specifica i flag che controllano l'interpretazione del parametro uPosition e il contenuto, aspetto e del comportamento della nuova voce di menu. Questo parametro deve essere una combinazione di uno dei seguenti valori richiesti e almeno uno dei valori elencati nella seguente sezione Osservazioni.
Valore Descrizione
MF_BYCOMMAND Indica che il parametro uPosition dà l'identificatore della voce di menu. La bandiera MF_BYCOMMAND è il valore predefinito se viene specificato il flag MF_BYCOMMAND né MF_BYPOSITION.
MF_BYPOSITION Indica che il parametro uPosition dà la posizione relativa in base zero della nuova voce di menu. Se uPosition è 0xFFFFFFFF, la nuova voce di menu viene aggiunto alla fine del menu.

uIDNewItem
Specifica l'identificatore della nuova voce di menu o, se il parametro uFlags ha impostato il flag 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 della WM_MEASUREITEM o WM_DRAWITEM messaggio inviato quando viene creata la voce di menu o il suo aspetto è aggiornato.
MF_STRING Contiene un puntatore a una stringa null-terminated (predefinito).

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.

Nell'elenco seguente vengono descritti i flag che 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 (vedi SetMenuItemBitmaps), questo flag verrà visualizzata l'immagine bitmap di segno di spunta accanto alla voce di menu.
MF_DISABLED Disabilita la voce di menu, in modo che esso non può essere selezionato, ma esso non grigio.
MF_ENABLED Consente la voce di menu che possono essere selezionato 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 le barre 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 alla voce di menu (impostazione predefinita). Se l'applicazione fornisce le bitmap di segno di spunta (vedi la funzione 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: Windows CE non supporta il flag MF_BITMAP o il flag MF_DISABLED nel parametro uFlags . Voci di menu non possono essere disabilitate senza essere in grigio. Per disattivare una voce di menu utilizzare il flag MF_GRAYED.

Windows CE versione 1.0 non supporta il menu a cascata. Se si utilizza Windows CE 1.0, voi non può inserire un menu MF_POPUP in un altro menu a comparsa. Se si utilizza Windows CE 2.0 o versione successiva, è possibile.

Vedi anche

Panoramica di menu, Menu funzioni, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

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

Index