GetMenuDefaultItem-Funktion (winuser.h)

  • Artikel

Bestimmt das Standardmenüelement im angegebenen Menü.

Syntax

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für das Menü, für das das Standardmenüelement abgerufen werden soll.

[in] fByPos

Typ: UINT

Gibt an, ob der Bezeichner oder die Position des Menüelements abgerufen werden soll. Wenn dieser Parameter FALSE ist, wird der Bezeichner zurückgegeben. Andernfalls wird die Position zurückgegeben.

[in] gmdiFlags

Typ: UINT

Gibt an, wie die Funktion nach Menüelementen suchen soll. Dieser Parameter kann null oder mehr der folgenden Werte sein.

Wert Bedeutung
GMDI_GOINTOPOPUPS
0x0002L
 Wenn das Standardelement ein Element ist, das ein Untermenü öffnet, besteht die Funktion darin, rekursiv im entsprechenden Untermenü zu suchen. Wenn das Untermenü kein Standardelement enthält, identifiziert der Rückgabewert das Element, das das Untermenü öffnet. Standardmäßig gibt die Funktion das erste Standardelement im angegebenen Menü zurück, unabhängig davon, ob es sich um ein Element handelt, das ein Untermenü öffnet.
GMDI_USEDISABLED
0x0001L
 Die Funktion gibt ein Standardelement zurück, auch wenn es deaktiviert ist. Standardmäßig überspringt die Funktion deaktivierte oder abgeblendete Elemente.

Rückgabewert

Typ: UINT

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Bezeichner oder die Position des Menüelements.

Wenn die Funktion fehlschlägt, ist der Rückgabewert -1. 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-menu-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

Menüs

Referenz

SetMenuDefaultItem