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);
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. |
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). |
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.
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.
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.