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) |