Funzione InsertMenuItemA (winuser.h)
Inserisce una nuova voce di menu nella posizione specificata in un menu.
Sintassi
BOOL InsertMenuItemA(
[in] HMENU hmenu,
[in] UINT item,
[in] BOOL fByPosition,
[in] LPCMENUITEMINFOA lpmi
);
Parametri
[in] hmenu
Tipo: HMENU
Handle per il menu in cui viene inserita la nuova voce di menu.
[in] item
Tipo: UINT
Identificatore o posizione della voce di menu prima del quale inserire la nuova voce. Il significato di questo parametro dipende dal valore di fByPosition.
[in] fByPosition
Tipo: BOOL
Controlla il significato dell'elemento. Se questo parametro è FALSE, l'elemento è un identificatore di voce di menu. In caso contrario, si tratta di una posizione della voce di menu. Per altre informazioni, vedere Accesso alle voci di menu a livello di codice .
[in] lpmi
Tipo: LPCMENUITEMINFO
Puntatore a una struttura MENUITEMINFO che contiene informazioni sulla nuova voce di menu.
Valore restituito
Tipo: BOOL
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 sull'errore estese, usare la funzione GetLastError .
Commenti
L'applicazione deve chiamare la funzione DrawMenuBar ogni volta che viene modificato un menu, indipendentemente dal fatto che il menu si trova in una finestra visualizzata.
Affinché i tasti di scelta rapida funzionino con le voci di menu bitmap o disegnate dal proprietario, il proprietario del menu deve elaborare il messaggio WM_MENUCHAR . Per altre informazioni, vedere Menu creati dal proprietario e il messaggio WM_MENUCHAR .
Esempio
Per un esempio, vedere Esempio di bitmap di Menu-Item.
Nota
L'intestazione winuser.h definisce InsertMenuItem come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-menu-l1-1-1 (introdotto in Windows 8.1) |
Vedi anche
Informazioni concettuali
Riferimento