Funzione GetMenuItemInfoW (winuser.h)

Articolo
08/27/2023

Recupera informazioni su una voce di menu.

Sintassi

BOOL GetMenuItemInfoW(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOW lpmii
);

Parametri

[in] hmenu

Tipo: HMENU

Handle al menu contenente la voce di menu.

[in] item

Tipo: UINT

Identificatore o posizione della voce di menu per ottenere informazioni su. Il significato di questo parametro dipende dal valore di fByPosition.

[in] fByPosition

Tipo: BOOL

Significato di uItem. Se questo parametro è FALSE, uItem è un identificatore di voce di menu. In caso contrario, è una posizione della voce di menu. Per altre informazioni, vedere Accesso a voci di menu a livello di codice .

[in, out] lpmii

Tipo: LPMENUITEMINFO

Puntatore a una struttura MENUITEMINFO che specifica le informazioni da recuperare e riceve informazioni sulla voce di menu. Si noti che è necessario impostare il membro cbSize su sizeof(MENUITEMINFO) prima di chiamare questa funzione.

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

Per recuperare una voce di menu di tipo MFT_STRING, trovare prima le dimensioni della stringa impostando il membro dwTypeData di MENUITEMINFO su NULL e quindi chiamando GetMenuItemInfo. Il valore cch+1 è la dimensione necessaria. Allocare quindi un buffer di questa dimensione, posizionare il puntatore al buffer in dwTypeData, aumentare cch per uno e quindi chiamare GetMenuItemInfo una volta di nuovo per riempire il buffer con la stringa.

Se la voce di menu recuperata è di un altro tipo, GetMenuItemInfo imposta il membro dwTypeData su un valore il cui tipo è specificato dal membro fType fType e imposta cch su 0.

Esempio

Per un esempio, vedere Esempio di Owner-Drawn voci di menu.

Nota

L'intestazione winuser.h definisce GetMenuItemInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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-3 (introdotta in Windows 10, versione 10.0.14393)

Vedi anche

Informazioni concettuali

Riferimento

SetMenuItemInfo

Condividi tramite