IShellBrowser::InsertMenusSB-Methode (shobjidl_core.h)

Artikel
03/04/2024

Ermöglicht es dem Container, seine Menügruppen in das zusammengesetzte Menü einzufügen, das angezeigt wird, wenn ein erweiterter Namespace angezeigt oder verwendet wird.

Syntax

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parameter

hmenuShared

Typ: HMENU

Ein Handle für ein leeres Menü.

lpMenuWidths

Typ: LPOLEMENUGROUPWIDTHS

Die Adresse eines OLEMENUGROUPWIDTHS-Arrays mit sechs LONG-Werten . Der Container füllt die Elemente 0, 2 und 4 aus, um die Anzahl der Menüelemente in den Menügruppen Datei, Ansicht und Fenster widerzuspiegeln.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-definierten Fehlerwert zurück.

Hinweise

Diese Methode ähnelt der IOleInPlaceFrame::InsertMenus-Methode . Windows Explorer fügt die Dropdownmenüs "Datei" und "Bearbeiten" in die Menügruppe Datei, die Menüs "Ansicht" und "Extras" in der Menügruppe "Container" und ein Menü "Hilfe" in der Menügruppe Fenster ein. Jedes Dropdownmenü enthält einen eindeutigen Bezeichner, FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP. Die Ansicht darf Menüelemente anhand ihrer Bezeichner in diese Untermenüs einfügen, was sich vom direkten Aktivierungsmechanismus von OLE unterscheidet. Die Befehlsbezeichner für Menüs, die die Ansicht entweder in die Untermenüs von Windows Explorer oder ihre eigenen Untermenüs einfügt, müssen sich zwischen FCIDM_SHVIEWFIRST und FCIDM_SHVIEWLAST befinden.

Hinweise zum Aufrufen von Anwendungen

Diese Methode wird von Namespaceerweiterungen aufgerufen, wenn sie zum ersten Mal aktiviert werden, damit sie ihre Menüs in die Benutzeroberfläche auf Frameebene einfügen können.

Die Objektanwendung fordert den Container auf, seine Menüs dem menü hinzuzufügen, das im hmenuShared-Parameter angegeben ist, und die Gruppenanzahl im OLEMENUGROUPWIDTHS-Array festzulegen, auf das der parameter lpMenuWidths verweist. Die Objektanwendung fügt dann eigene Menüs und Anzahlen hinzu. Objekte können die IOleInPlaceFrame::InsertMenus-Methode so oft wie nötig aufrufen, um die zusammengesetzten Menüs zu erstellen. Der Container sollte das anfängliche Menühandle verwenden, das dem zusammengesetzten Menü zugeordnet ist, für alle Elemente in den Dropdownmenüs.

Hinweise für Implementierer

Bei IShellBrowser-Implementierungen müssen sich die Menübezeichner im Bereich von FCIDM_BROWSERFIRSTFCIDM_BROWSERLAST.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über