GetMenuBarInfo, fonction (winuser.h)

Article
03/13/2024

Récupère des informations sur la barre de menus spécifiée.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre (barre de menus) dont les informations doivent être récupérées.

[in] idObject

Type : LONG

Objet de menu. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
OBJID_CLIENT ((LONG)0xFFFFFFFC)	Menu contextuel associé à la fenêtre.
OBJID_MENU ((LONG)0xFFFFFFFD)	Barre de menus associée à la fenêtre (voir la fonction GetMenu ).
OBJID_SYSMENU ((LONG)0xFFFFFFFF)	Menu système associé à la fenêtre (voir la fonction GetSystemMenu ).

[in] idItem

Type : LONG

Élément pour lequel récupérer des informations. Si ce paramètre est égal à zéro, la fonction récupère des informations sur le menu lui-même. Si ce paramètre est 1, la fonction récupère des informations sur le premier élément du menu, et ainsi de suite.

[in, out] pmbi

Type : PMENUBARINFO

Pointeur vers une structure MENUBARINFO qui reçoit les informations. Notez que vous devez définir le membre cbSize sur sizeof(MENUBARINFO) avant d’appeler cette fonction.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-5-0 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Conceptuel

Référence