Freigeben über


GetMenuBarInfo-Funktion (winuser.h)

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

GetMenu

GetSystemMenu

MENUBARINFO

Menüs

Referenz