Classe CFrameWndEx

Artigo
08/25/2010

Implementa funcionalidade Windows de um único documento interface (SDI) sobrepostas ou janela de quadro de pop-up e fornece a membros para gerenciar a janela.Ele estende o CFrameWnd classe.

class CFrameWndEx : public CFrameWnd

Membros

Métodos públicos

Nome	Descrição
CFrameWndEx::ActiveItemRecalcLayout	Ajusta o layout do item de cliente OLE e área de cliente do quadro.
CFrameWndEx::AddDockSite	Esse método não é usado.
CFrameWndEx::AddPane	Registra uma BAR de controle com o Gerenciador de encaixe.
CFrameWndEx::AdjustDockingLayout	Recalcula o layout de todos os painéis são encaixada na janela do quadro.
CFrameWndEx::DelayUpdateFrameMenu	Define o menu de quadro e o atualiza quando o processamento do comando estiver ocioso.
CFrameWndEx::DockPane	Encaixa o painel especificado para a janela do quadro.
CFrameWndEx::DockPaneLeftOf	Encaixa um painel à esquerda de outro painel.
CFrameWndEx::EnableAutoHidePanes	Ativa o modo de ocultar automaticamente os painéis quando eles são encaixados para os lados da janela do quadro principal especificados.
CFrameWndEx::EnableDocking	Permite que o encaixe dos painéis que pertencem a janela do quadro.
CFrameWndEx::EnableFullScreenMainMenu	Mostra ou oculta o menu principal no modo de tela inteira.
CFrameWndEx::EnableFullScreenMode	Permite que o modo de tela inteira para a janela do quadro.
CFrameWndEx::EnableLoadDockState	Ativa ou desativa o carregamento do estado de encaixe.
CFrameWndEx::EnablePaneMenu	Ativa ou desativa a manipulação automático de menu do painel.
CFrameWndEx::GetActivePopup	Retorna um ponteiro para o menu pop-up exibido no momento.
CFrameWndEx::GetDefaultResId	Retorna a ID de recurso que você especificou quando a estrutura carregados a janela do quadro.
CFrameWndEx::GetDockingManager	Recupera o Classe CDockingManager objeto para a janela do quadro.
CFrameWndEx::GetMenuBar	Retorna um ponteiro para o BAR de menus objeto associado à janela do quadro.
CFrameWndEx::GetPane	Retorna um ponteiro para o painel que tenha a ID especificada.
CFrameWndEx::GetRibbonBar	Recupera o controle da BAR de faixa de opções do quadro.
CFrameWndEx::GetTearOffBars	Retorna uma lista de objetos painel que estão em um estado destacável.
CFrameWndEx::GetToolbarButtonToolTipText	Chamado pela estrutura quando o aplicativo exibirá a dica de ferramenta para um botão de barra de ferramentas.
CFrameWndEx::InsertPane	Registra um painel com o Gerenciador de encaixe.
CFrameWndEx::IsFullScreen	Determina se a janela do quadro está no modo de tela inteira.
CFrameWndEx::IsMenuBarAvailable	Determina se o ponteiro para o objeto de BAR de menu é válido.
CFrameWndEx::IsPointNearDockSite	Indica se o ponto está localizado em uma zona de alinhamento.
CFrameWndEx::IsPrintPreview	Indica se a janela do quadro está no modo de visualização de impressão.
CFrameWndEx::LoadFrame	Esse método é chamado após a construção para criar a janela do quadro e carregar seus recursos.
CFrameWndEx::NegotiateBorderSpace	Implementa OLE cliente borda negociação.
CFrameWndEx::OnActivate	A estrutura chama esse método quando a entrada do usuário é alternada para a ou afastando-a do quadro.
CFrameWndEx::OnActivateApp	Chamado pela estrutura quando o aplicativo é selecionado ou desmarcado.
CFrameWndEx::OnChangeVisualManager	Chamado pela estrutura quando uma alterar para o quadro requer uma alterar para o Gerenciador visual.
CFrameWndEx::OnClose	A estrutura chama esse método para fechar o quadro.
CFrameWndEx::OnCloseDockingPane	Chamado pela estrutura quando o usuário clica o Fechar botão em um painel de encaixe.
CFrameWndEx::OnCloseMiniFrame	Chamado pela estrutura quando o usuário clica o Fechar botão em uma janela de mini-quadro flutuante.
CFrameWndEx::OnClosePopupMenu	Chamado pela estrutura quando um menu pop-up ativo processa uma mensagem WM_DESTROY.
CFrameWndEx::OnCmdMsg	Despachos de mensagens de comando.
CFrameWndEx::OnContextHelp	Chamada pela estrutura exibir o contexto de Ajuda relacionados.
CFrameWndEx::OnCreate	Chamado pela estrutura depois que o quadro é criado.
CFrameWndEx::OnDestroy	Chamado pela estrutura quando o quadro é destruído.
CFrameWndEx::OnDrawMenuImage	Chamado pela estrutura quando o aplicativo desenha a imagem associada a um item de menu.
CFrameWndEx::OnDrawMenuLogo	Chamada pela estrutura quando um CMFCPopupMenu objeto processos um WM_PAINT mensagem.
CFrameWndEx::OnDWMCompositionChanged	Chamado pela estrutura quando composição DWM (área de trabalho janela Manager) foi habilitada ou desabilitado.
CFrameWndEx::OnExitSizeMove	Chamado pela estrutura quando pára o quadro movendo ou redimensionando.
CFrameWndEx::OnGetMinMaxInfo	Chamado pela estrutura quando o quadro é redimensionado para conjunto os limites de dimensão da janela.
CFrameWndEx::OnIdleUpdateCmdUI	Chamado pela estrutura para atualizar a exibição de quadro quando o processamento do comando estiver ocioso.
CFrameWndEx::OnLButtonDown	A estrutura chama esse método quando o usuário pressiona botão do mouse esquerdo do mouse.
CFrameWndEx::OnLButtonUp	A estrutura chama esse método quando o usuário solta botão do mouse esquerdo do mouse.
CFrameWndEx::OnMenuButtonToolHitTest	Chamada pela estrutura quando um CMFCToolBarButton objeto processos um WM_NCHITTEST mensagem.
CFrameWndEx::OnMenuChar	Chamado pela estrutura quando um menu é exibido e o usuário pressiona uma tecla que não corresponde a um comando.
CFrameWndEx::OnMouseMove	A estrutura chama esse método quando o ponteiro se move.
CFrameWndEx::OnMoveMiniFrame	Chamado pela estrutura quando se move de uma janela de painel.
CFrameWndEx::OnNcActivate	Chamada pela estrutura quando o não-área de cliente do quadro deve ser redesenhado para indicar uma alterar no estado ativo.
CFrameWndEx::OnNcCalcSize	Chamado pela estrutura quando o dimensionar e a posição da área de cliente devem ser calculados.
CFrameWndEx::OnNcHitTest	Chamado pela estrutura quando o ponteiro se move ou quando um botão do mouse é pressionado ou liberado.
CFrameWndEx::OnNcMouseMove	Chamado pela estrutura quando o ponteiro se move em uma área não cliente.
CFrameWndEx::OnNcPaint	Chamado pela estrutura quando a área de cliente não deve ser pintada.
CFrameWndEx::OnPaneCheck	Chamado pela estrutura para controlar a visibilidade de um painel.
CFrameWndEx::OnPostPreviewFrame	Chamado pela estrutura quando o usuário alterou o modo de visualização de impressão.
CFrameWndEx::OnPowerBroadcast	Chamado pela estrutura quando ocorre um evento de gerenciamento de potência.
CFrameWndEx::OnSetMenu	Chamado pela estrutura para substituir o menu da janela de quadro.
CFrameWndEx::OnSetPreviewMode	Chamado pela estrutura para conjunto o modo de visualização de impressão para o quadro.
CFrameWndEx::OnSetText	Chamado pela estrutura para conjunto o texto de uma janela.
CFrameWndEx::OnShowCustomizePane	Chamado pela estrutura quando uma rápida Personalizar painel está ativado.
CFrameWndEx::OnShowPanes	Chamado pela estrutura para mostrar ou ocultar painéis.
CFrameWndEx::OnShowPopupMenu	Chamado pela estrutura quando um menu pop-up estiver ativado.
CFrameWndEx::OnSize	A estrutura chama esse método após a alteração do dimensionar do quadro.
CFrameWndEx::OnSizing	A estrutura chama esse método quando o usuário redimensiona a quadro.
CFrameWndEx::OnSysColorChange	Chamado pela estrutura quando alterar as cores do sistema.
CFrameWndEx::OnTearOffMenu	Chamado pela estrutura quando um menu que tenha uma BAR destacável estiver ativado.
CFrameWndEx::OnToolbarContextMenu	Chamado pela estrutura para criar um menu de contexto da barra de ferramentas.
CFrameWndEx::OnToolbarCreateNew	A estrutura chama esse método para criar uma nova barra de ferramentas.
CFrameWndEx::OnToolbarDelete	Chamado pela estrutura quando uma barra de ferramentas é excluída.
CFrameWndEx::OnUpdateFrameMenu	Chamado pela estrutura para conjunto o menu do quadro.
CFrameWndEx::OnUpdateFrameTitle	A estrutura chama esse método para atualização BAR de título da janela do quadro.
CFrameWndEx::OnUpdatePaneMenu	Chamada pela estrutura para atualização o menu do painel.
CFrameWndEx::OnWindowPosChanged	Chamado pela estrutura quando o dimensionar do quadro, posição ou ordem z foram alteradas devido a uma telefonar para um método de gerenciamento de janela.
CFrameWndEx::PaneFromPoint	Retorna o painel de encaixe que contém o ponto especificado.
CFrameWndEx::PreTranslateMessage	Manipula mensagens de janela específico antes que eles são distribuídos.
CFrameWndEx::RecalcLayout	Ajusta o layout do quadro e suas janelas filho.
CFrameWndEx::RemovePaneFromDockManager	Cancela o registro de um painel e a remove da lista interna no Gerenciador de encaixe.
CFrameWndEx::SetDockState	Restaura o layout de encaixe para o estado de encaixe armazenado no registro.
CFrameWndEx::SetPrintPreviewFrame	Define a janela de quadro de visualização de impressão.
CFrameWndEx::SetupToolbarMenu	Insere comandos definida pelo usuário em um menu de barra de ferramentas.
CFrameWndEx::ShowFullScreen	Alterna o quadro principal entre a tela inteira e modos normais.
CFrameWndEx::ShowPane	Mostra ou oculta o painel especificado.
CFrameWndEx::UpdateCaption	Chamado pela estrutura para atualizar a legenda da quadro de janela.
CFrameWndEx::WinHelp	Invoca ambos o WinHelp aplicativo ou contexto relacionado ajuda.

Exemplo

O exemplo a seguir demonstra como herdar uma classe do CFrameWndEx classe. O exemplo ilustra as assinaturas de método na subclasse e como substituir o OnShowPopupMenu método. Neste trecho de código faz parte o Exemplo do WordPad: Aplicativo WordPad do MFC.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
    CMainFrame();
    DECLARE_DYNCREATE(CMainFrame)

// Attributes
public:
    HICON m_hIconDoc;
    HICON m_hIconText;
    HICON m_hIconWrite;
    HICON GetIcon(int nDocType);

// Operations
public:
    void UpdateMRUFilesList ()
    {
        m_wndTaskPane.UpdateMRUFilesList ();
    }

    void OnChangeLook ();

// Overrides
    // ClassWizard generated virtual function overrides
    //{{AFX_VIRTUAL(CMainFrame)
    public:
    virtual void ActivateFrame(int nCmdShow = -1);
    virtual BOOL LoadFrame(UINT nIDResource, DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE, CWnd* pParentWnd = NULL, CCreateContext* pContext = NULL);
    protected:
    virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
    virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
    //}}AFX_VIRTUAL

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

protected:
    void AdjustObjectSubmenu (CMFCPopupMenu* pMenuPopup);
    void AdjustColorsMenu (CMFCPopupMenu* pMenuPopup, UINT uiId);

// Implementation
public:
    virtual ~CMainFrame();
#ifdef _DEBUG
    virtual void AssertValid() const;
    virtual void Dump(CDumpContext& dc) const;
#endif

public:
    CMFCMenuBar m_wndMenuBar;
    CMFCToolBar m_wndToolBar;
    CMFCStatusBar   m_wndStatusBar;
    CFormatBar      m_wndFormatBar;
    CRulerBar       m_wndRulerBar;
    CTaskPane       m_wndTaskPane;

protected:  // control bar embedded members
    BOOL CreateMenuBar();
    BOOL CreateToolBar();
    BOOL CreateFormatBar();
    BOOL CreateStatusBar();
    BOOL CreateRulerBar();
    BOOL CreateTaskPane ();

// Generated message map functions
protected:
    //{{AFX_MSG(CMainFrame)
    afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
    afx_msg void OnSysColorChange();
    afx_msg void OnSize(UINT nType, int cx, int cy);
    afx_msg void OnMove(int x, int y);
    afx_msg void OnHelpFinder();
    afx_msg void OnDropFiles(HDROP hDropInfo);
    afx_msg void OnFontChange();
    afx_msg BOOL OnQueryNewPalette();
    afx_msg void OnPaletteChanged(CWnd* pFocusWnd);
    afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
    afx_msg void OnViewCustomize();
    afx_msg void OnViewFullScreen();
    //}}AFX_MSG
    afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
    afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
    afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
    afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
    afx_msg LRESULT OnToolbarCreateNew(WPARAM,LPARAM);
    afx_msg LRESULT OnGetDocumentColors(WPARAM,LPARAM);
    afx_msg void OnDummy();
    afx_msg void OnAskQuestion();
    DECLARE_MESSAGE_MAP()
};


...


BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    BOOL bRes = CFrameWndEx::OnShowPopupMenu (pMenuPopup);

    if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
    {
        AdjustObjectSubmenu (pMenuPopup);
        AdjustColorsMenu (pMenuPopup, ID_CHAR_COLOR);
    }

    return bRes;
}