IOleInPlaceFrame::SetMenu
在窗口框架容器对象被激活的位置安装复合菜单。
HRESULT SetMenu(
HMENU hmenuShared, //复合菜单句柄
HOLEMENU holemenu, //菜单描述符句柄
HWND hwndActiveObject //对象的窗口句柄
);
参数
hmenuShared
通过调用IOleInPlaceFrame::InsertMenus和Windows InsertMenu函数建造的菜单句柄。
holemenu
OleCreateMenuDescriptor函数返回的菜单描述符的句柄。
hwndActiveObject
拥有对象的窗口及接收菜单消息,命令和加速键的窗口的句柄。
返回值
这个方法支持标准返回值E_INVALIDARG和E_UNEXPECTED,也支持下列:
S_OK
方法被成功完成。
注释
调用者注意
对象调用IOleInPlaceFrame::SetMenu去告诉容器通过IOleInPlaceFrame::InsertMenus去安装复合菜单结构。
实现注意
一个SDI容器的这个方法的实现应该调用Windows的SetMenu函数。一个MDI窗口应该发送一个WM_MDISETMENU消息,使用hmenuShared作为菜单去安装。容器应该调用OleSetMenuDescriptor去安装OLE调度代码。
当不活动时,容器必须调用IOleInPlaceFrame::SetMenu,指定NULL去移去共享菜单。这帮助重绘最小化窗口。容器也应该调用OleSetMenuDescriptor,指定NULL去解下调度代码。最后,对象应用程序调用OleDestroyMenuDescriptor去释放数据结构。
注意 当执行IOleInPlaceFrame::SetMenu时,不能调用Windows的PeekMessage或GetMessage函数,或一个对话框。如果这样做了,系统可以死机。在SetMenu中可以调用的OLE界面方法和函数还有更多的限制。
快速信息
Windows NT: 3.1或更高版本。
Windows: Windows 95或更高版本。
Windows CE: 不支持。
Header: oleidl.h。
参见
IOleInPlaceFrame::InsertMenus, OleSetMenuDescriptor, OleDestroyMenuDescriptor
Win32中PeekMessage,GetMessage