Поделиться через


Функция 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 об успешном выполнении.

Комментарии

Контейнер должен вызвать OleSetMenuDescriptor , чтобы установить код диспетчеризации в hwndFrame , когда объект вызывает метод IOleInPlaceFrame::SetMenu , или удалить код диспетчеризации, передав значение NULL в качестве значения holemenu в OleSetMenuDescriptor.

Если параметры lpFrame и lpActiveObj не имеют значения NULL, OLE устанавливает для приложения фильтр сообщений F1 контекстной справки. В противном случае приложение должно предоставить собственный фильтр сообщений.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ole2.h
Библиотека Ole32.lib
DLL Ole32.dll
Набор API ext-ms-win-com-ole32-l1-1-5 (представлен в Windows 10 версии 10.0.15063)

См. также раздел

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor