Funzione InsertMenuItemA (winuser.h)

Articolo
11/20/2024

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 del 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 di elemento. Se questo parametro è FALSE, voce è un identificatore di voce di menu. In caso contrario, si tratta di una posizione della voce di menu. Per altre informazioni, vedere Accesso a 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 estese sull'errore, usare la funzione GetLastError.

Osservazioni

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é gli acceleratori di tastiera funzionino con le voci di menu bitmap o create dal proprietario, il proprietario del menu deve elaborare il messaggio WM_MENUCHAR. Per altre informazioni, vedere Owner-Drawn Menu e WM_MENUCHAR Message.

Esempi

Per un esempio, vedere esempio di bitmap 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)

Vedere anche

concettuale

DrawMenuBar

MENUITEMINFO

riferimento

Condividi tramite