|
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
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
