Funzione GetMenuItemInfoA (winuser.h)

Articolo
08/27/2023

Recupera informazioni su una voce di menu.

Sintassi

BOOL GetMenuItemInfoA(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOA 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 per ottenere informazioni. 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, si tratta di una posizione della voce di menu. Per altre informazioni, vedere Accesso alle voci di menu a livello di codice .

[in, out] lpmii

Tipo: LPMENUITEMINFO

Puntatore a una struttura MENUITEMINFO che specifica le informazioni da recuperare e ricevere 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 di cch+1 è la dimensione necessaria. Allocare quindi un buffer di questa dimensione, posizionare il puntatore al buffer in dwTypeData, incrementare cch per uno e quindi chiamare nuovamente GetMenuItemInfo 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 viene 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 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-3 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

Informazioni concettuali

Riferimento

SetMenuItemInfo