Partilhar via


Classe IOleInPlaceActiveObjectImpl

Essa classe fornece métodos para auxiliar a comunicação entre um controle in-loco e seu contêiner.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

template<class T>
class IOleInPlaceActiveObjectImpl

Parâmetros

T
Sua classe, derivada de IOleInPlaceActiveObjectImpl.

Membros

Métodos públicos

Nome Descrição
IOleInPlaceActiveObjectImpl::ContextSensitiveHelp Habilita a ajuda contextual. A implementação da ATL retorna E_NOTIMPL.
IOleInPlaceActiveObjectImpl::EnableModeless Habilita caixas de diálogo sem janela restrita. A implementação da ATL retorna S_OK.
IOleInPlaceActiveObjectImpl::GetWindow Obtém um identificador de janela.
IOleInPlaceActiveObjectImpl::OnDocWindowActivate Notifica o controle quando a janela do documento do contêiner é ativada ou desativada. A implementação da ATL retorna S_OK.
IOleInPlaceActiveObjectImpl::OnFrameWindowActivate Notifica o controle quando a janela do quadro de nível superior do contêiner é ativada ou desativada. A implementação da ATL retorna
IOleInPlaceActiveObjectImpl::ResizeBorder Informa o controle que é necessário redimensionar suas bordas. A implementação da ATL retorna S_OK.
IOleInPlaceActiveObjectImpl::TranslateAccelerator Processa mensagens de tecla de aceleração do menu do contêiner. A implementação da ATL retorna E_NOTIMPL.

Comentários

A interface IOleInPlaceActiveObject auxilia a comunicação entre um controle in-loco e seu contêiner; por exemplo, comunicando o estado ativo do controle e do contêiner e informando ao controle que necessário que ele se redimensione. A classe IOleInPlaceActiveObjectImpl fornece uma implementação padrão de IOleInPlaceActiveObject e dá suporte a IUnknown enviando informações para o dispositivo de despejo em builds de depuração.

Artigos relacionados Tutorial da ATL, criando um projeto da ATL

Hierarquia de herança

IOleInPlaceActiveObject

IOleInPlaceActiveObjectImpl

Requisitos

Cabeçalho: atlctl.h

IOleInPlaceActiveObjectImpl::ContextSensitiveHelp

Habilita a ajuda contextual.

HRESULT ContextSensitiveHelp(BOOL fEnterMode);

Valor de retorno

Retorna E_NOTIMPL.

Comentários

Confira IOleWindow::ContextSensitiveHelp no SDK do Windows.

IOleInPlaceActiveObjectImpl::EnableModeless

Habilita caixas de diálogo sem janela restrita.

HRESULT EnableModeless(BOOL fEnable);

Valor de retorno

Returns S_OK.

Comentários

Confira IOleInPlaceActiveObject::EnableModeless no SDK do Windows.

IOleInPlaceActiveObjectImpl::GetWindow

O contêiner chama essa função para obter o identificador de janela do controle.

HRESULT GetWindow(HWND* phwnd);

Comentários

Alguns contêineres não funcionarão com um controle que já foi sem janelas, mesmo que esteja em janela no momento. Na implementação da ATL, se o membro de dados CComControl::m_bWasOnceWindowless for TRUE, a função retornará E_FAIL. Caso contrário, se * phwnd não for NULL, GetWindow atribuirá phwnd ao membro de dados m_hWnd da classe de controle e retornará S_OK.

Confira IOleWindow::GetWindow no SDK do Windows.

IOleInPlaceActiveObjectImpl::OnDocWindowActivate

Notifica o controle quando a janela do documento do contêiner é ativada ou desativada.

HRESULT OnDocWindowActivate(BOOL fActivate);

Valor de retorno

Returns S_OK.

Comentários

Confira IOleInPlaceActiveObject::OnDocWindowActivate no SDK do Windows.

IOleInPlaceActiveObjectImpl::OnFrameWindowActivate

Notifica o controle quando a janela do quadro de nível superior do contêiner é ativada ou desativada.

HRESULT OnFrameWindowActivate(BOOL fActivate);

Valor de retorno

Returns S_OK.

Comentários

Confira IOleInPlaceActiveObject::OnFrameWindowActivate no SDK do Windows.

IOleInPlaceActiveObjectImpl::ResizeBorder

Informa o controle que é necessário redimensionar suas bordas.

HRESULT ResizeBorder(
    LPRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fFrameWindow);

Valor de retorno

Returns S_OK.

Comentários

Confira IOleInPlaceActiveObject::ResizeBorder no SDK do Windows.

IOleInPlaceActiveObjectImpl::TranslateAccelerator

Processa mensagens de tecla de aceleração do menu do contêiner.

HRESULT TranslateAccelerator(LPMSG lpmsg);

Valor de retorno

Esse método dá suporte aos seguintes valores retornados:

S_OK se a mensagem foi traduzida com êxito.

S_FALSE se a mensagem não foi traduzida.

Comentários

Confira IOleInPlaceActiveObject::TranslateAccelerator no SDK do Windows.

Confira também

Classe CComControl
Interfaces de controles ActiveX
Visão geral da aula