Compartilhar via


Função OleSetMenuDescriptor (ole2.h)

Instala ou remove o código de expedição OLE da janela de quadro do contêiner.

Sintaxe

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

Parâmetros

[in] holemenu

Identificador para o descritor de menu composto retornado pela função OleCreateMenuDescriptor . Se FOR NULL, o código de expedição não será exibido.

[in] hwndFrame

Manipule para a janela de quadros do contêiner em que o menu composto in-loco deve ser instalado.

[in] hwndActiveObject

Identificador para a janela de ativação in-loco do objeto. O OLE envia mensagens de menu e comandos para essa janela.

[in] lpFrame

Ponteiro para a interface IOleInPlaceFrame na janela de quadros do contêiner.

[in] lpActiveObj

Ponteiro para a interface IOleInPlaceActiveObject no objeto in-loco ativo.

Retornar valor

Essa função retorna S_OK em caso de êxito.

Comentários

O contêiner deve chamar OleSetMenuDescriptor para instalar o código de expedição em hwndFrame quando o objeto chamar o método IOleInPlaceFrame::SetMenu ou para remover o código de expedição passando NULL como o valor de holemenu para OleSetMenuDescriptor.

Se os parâmetros lpFrame e lpActiveObj não forem NULL, o OLE instalará o filtro de mensagem F1 de ajuda contextual para o aplicativo. Caso contrário, o aplicativo deve fornecer seu próprio filtro de mensagem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-5 (introduzido no Windows 10, versão 10.0.15063)

Confira também

Ioleinplaceactiveobject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor