Función OleSetMenuDescriptor (ole2.h)

Instala o quita el código de envío OLE de la ventana de marco del contenedor.

Sintaxis

HRESULT OleSetMenuDescriptor(
  [in] HOLEMENU                 holemenu,
  [in] HWND                     hwndFrame,
  [in] HWND                     hwndActiveObject,
  [in] LPOLEINPLACEFRAME        lpFrame,
  [in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);

Parámetros

[in] holemenu

Identificador del descriptor de menú compuesto devuelto por la función OleCreateMenuDescriptor . Si es NULL, el código de distribución se desenganchó.

[in] hwndFrame

Controle la ventana de marco del contenedor donde se va a instalar el menú compuesto local.

[in] hwndActiveObject

Controle la ventana de activación local del objeto. OLE envía mensajes de menú y comandos a esta ventana.

[in] lpFrame

Puntero a la interfaz IOleInPlaceFrame en la ventana de marco del contenedor.

[in] lpActiveObj

Puntero a la interfaz IOleInPlaceActiveObject del objeto activo en contexto.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente.

Comentarios

El contenedor debe llamar a OleSetMenuDescriptor para instalar el código de distribución en hwndFrame cuando el objeto llama al método IOleInPlaceFrame::SetMenu o para quitar el código de distribución pasando NULL como valor de holemenu a OleSetMenuDescriptor.

Si los parámetros lpFrame y lpActiveObj no son NULL, OLE instala el filtro de mensajes F1 de ayuda contextual para la aplicación. De lo contrario, la aplicación debe proporcionar su propio filtro de mensajes.

Requisitos

Consulte también

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor