OleSetMenuDescriptor
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função instala ou remove codificar distribuir OLE janela de quadro do contêiner.
Syntax
WINOLEAPI OleSetMenuDescriptor(
HOLEMENU holemenu,
HWND hwndFrame,
HWND hwndActiveObject,
LPOLEINPLACEFRAME lpFrame,
LPOLEINPLACEACTIVEOBJECT lpActiveObj
);
Parameters
holemenu
[no] Identificador para a composição descritor menu retornado pelo OleCreateMenuDescriptor função.Se NULL, o distribuir codificar é unhooked.
- hwndFrame
[no] Identificador para janela de quadro do contêiner onde o in-composição local menu deve ser instalado.
- hwndActiveObject
[no] Identificador para da o objeto janela in-place activation. OLE distribui mensagens menu e comandos para esta janela.
- lpFrame
[no] Ponteiro longo para o IOleInPlaceFrame interface no janela de quadro do contêiner.
- lpActiveObj
[no] Ponteiro longo para o IOleInPlaceActiveObject interface no ativo no-objeto local.
Return Value
O seguinte valores HRESULT podem ser retornados.
| Valor | Descrição |
|---|---|
S_OK |
O menu foi corretamente instalado. |
E_FAIL |
A função tem falha. |
E_INVALIDARG |
A função tem falha. |
E_UNEXPECTED |
A função tem falha. |
Remarks
O hwndActiveObject e o lpActiveObj Parâmetros não são com suporte. Definir como NULL.
O contêiner deve chamar OleSetMenuDescriptor Para instalar o codificar distribuir em hwndFrame Quando o objeto chama a IOleInPlaceFrame::SetMenu método, ou para remover a codificar distribuir passando NULL como o valor para holemenu Para OleSetMenuDescriptor.
Se a pasta lpFrame e lpActiveObj Os parâmetros são não-NULL, OLE instala o contextual ajuda filtro de mensagem F1 para o aplicativo. Caso contrário, o aplicativo deve fornecer seu próprio filtro mensagem.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | ole2.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |