Funzione GetMenuBarInfo (winuser.h)

  • Articolo

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

Menu

Riferimento