GetMenuBarInfo-Funktion (winuser.h)

Artikel
03/04/2024

Ruft Informationen zur angegebenen Menüleiste ab.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Fenster (Menüleiste), dessen Informationen abgerufen werden sollen.

[in] idObject

Typ: LONG

Das Menüobjekt. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
OBJID_CLIENT ((LONG)0xFFFFFFFC)	Das Popupmenü, das dem Fenster zugeordnet ist.
OBJID_MENU ((LONG)0xFFFFFFFD)	Die Menüleiste, die dem Fenster zugeordnet ist (siehe getMenu-Funktion ).
OBJID_SYSMENU ((LONG)0xFFFFFFFF)	Das Systemmenü, das dem Fenster zugeordnet ist (siehe getSystemMenu-Funktion ).

[in] idItem

Typ: LONG

Das Element, für das Informationen abgerufen werden sollen. Wenn dieser Parameter null ist, ruft die Funktion Informationen über das Menü selbst ab. Wenn dieser Parameter 1 ist, ruft die Funktion Informationen zum ersten Element im Menü ab usw.

[in, out] pmbi

Typ: PMENUBARINFO

Ein Zeiger auf eine MENUBARINFO-Struktur , die die Informationen empfängt. Beachten Sie, dass Sie das cbSize-Element auf festlegen müssen, sizeof(MENUBARINFO) bevor Sie diese Funktion aufrufen.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-5-0 (eingeführt in Windows 10, Version 10.0.10240)

Siehe auch

Konzept

Referenz