Shell_MergeMenus-Funktion (shlobj_core.h)

[Shell_MergeMenus ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Führt zwei Menüs zusammen.

Syntax

UINT Shell_MergeMenus(
  [in] HMENU hmDst,
  [in] HMENU hmSrc,
       UINT  uInsert,
       UINT  uIDAdjust,
       UINT  uIDAdjustMax,
       ULONG uFlags
);

Parameter

[in] hmDst

Typ: HMENU

Das Zielmenü, dem hmSrc hinzugefügt wird.

[in] hmSrc

Typ: HMENU

Das Quellmenü, das hmDst hinzugefügt wird.

uInsert

Typ: UINT

Der Punkt in hmDst , nach dem die Einträge in hmSrc eingefügt werden.

uIDAdjust

Typ: UINT

Diese Nummer wird der ID jedes Menüs hinzugefügt, um eine angepasste ID zu erhalten. Legen Sie für keine Anpassung auf fest 0 . Der Wert für uIDAdjust ist in der Regel die Anzahl der Elemente in hmDst. Diese Nummer kann mithilfe von GetMenuItemCount abgerufen werden.

uIDAdjustMax

Typ: UINT

Die maximale angepasste ID, die dem Menü hinzugefügt werden soll. Eine angepasste ID, die größer als dieser Wert ist, wird nicht hinzugefügt. Um alle IDs zuzulassen, legen Sie diesen Parameter auf 0xFFFF fest.

uFlags

Typ: ULONG

Mindestens eines der folgenden Flags:

MM_ADDSEPARATOR

Fügen Sie ein Trennzeichen zwischen den Elementen aus den beiden Menüs hinzu, falls noch keins vorhanden ist. Wenn Sie die Einträge von hmSrc in die Mitte von hmDst einfügen, wird ein Trennzeichen oberhalb und unterhalb des hmSrc-Materials hinzugefügt.

MM_DONTREMOVESEPS

Entfernen Sie keine vorhandenen Trennzeichen in den beiden Menüs. Beachten Sie, dass dies zu zwei Trennzeichen in einer Zeile führen kann.

MM_SUBMENUSHAVEIDS

Legen Sie dieses Flag fest, wenn die Untermenüs IDs aufweisen, die angepasst werden sollen.

Rückgabewert

Typ: UINT

Gibt die nächste geöffnete ID am Ende des Menüs zurück (die maximale angepasste ID + 1).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 6.0 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)