Classe de CFrameWndEx

Artigo
02/25/2013

Implementa a funcionalidade de uma interface janela pop-up ou sobrepostos de (SDI) do único documento do windows de quadro chave, e fornece membros para gerenciar a janela.Estende a classe de CFrameWnd .

class CFrameWndEx : public CFrameWnd

Membros

Métodos públicos

Nome	Descrição
CFrameWndEx::ActiveItemRecalcLayout	Ajustar o layout de item OLE de cliente e da área cliente do quadro.
CFrameWndEx::AddDockSite	Este método não é usado.
CFrameWndEx::AddPane	Registra uma barra de controle com o gerenciador de encaixe.
CFrameWndEx::AdjustDockingLayout	Recalcula o layout de todos os painéis que estejam conectados a janela do quadro.
CFrameWndEx::DelayUpdateFrameMenu	Define o menu e então atualizações do quadro ele quando o processamento de comando estiver ocioso.
CFrameWndEx::DockPane	Insere o painel especificado para a janela do quadro.
CFrameWndEx::DockPaneLeftOf	Plug-ins um painel à esquerda de outro painel.
CFrameWndEx::EnableAutoHidePanes	Ativar o modo de incrementos ocultar os painéis para quando especificados estão conectados aos lados da janela de quadro chave.
CFrameWndEx::EnableDocking	Permite que o encaixe de painéis que pertencem a janela do quadro.
CFrameWndEx::EnableFullScreenMainMenu	Mostra ou oculta o menu principal em um modo de tela inteira.
CFrameWndEx::EnableFullScreenMode	Ativar o modo de tela inteira para a janela do quadro.
CFrameWndEx::EnableLoadDockState	Habilita ou desabilita a carga de estado de encaixe.
CFrameWndEx::EnablePaneMenu	Habilita ou desabilita a tratamento automático do menu do painel.
CFrameWndEx::GetActivePopup	Retorna um ponteiro para o menu pop-up atualmente exibido.
CFrameWndEx::GetDefaultResId	Retorna a identificação de recursos que você especificou quando a estrutura carregou a janela do quadro.
CFrameWndEx::GetDockingManager	Retorna o objeto de Classe de CDockingManager para a janela do quadro.
CFrameWndEx::GetMenuBar	Retorna um ponteiro para o objeto de barra de menu conectado à janela do quadro.
CFrameWndEx::GetPane	Retorna um ponteiro para o painel que tem um certo ID
CFrameWndEx::GetRibbonBar	Recupera o controle de barra de fita para o quadro.
CFrameWndEx::GetTearOffBars	Retorna uma lista de objetos de painel que está em um estado de rasgo - fora.
CFrameWndEx::GetToolbarButtonToolTipText	Chamado pela estrutura quando o aplicativo para exibir a dica de ferramenta para um botão da barra de ferramentas.
CFrameWndEx::InsertPane	Registra um painel com o gerenciador de encaixe.
CFrameWndEx::IsFullScreen	Determina se a janela de quadro estiver no modo de tela inteira.
CFrameWndEx::IsMenuBarAvailable	Determina se o ponteiro ao objeto de barra de menu é válido.
CFrameWndEx::IsPointNearDockSite	Indica se o ponto está localizado em uma zona de alinhamento.
CFrameWndEx::IsPrintPreview	Indica se a janela de quadro está no modo de visualização de impressão.
CFrameWndEx::LoadFrame	Este método é chamado depois da compilação para criar a janela do quadro e carregar seus recursos.
CFrameWndEx::NegotiateBorderSpace	Negociação OLE da borda do cliente implementa.
CFrameWndEx::OnActivate	A estrutura chama esse método quando a entrada do usuário é ou trocada fora do quadro.
CFrameWndEx::OnActivateApp	Chamado pela estrutura quando o aplicativo é selecionado ou deselecionada.
CFrameWndEx::OnChangeVisualManager	Chamado pela estrutura quando uma alteração para o quadro exigir uma alteração 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 no botão de Fechar em um painel de encaixe.
CFrameWndEx::OnCloseMiniFrame	Chamado pela estrutura quando o usuário clica no botão de Fechar em uma janela mini flutuante do quadro.
CFrameWndEx::OnClosePopupMenu	Chamado pela estrutura quando um menu pop-up ativa processar uma mensagem de WM_DESTROY.
CFrameWndEx::OnCmdMsg	Mensagens de comando de expedições.
CFrameWndEx::OnContextHelp	Chamado pela estrutura para exibir o contexto relacionadas a ajuda.
CFrameWndEx::OnCreate	Chamado pela estrutura do quadro é criado.
CFrameWndEx::OnDestroy	Chamado pela estrutura quando o quadro é destruído.
CFrameWndEx::OnDrawMenuImage	Chamado pela estrutura quando o aplicativo desenhar a imagem associada a um item de menu.
CFrameWndEx::OnDrawMenuLogo	Chamado pela estrutura quando um objeto de CMFCPopupMenu processar uma mensagem de WM_PAINT .
CFrameWndEx::OnDWMCompositionChanged	Chamado pela estrutura quando a composição de (DWM) gerenciador de janelas da área de trabalho é ativado ou desativado.
CFrameWndEx::OnExitSizeMove	Chamado pela estrutura quando o quadro parar de mover ou redimensionar.
CFrameWndEx::OnGetMinMaxInfo	Chamado pela estrutura quando o quadro é redimensionado para definir limites de dimensão da janela.
CFrameWndEx::OnIdleUpdateCmdUI	Chamado pela estrutura para atualizar a exibição do quadro quando o processamento de comando estiver ocioso.
CFrameWndEx::OnLButtonDown	A estrutura chama esse método quando o usuário pressiona o botão esquerdo do mouse.
CFrameWndEx::OnLButtonUp	A estrutura chama esse método quando o usuário solta o botão esquerdo do mouse.
CFrameWndEx::OnMenuButtonToolHitTest	Chamado pela estrutura quando um objeto de CMFCToolBarButton processar uma mensagem de WM_NCHITTEST .
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 uma janela do painel mover.
CFrameWndEx::OnNcActivate	Chamado pela estrutura quando a área não-cliente do quadro deve ser redesenhada para indicar uma alteração no estado ativo.
CFrameWndEx::OnNcCalcSize	Chamado pela estrutura quando o tamanho e a posição da área cliente devem ser calculados.
CFrameWndEx::OnNcHitTest	Chamado pela estrutura quando o ponteiro se mover ou quando um botão do mouse é pressionado ou liberado.
CFrameWndEx::OnNcMouseMove	Chamado pela estrutura quando o ponteiro se mover em uma área não cliente.
CFrameWndEx::OnNcPaint	Chamado pela estrutura quando a área não-cliente deve ser pintada.
CFrameWndEx::OnPaneCheck	Chamado pela estrutura para controlar a visibilidade de um painel.
CFrameWndEx::OnPostPreviewFrame	Chamado pela estrutura quando o usuário alterar o modo de visualização de impressão.
CFrameWndEx::OnPowerBroadcast	Chamado pela estrutura quando um evento de gerenciamento de energia ocorrer.
CFrameWndEx::OnSetMenu	Chamado pela estrutura para substituir o menu de janela do quadro.
CFrameWndEx::OnSetPreviewMode	Chamado pela estrutura para definir o modo de visualização de impressão para o quadro.
CFrameWndEx::OnSetText	Chamado pela estrutura para definir o texto de uma janela.
CFrameWndEx::OnShowCustomizePane	Chamado pela estrutura quando um rápido personalizar o painel é ativado.
CFrameWndEx::OnShowPanes	Chamado pela estrutura para mostrar ou ocultar os painéis.
CFrameWndEx::OnShowPopupMenu	Chamado pela estrutura quando um menu pop-up é ativado.
CFrameWndEx::OnSize	A estrutura chama esse método após o tamanho de quadros muda.
CFrameWndEx::OnSizing	A estrutura chama esse método quando o usuário redimensiona o quadro.
CFrameWndEx::OnSysColorChange	Chamado pela estrutura quando as cores do sistema alterado.
CFrameWndEx::OnTearOffMenu	Chamado pela estrutura quando um menu que tenha uma barra de rasgo - fora é 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 está exclusa.
CFrameWndEx::OnUpdateFrameMenu	Chamado pela estrutura para definir o menu do quadro.
CFrameWndEx::OnUpdateFrameTitle	A estrutura chama esse método para atualizar a barra de título da janela do quadro.
CFrameWndEx::OnUpdatePaneMenu	Chamado pela estrutura para atualizar o menu do painel.
CFrameWndEx::OnWindowPosChanged	Chamado pela estrutura quando o tamanho de quadros, a posição, ou a ordem z alterado devido a uma chamada para um método de gerenciamento de janela.
CFrameWndEx::PaneFromPoint	Retorna o painel de encaixe que contém o ponto especificado.
CFrameWndEx::PreTranslateMessage	Mensagens específicas da janela handles antes que elas sejam despachados.
CFrameWndEx::RecalcLayout	Ajustar o layout do quadro e suas janelas filho.
CFrameWndEx::RemovePaneFromDockManager	Desregistre um painel e remova-o 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 definidos pelo usuário em um menu da barra de ferramentas.
CFrameWndEx::ShowFullScreen	Alterna o quadro chave entre a tela inteira e os modos normal.
CFrameWndEx::ShowPane	Mostra ou oculta o painel especificado.
CFrameWndEx::UpdateCaption	Chamado pela estrutura para atualizar a legenda de moldura da janela.
CFrameWndEx::WinHelp	Chama o aplicativo de WinHelp ou a ajuda relacionada contexto.

Exemplo

O exemplo a seguir demonstra como herdar uma classe de classe de CFrameWndEx .O exemplo ilustra as assinaturas de método na subclasse, e como substituir o método de OnShowPopupMenu .Este trecho de código é parte de Exemplo de preenchimento da palavra.

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;
}