在窗口框架容器对象被激活的位置安装复合菜单。
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
