OleSetMenuDescriptor 函式 (ole2.h)
從容器的框架視窗中安裝或移除 OLE 分派程式代碼。
語法
HRESULT OleSetMenuDescriptor(
[in] HOLEMENU holemenu,
[in] HWND hwndFrame,
[in] HWND hwndActiveObject,
[in] LPOLEINPLACEFRAME lpFrame,
[in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);
參數
[in] holemenu
OleCreateMenuDescriptor 函式所傳回之複合功能表描述元的句柄。 如果 為 NULL,則會取消分派程式代碼。
[in] hwndFrame
要安裝就地複合功能表的容器框架視窗句柄。
[in] hwndActiveObject
物件就地啟用視窗的句柄。 OLE 會將功能表訊息和命令分派至此視窗。
[in] lpFrame
容器框架視窗上 IOleInPlaceFrame 介面的指標。
[in] lpActiveObj
使用中就地物件上 IOleInPlaceActiveObject 介面的指標。
傳回值
此函式會在成功時傳回S_OK。
備註
當物件呼叫 IOleInPlaceFrame::SetMenu 方法時,容器應該呼叫 OleSetMenuDescriptor,以在 hwndFrame 上安裝分派程式代碼,或將 NULL 當做 OleSetMenuDescriptor 的值傳遞至 OleSetMenuDescriptor 來移除分派程序代碼。
如果 lpFrame 和 lpActiveObj 參數都是非 NULL,OLE 會安裝應用程式的上下文相關說明 F1 訊息篩選。 否則,應用程式必須提供自己的訊息篩選。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ole2.h |
程式庫 | Ole32.lib |
Dll | Ole32.dll |
API 集合 | ext-ms-win-com-ole32-l1-1-5 (於 Windows 10 10.0.15063 版) |