Funzione GetMenuItemInfoA (winuser.h)

Articolo
11/20/2024

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 del 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 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 ricevere informazioni sulla voce di menu. Si noti che è necessario impostare il membro cbSize su 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 estese sull'errore, usare la funzione GetLastError.

Osservazioni

Per recuperare una voce di menu di tipo MFT_STRING, individuare 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 di uno e quindi chiamare GetMenuItemInfo nuovamente 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 fTypefType e imposta cch su 0.

Esempi

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

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

Vedere anche

concettuale

riferimento

SetMenuItemInfo

Condividi tramite