OleSetMenuDescriptor

Installs or removes OLE dispatching code from the container's frame window.

HRESULT OleCreateMenuDescriptor(

HOLEMENU holemenu,	//Handle to the composite menu descriptor
HWND hwndFrame,	//Handle to the container's frame window
HWND hwndActiveObject,	//Handle to the object's in-place activation window
LPOLEINPLACEFRAME lpFrame,	//Container's frame window
LPOLEINPLACEACTIVEOBJECT lpActiveObj	//Active in-place object
);

Parameters
holemenu
Specifies the handle to the composite menu descriptor returned by the OleCreateMenuDescriptor function. If NULL, the dispatching code is unhooked.

hwndFrame
Specifies the handle to the container's frame window where the in-place composite menu is to be installed.

hwndActiveObject
Specifies the handle to the object's in-place activation window. OLE dispatches menu messages and commands to this window.

lpFrame

Points to the container's frame window.

lpActiveObj

Points to the active in-place object.

Return Values
S_OK

Indicates the menu was installed correctly.

E_INVALIDARG

Indicates one or more arguments are invalid.

E_UNEXPECTED

Indicates an unexpected error occurred.

E_FAIL

Indicates a Windows function call failed, indicating a resource allocation failure or improper arguments.

Comments
The container should call OleSetMenuDescriptor to install the dispatching code on hwndFrame when the object calls the IOleInPlaceFrame::SetMenu method, or to remove the dispatching code by passing NULL as the value for holemenu to OleSetMenuDescriptor.

OLE installs the context-sensitive help F1 message filter for the application if both the lpFrame and lpActiveObj parameters are non-NULL. Otherwise, the application must supply its own message filter.

See Also
OleCreateMenuDescriptor, IOleInPlaceFrame::SetMenu

Software for developers: Delphi Components
.Net Components
Software for Android Developers
More information resources: MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers: Amazon Categories Database
Browse Nodes Database