Classe COleIPFrameWndEx

A COleIPFrameWndEx classe implementa um contêiner OLE que suporta MFC. Você deve derivar a classe de janela de quadro in-loco para seu aplicativo da COleIPFrameWndEx classe, em vez de derivá-la da classe COleIPFrameWnd . Para obter mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da instalação do Visual Studio.

Sintaxe

class COleIPFrameWndEx : public COleIPFrameWnd

Membros

Métodos Públicos

Métodos Protegidos

Exemplo

O exemplo a seguir demonstra como subclassificar uma instância da COleIPFrameWndEx classe e substituir seus métodos. O exemplo mostra como substituir o OnDestory método, o RepositionFrame método, o RecalcLayout método e o CalcWindowRect método. Este trecho de código faz parte do exemplo do Word Pad.

void CInPlaceFrame::OnDestroy()
{
   m_wndToolBar.DestroyWindow();
   m_wndFormatBar.DestroyWindow();
   COleIPFrameWndEx::OnDestroy();
}

void CInPlaceFrame::RepositionFrame(LPCRECT lpPosRect, LPCRECT lpClipRect)
{
   CRect rectNew = lpPosRect;
   rectNew.left -= HORZ_TEXTOFFSET;
   rectNew.top -= VERT_TEXTOFFSET;
   m_wndResizeBar.BringWindowToTop();
   COleIPFrameWndEx::RepositionFrame(&rectNew, lpClipRect);
   CWnd *pWnd = GetActiveView();
   if (pWnd != NULL)
      pWnd->BringWindowToTop();
   m_wndRulerBar.BringWindowToTop();
}

void CInPlaceFrame::RecalcLayout(BOOL bNotify)
{
   if (m_wndResizeBar.m_hWnd != NULL)
      m_wndResizeBar.BringWindowToTop();
   COleIPFrameWndEx::RecalcLayout(bNotify);
   CWnd *pWnd = GetActiveView();
   if (pWnd != NULL)
      pWnd->BringWindowToTop();
   if (m_wndRulerBar.m_hWnd != NULL)
      m_wndRulerBar.BringWindowToTop();

   // at least 12 pt region plus ruler if it exists
   CDisplayIC dc;
   CSize size;
   size.cy = MulDiv(12, dc.GetDeviceCaps(LOGPIXELSY), 72) + 1;
   size.cx = dc.GetDeviceCaps(LOGPIXELSX) / 4; // 1/4"
   size.cx += HORZ_TEXTOFFSET;                 //adjust for offset
   size.cy += VERT_TEXTOFFSET;
   if (m_wndRulerBar.m_hWnd != NULL && m_wndRulerBar.IsVisible())
   {
      CRect rect;
      m_wndRulerBar.GetWindowRect(&rect);
      size.cy += rect.Height();
   }
   m_wndResizeBar.SetMinSize(size);
}

void CInPlaceFrame::CalcWindowRect(LPRECT lpClientRect, UINT nAdjustType)
{
   COleIPFrameWndEx::CalcWindowRect(lpClientRect, nAdjustType);
}

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

COleIPFrameWnd

COleIPFrameWndEx

Requerimentos

Cabeçalho: afxoleipframewndex.h

COleIPFrameWndEx::AddDockSite

void AddDockSite();

Observações

COleIPFrameWndEx::AddPane

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail = TRUE);

Parâmetros

[em] pBarra de controlo
[em] bCauda

Valor de retorno

Observações

COleIPFrameWndEx::AdjustDockingLayout

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parâmetros

[em] HDWP

Observações

COleIPFrameWndEx::D ockPane

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Parâmetros

[em] pBar
[em] nDockBarID
[em] lpRect

Observações

COleIPFrameWndEx::D ockPaneLeftOf

Encaixa um painel à esquerda de outro.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parâmetros

pBar
[em] Um ponteiro para o painel para encaixar.

pLeftOf
[em] Um ponteiro para o painel que serve como origem.

Valor de retorno

Retorna TRUE se a operação for bem-sucedida. Caso contrário, retorna FALSE.

Observações

Chame esse método para encaixar vários objetos de painel em uma ordem predefinida. Este método encaixa o painel especificado por pBar à esquerda do painel especificado por pLeftOf.

COleIPFrameWndEx::EnableAutoHidePanes

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parâmetros

[em] dwDockStyle

Valor de retorno

Observações

COleIPFrameWndEx::EnableDocking

BOOL EnableDocking(DWORD dwDockStyle);

Parâmetros

[em] dwDockStyle

Valor de retorno

Observações

COleIPFrameWndEx::EnablePaneMenu

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly = FALSE,
    BOOL bViewMenuShowsToolbarsOnly = FALSE);

Parâmetros

[em] bAtivar
[em] uiCustomizeCmd
[em] strCustomizeLabel
[em] uiViewToolbarsMenuEntryID
[em] bContextMenuShowsToolbarsOnly
[em] bViewMenuShowsToolbarsOnly

Observações

COleIPFrameWndEx::GetActivePopup

Retorna um ponteiro para o menu pop-up exibido no momento.

CMFCPopupMenu* GetActivePopup() const;

Valor de retorno

Um ponteiro para o menu pop-up ativo; caso contrário, NULL.

Observações

Use esse método para obter um ponteiro para o objeto de classe CMFCPopupMenu que é exibido no momento.

COleIPFrameWndEx::GetContainerFrameWindow

COleCntrFrameWndEx* GetContainerFrameWindow();

Valor de retorno

Observações

COleIPFrameWndEx::GetDefaultResId

Retorna o ID do recurso de menu que foi especificado quando a janela do quadro carregou o menu.

UINT GetDefaultResId() const;

Valor de retorno

Retorna a ID do recurso do menu ou 0 se a janela do quadro não tiver barra de menus.

Observações

Chame essa função para recuperar o ID do recurso que foi especificado quando a janela do quadro carregou o recurso de menu chamando COleIPFrameWndEx::LoadFrame.

COleIPFrameWndEx::GetDockFrame

CFrameWnd* GetDockFrame();

Valor de retorno

Observações

COleIPFrameWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Valor de retorno

Observações

COleIPFrameWndEx::GetMainFrame

CFrameWnd* GetMainFrame();

Valor de retorno

Observações

COleIPFrameWndEx::GetMenuBar

Retorna um ponteiro para o objeto da barra de menus anexado à janela do quadro.

const CMFCMenuBar* GetMenuBar() const;

Valor de retorno

Um ponteiro para o objeto da barra de menus.

Observações

Use essa função para recuperar um ponteiro para o objeto da barra de menus que pertence ao COleIPFrameWndEx objeto.

COleIPFrameWndEx::GetPane

CBasePane* GetPane(UINT nID);

Parâmetros

[em] nID

Valor de retorno

Observações

COleIPFrameWndEx::GetTearOffBars

Retorna uma lista de objetos de painel que estão em um estado destacável.

const CObList& GetTearOffBars() const;

Valor de retorno

Uma referência a um CObList objeto que contém uma coleção de ponteiros para os objetos derivados da classe CBasePane.

Observações

O COleIPFrameWndEx objeto mantém a coleção de menus destacáveis como uma lista de objetos derivados da classe CBasePane. Use esse método para recuperar uma referência a essa lista.

COleIPFrameWndEx::GetToolbarButtonToolTipText

Chamado pela estrutura antes que a dica de ferramenta para um botão seja exibida.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parâmetros

pBotão
[em] Ponteiro para o botão.

strTTText
[em] Ponteiro para o texto da dica de ferramenta.

Valor de retorno

A implementação padrão retorna 0.

Observações

Substitua essa função para personalizar a exibição de dicas de ferramentas nos botões da barra de ferramentas.

COleIPFrameWndEx::InitUserToobars

Especifica um intervalo de IDs de controle que a estrutura atribui às barras de ferramentas definidas pelo usuário.

void InitUserToolbars(
    LPCTSTR lpszRegEntry,
    UINT uiUserToolbarFirst,
    UINT uiUserToolbarLast)

Parâmetros

lpszRegEntry
[em] A entrada do Registro onde a biblioteca armazena as configurações da barra de ferramentas do usuário.

uiUserToolbarFirst
[em] ID de controle atribuído à primeira barra de ferramentas definida pelo usuário.

uiUserToolbarLast
[em] ID de controle atribuído à última barra de ferramentas definida pelo usuário.

Observações

Use essa função para inicializar um intervalo de IDs de controle para atribuição a barras de ferramentas que os usuários definem dinamicamente. Os parâmetros uiUserToolbarFirst e uiUserToolbarLast definem um intervalo de IDs de controle de barra de ferramentas permitidos. Para desativar a criação de barras de ferramentas definidas pelo usuário, defina uiUserToolbarFirst ou uiUserToolbarLast como -1.

COleIPFrameWndEx::InsertPane

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parâmetros

[em] pBarra de controlo
[em] pAlvo
[em] bDepois

Valor de retorno

Observações

COleIPFrameWndEx::IsMenuBarDisponível

Determina se o ponteiro para o objeto da barra de menus não é NULL

BOOL IsMenuBarAvailable() const;

Valor de retorno

Retorna um valor diferente de zero se a janela do quadro tiver uma barra de menus; caso contrário, retorna 0.

Observações

Chame esse método para determinar se a janela de quadro mantém um ponteiro não-NULL para seu objeto de barra de menu.

COleIPFrameWndEx::IsPointNearDockSite

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parâmetros

[em] ponto
[em] dwBarAlignment
[em] bOuterEdge

Valor de retorno

Observações

COleIPFrameWndEx::LoadFrame

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parâmetros

[em] nIDResource
[em] dwDefaultStyle
[em] pParentWnd
[em] pContexto

Valor de retorno

Observações

COleIPFrameWndEx::OnCloseDockingPane

virtual BOOL OnCloseDockingPane(CDockablePane*);

Parâmetros

[em] CDockablePane*

Valor de retorno

Observações

COleIPFrameWndEx::OnCloseMiniFrame

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

Parâmetros

[em] CPaneFrameWnd*

Valor de retorno

Observações

COleIPFrameWndEx::OnClosePopupMenu

Chamado pela estrutura quando um menu pop-up ativo processa uma mensagem WM_DESTROY.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parâmetros

pMenuPopup
[em] Um ponteiro para o objeto de menu pop-up.

Observações

Substitua esse método para receber notificações de CMFCPopupMenu objetos quando eles processam mensagens WM_DESTROY.

COleIPFrameWndEx::OnCmdMsg

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parâmetros

[em] nID
[em] nCódigo
[em] pExtra
[em] pHandlerInfo

Valor de retorno

Observações

COleIPFrameWndEx::OnDrawMenuImage

Chamado pela estrutura quando a imagem associada a um item de menu é desenhada.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parâmetros

pDC
[em] Ponteiro para o contexto do dispositivo.

pMenuButton
[em] Ponteiro para o botão de menu.

rectImage
[em] A imagem associada ao item de menu.

Valor de retorno

A implementação padrão não faz nada e retorna 0.

Observações

Substitua esse método se desejar personalizar o desenho de imagem para os itens de menu que pertencem à barra de menus de propriedade do COleIPFrameWndExobjeto -derivado.

COleIPFrameWndEx::OnDrawMenuLogo

Chamado pela estrutura quando um objeto CMFCPopupMenu processa uma mensagem WM_PAINT.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Parâmetros

pDC
[em] Ponteiro para o contexto do dispositivo.

pMenu
[em] Ponteiro para o objeto de menu pop-up.

rectLogo
[em] Ponteiro para o logotipo a ser exibido.

Observações

Substitua esse método para exibir um logotipo no menu pop-up associado à barra de menus de propriedade do COleIPFrameWndExobjeto -derivado. A implementação padrão não faz nada.

COleIPFrameWndEx::OnMenuButtonToolHitTest

Chamado pela estrutura quando um objeto CMFCToolBarButton processa uma mensagem WM_NCHITTEST.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parâmetros

[in] pButton Ponteiro para um botão de menu.

[out] ponteiro pTI para uma TOOLINFO estrutura.

Valor de retorno

A implementação padrão não faz nada e retorna 0. Sua implementação deve retornar um valor diferente de zero se preencher o parâmetro pTI .

Observações

Substitua esse método para fornecer informações de dica de ferramenta sobre um item de menu específico.

COleIPFrameWndEx::OnMoveMiniFrame

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parâmetros

[em] pFrame

Valor de retorno

Observações

COleIPFrameWndEx::OnSetPreviewMode

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parâmetros

[em] bPré-visualização
[em] pEstado

Observações

COleIPFrameWndEx::OnShowCustomizePane

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parâmetros

[em] pMenuPane
[em] uiToolbarID

Valor de retorno

Observações

COleIPFrameWndEx::OnShowPanes

virtual BOOL OnShowPanes(BOOL bShow);

Parâmetros

[em] bShow

Valor de retorno

Observações

COleIPFrameWndEx::OnShowPopupMenu

Chamado pela estrutura quando um menu pop-up é exibido.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenuPopup);

Parâmetros

pMenuPopup
[em] Ponteiro para o menu pop-up a ser exibido.

Valor de retorno

A implementação padrão não faz nada e retorna um valor diferente de zero. Sua implementação deve retornar FALSE se o menu pop-up não puder ser exibido.

Observações

Substitua esse método para personalizar a exibição de um menu pop-up. Por exemplo, você pode alterar os botões de menu para colorir botões de menu ou inicializar barras destacáveis.

COleIPFrameWndEx::OnTearOffMenu

Chamado pela estrutura quando o usuário seleciona um menu que tem uma barra destacável.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parâmetros

pMenuPopup
[em] Um ponteiro para o menu pop-up que o usuário selecionou.

pBar
[em] Um ponteiro para o painel que hospeda o menu.

Valor de retorno

TRUE se você quiser que a estrutura ative o menu pop-up; caso contrário, FALSE. O valor padrão é TRUE.

Observações

Substitua esta função se quiser personalizar a configuração da barra destacável.

COleIPFrameWndEx::P aneFromPoint

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parâmetros

[em] ponto
[em] nSensibilidade
[em] bExactBar
[em] pRTCBarType
[em] dwAlinhamento

Valor de retorno

Observações

COleIPFrameWndEx::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

[em] pMsg

Valor de retorno

Observações

COleIPFrameWndEx::RecalcLayout

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

[em] bNotificar

Observações

COleIPFrameWndEx::RemovePaneFromDockManager

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parâmetros

[em] pBarra de controlo
[em] bDestruir
[em] bAjustarLayout
[em] bAutoOcultar
[em] pBarSubstituição

Observações

COleIPFrameWndEx::SetDockState

Aplica o estado de encaixe especificado aos painéis que pertencem à janela do quadro.

void SetDockState(const CDockState& state);

Parâmetros

estado
[em] Especifica o estado de encaixe.

Observações

Use esta função para especificar um novo estado de encaixe para painéis que pertencem ao COleIPFrameWndEx objeto.

COleIPFrameWndEx::SetupToolbarMenu

Modifica um objeto da barra de ferramentas pesquisando itens fictícios e substituindo-os pelos itens especificados definidos pelo usuário.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parâmetros

Cardápio
[em] Uma referência a um objeto CMenu a ser modificado.

uiViewUserToolbarCmdFirst
[em] Especifica o primeiro comando definido pelo usuário.

uiViewUserToolbarCmdLast
[em] Especifica o último comando definido pelo usuário.

Observações

COleIPFrameWndEx::ShowPane

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parâmetros

[em] pBar
[em] bShow
[em] bDelay
[em] bActivate

Observações

COleIPFrameWndEx::WinHelpA

Chamado pela estrutura para iniciar o aplicativo WinHelp ou ajuda de contexto.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parâmetros

[in] dwData Especifica os dados conforme necessário para o tipo de ajuda especificado pelo nCmd.

nCmd
[em] Especifica o tipo de ajuda solicitada. Para obter uma lista de valores possíveis e como eles afetam o parâmetro dwData , consulte a função WinHelp no SDK do Windows.

Observações

Ver também

Gráfico de Hierarquia
Aulas
Classe CFrameWndEx
CMDIFrameWndEx Classe