IOleInPlaceFrame::InsertMenus-Methode (oleidl.h)

  • Artikel

Ermöglicht dem Container das Einfügen von Menügruppen in das zusammengesetzte Menü, das während der direkten Sitzung verwendet werden soll.

Syntax

HRESULT InsertMenus(
  [in]      HMENU                hmenuShared,
  [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parameter

[in] hmenuShared

Ein Handle für ein leeres Menü.

[in, out] lpMenuWidths

Ein Zeiger auf ein OLEMENUGROUPWIDTHS-Array mit sechs Elementen. 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

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Hinweise für Anrufer

Diese Methode wird von Objektanwendungen aufgerufen, wenn sie zum ersten Mal aktiviert werden. Sie nennen es, um ihre Menüs in die Benutzeroberfläche auf Frameebene einzufügen.

Die Objektanwendung fordert den Container auf, seine Menüs dem in hmenuShared angegebenen Menü hinzuzufügen und die Gruppenanzahl im OLEMENUGROUPWIDTHS-Array festzulegen, auf das von lpMenuWidths verwiesen wird. Die Objektanwendung fügt dann eigene Menüs und Anzahlen hinzu. Objekte können IOleInPlaceFrame::InsertMenus 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 Menüelemente in den Dropdownmenüs.

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 oleidl.h

Weitere Informationen

IOleInPlaceFrame