Funzione GetMenuBarInfo (winuser.h)

Articolo
03/13/2024

Recupera informazioni sulla barra dei menu specificata.

Sintassi

BOOL GetMenuBarInfo(
  [in]      HWND         hwnd,
  [in]      LONG         idObject,
  [in]      LONG         idItem,
  [in, out] PMENUBARINFO pmbi
);

Parametri

[in] hwnd

Tipo: HWND

Handle per la finestra (barra dei menu) le cui informazioni devono essere recuperate.

[in] idObject

Tipo: LONG

Oggetto menu. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
OBJID_CLIENT ((LONG)0xFFFFFFFC)	Menu popup associato alla finestra.
OBJID_MENU ((LONG)0xFFFFFFFD)	Barra dei menu associata alla finestra (vedere la funzione GetMenu ).
OBJID_SYSMENU ((LONG)0xFFFFFFFF)	Menu di sistema associato alla finestra (vedere la funzione GetSystemMenu ).

[in] idItem

Tipo: LONG

Elemento per il quale recuperare le informazioni. Se questo parametro è zero, la funzione recupera informazioni sul menu stesso. Se questo parametro è 1, la funzione recupera informazioni sulla prima voce del menu e così via.

[in, out] pmbi

Tipo: PMENUBARINFO

Puntatore a una struttura MENUBARINFO che riceve le informazioni. Si noti che è necessario impostare il membro cbSize su sizeof(MENUBARINFO) 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 informazioni dettagliate sull'errore, chiamare GetLastError.

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-misc-l1-5-0 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

Informazioni concettuali

GetMenu

GetSystemMenu

MENUBARINFO

Riferimento