Funzione SetMenuItemInfoA (winuser.h)

Articolo
03/04/2024

Modifica le informazioni su una voce di menu.

Sintassi

BOOL SetMenuItemInfoA(
  [in] HMENU            hmenu,
  [in] UINT             item,
       BOOL             fByPositon,
  [in] LPCMENUITEMINFOA lpmii
);

Parametri

[in] hmenu

Tipo: HMENU

Handle per il menu che contiene la voce di menu.

[in] item

Tipo: UINT

Identificatore o posizione della voce di menu da modificare. Il significato di questo parametro dipende dal valore di fByPosition.

fByPositon

[in] lpmii

Tipo: LPMENUITEMINFO

Puntatore a una struttura MENUITEMINFO che contiene informazioni sulla voce di menu e specifica gli attributi delle voci di menu da modificare.

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 Owner-Drawn voci di menu.

Nota

L'intestazione winuser.h definisce SetMenuItemInfo 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

Requisito	Valore
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-0 (introdotto in Windows 8)