OleSetMenuDescriptor-Funktion (ole2.h)

  • Artikel

Installiert oder entfernt OLE-Verteilungscode aus dem Framefenster des Containers.

Syntax

HRESULT OleSetMenuDescriptor(
  [in] HOLEMENU                 holemenu,
  [in] HWND                     hwndFrame,
  [in] HWND                     hwndActiveObject,
  [in] LPOLEINPLACEFRAME        lpFrame,
  [in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);

Parameter

[in] holemenu

Handle mit dem zusammengesetzten Menüdeskriptor, der von der OleCreateMenuDescriptor-Funktion zurückgegeben wird. Bei NULL wird der Verteilungscode aufgehoben.

[in] hwndFrame

Handle mit dem Framefenster des Containers, in dem das direkte zusammengesetzte Menü installiert werden soll.

[in] hwndActiveObject

Handle mit dem direkten Aktivierungsfenster des Objekts. OLE sendet Menümeldungen und Befehle an dieses Fenster.

[in] lpFrame

Zeiger auf die IOleInPlaceFrame-Schnittstelle im Rahmenfenster des Containers.

[in] lpActiveObj

Zeiger auf die IOleInPlaceActiveObject-Schnittstelle für das aktive direkte Objekt.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück.

Hinweise

Der Container sollte OleSetMenuDescriptor aufrufen, um den Verteilercode auf hwndFrame zu installieren, wenn das Objekt die IOleInPlaceFrame::SetMenu-Methode aufruft, oder um den Verteilercode zu entfernen, indem NULL als Wert für holemenu an OleSetMenuDescriptor übergeben wird.

Wenn sowohl die Parameter lpFrame als auch lpActiveObj nicht NULL sind, installiert OLE den kontextabhängigen Hilfe-F1-Nachrichtenfilter für die Anwendung. Andernfalls muss die Anwendung einen eigenen Nachrichtenfilter bereitstellen.

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 ole2.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063)

Weitere Informationen

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor