Classe CMDIFrameWndEx

Artigo
08/25/2010

Isso Zoom, Para Cima e Ampliar está em construção.

Estende a funcionalidade de CMDIFrameWnd, uma janela do quadro de interface de documentos múltiplos (MDI).

class CMDIFrameWndEx : public CMDIFrameWnd

Membros

Métodos públicos

Nome	Descrição
CMDIFrameWndEx::ActiveItemRecalcLayout	Recalcula o layout do item ativo.
CMDIFrameWndEx::AddDockSite
CMDIFrameWndEx::AddPane	Registra um painel com o Gerenciador de encaixe.
CMDIFrameWndEx::AdjustClientArea	Reduz a área de cliente para permitir uma borda.
CMDIFrameWndEx::AdjustDockingLayout	Recalcula o layout de todos os painéis encaixados.
CMDIFrameWndEx::AreMDITabs	Determina se o recurso guias MDI ou o recurso grupos com guias MDI está ativado.
CMDIFrameWndEx::CanCovertControlBarToMDIChild	Chamado pela estrutura para determinar se a janela do quadro pode converter painéis encaixe em documentos com guias.
CMDIFrameWndEx::ControlBarToTabbedDocument	Converte o painel de encaixe especificado para um documento com guias.
CMDIFrameWndEx::CreateDocumentWindow	Cria uma janela do documento filho.
CMDIFrameWndEx::CreateNewWindow	Chamado pela estrutura para criar uma nova janela.
CMDIFrameWndEx::CreateObject	Usados pela estrutura para criar uma instância desse tipo de classe dinâmica.
CMDIFrameWndEx::DockPane	Encaixa o painel especificado para a janela do quadro.
CMDIFrameWndEx::DockPaneLeftOf	Encaixa um painel à esquerda de outro painel.
CMDIFrameWndEx::EnableAutoHidePanes	Permite oculta automaticamente modo para painéis quando eles são encaixados especificado lados da janela do quadro principal.
CMDIFrameWndEx::EnableDocking	Habilita o encaixe dos painéis que pertencem a janela de quadro MDI.
CMDIFrameWndEx::EnableFullScreenMainMenu
CMDIFrameWndEx::EnableFullScreenMode
CMDIFrameWndEx::EnableLoadDockState
CMDIFrameWndEx::EnableMDITabbedGroups	Ativa ou desativa o recurso grupos com guias MDI.
CMDIFrameWndEx::EnableMDITabs	Ativa ou desativa o recurso guias MDI.Quando ativado, a janela do quadro exibe uma guia para cada janela filho MDI.
CMDIFrameWndEx::EnableMDITabsLastActiveActivation	Especifica se a última guia ativo deve ser ativada quando o usuário fecha a guia corrente.
CMDIFrameWndEx::EnablePaneMenu	Ativa ou desativa a criação automático e o gerenciamento de menu do painel pop-up, que exibe uma lista de painéis do aplicativo..
CMDIFrameWndEx::EnableWindowsDialog	Insere um item de menu cuja ID de comando chama um CMFCWindowsManagerDialog caixa de diálogo.
CMDIFrameWndEx::GetActivePopup	Retorna um ponteiro para o menu pop-up exibido no momento.
CMDIFrameWndEx::GetPane	Retorna um ponteiro para o painel que tenha a ID do controle especificado.
CMDIFrameWndEx::GetDefaultResId	Retorna a ID dos recursos compartilhados da janela de quadro MDI.
CMDIFrameWndEx::GetMDITabGroups	Retorna que uma lista de MDI com guias janelas.
CMDIFrameWndEx::GetMDITabs	Retorna uma referência para a janela com guias sublinhada.
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems	Retorna uma combinação de sinalizadores que determina quais itens de menu de contexto são válido quando o recurso de grupos com guias MDI está ativado.
CMDIFrameWndEx::GetMenuBar	Retorna um ponteiro para um BAR de menus objeto associado à janela do quadro.
CMDIFrameWndEx::GetRibbonBar
CMDIFrameWndEx::GetTearOffBars	Retorna uma lista de CPane - derivados objetos que estão em uma subdivisão - estado desativado.
CMDIFrameWndEx::GetThisClass	Chamada pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe.
CMDIFrameWndEx::GetToolbarButtonToolTipText
CMDIFrameWndEx::InsertPane	Registra o painel especificado com o Gerenciador de encaixe.
CMDIFrameWndEx::IsFullScreen
CMDIFrameWndEx::IsMDITabbedGroup	Determina se o recurso grupos com guias MDI está ativado.
CMDIFrameWndEx::IsMemberOfMDITabGroup	Determina se a janela com guias especificada está na lista de janelas que estão em grupos com guias MDI.
CMDIFrameWndEx::IsMenuBarAvailable	Determina se a janela do quadro tem um BAR de menus.
CMDIFrameWndEx::IsPointNearDockSite	Determina se um ponto especificado é quase o site de encaixar.
CMDIFrameWndEx::IsPrintPreview
CMDIFrameWndEx::LoadFrame	Cria uma janela de quadro de informações sobre o recurso.(Substitui CMDIFrameWnd::LoadFrame.)
CMDIFrameWndEx::LoadMDIState	Carrega o layout de grupos com guias MDI especificado e a lista de documentos abertos anteriormente.
CMDIFrameWndEx::MDITabMoveToNextGroup	Move a guia ativo da janela com guias ativo no momento ao agrupar com guias seguinte ou anterior.
CMDIFrameWndEx::MDITabNewGroup	Cria um novo agrupar com guias que possui uma única janela.
CMDIFrameWndEx::NegotiateBorderSpace	Negocia o espaço de borda em uma janela de quadro durante a ativação in-loco OLE.
CMDIFrameWndEx::OnCloseDockingPane	Chamado pela estrutura quando o usuário clica o Fechar botão em um painel encaixável.
CMDIFrameWndEx::OnCloseMiniFrame	Chamado pela estrutura quando o usuário clica o Fechar botão em uma janela de mini-quadro flutuante.
CMDIFrameWndEx::OnClosePopupMenu	Chamado pela estrutura quando um menu pop-up ativo processa um WM_DESTROY mensagem.
CMDIFrameWndEx::OnCmdMsg	Chamado pela estrutura para rotear e distribuir mensagens de comando e atualizar objetos de interface do usuário do comando.(Substitui CMDIFrameWnd::OnCmdMsg.)
CMDIFrameWndEx::OnDrawMenuImage	Chamado pela estrutura quando a imagem associada a um item de menu é desenhada.
CMDIFrameWndEx::OnDrawMenuLogo	Chamada pela estrutura quando um CMFCPopupMenuprocessa um WM_PAINT mensagem.
CMDIFrameWndEx::OnEraseMDIClientBackground	Chamado pela estrutura quando a janela de quadro MDI processa um WM_ERASEBKGND mensagem.
CMDIFrameWndEx::OnMenuButtonToolHitTest	Chamada pela estrutura quando um CMFCToolBarButtonobjeto processa um WM_NCHITTEST mensagem.
CMDIFrameWndEx::OnMoveMiniFrame	Chamada pela estrutura para mover um janela com minimoldura.
CMDIFrameWndEx::OnSetPreviewMode	Define o modo de visualização de impressão de janela de quadro principal do aplicativo.(Substitui CFrameWnd::OnSetPreviewMode.)
CMDIFrameWndEx::OnShowCustomizePane	Chamado pela estrutura quando um painel Personalizar rápida é ativado.
CMDIFrameWndEx::OnShowMDITabContextMenu	Chamado pela estrutura quando um menu de contexto deve ser exibido em uma das guias.(Válido para MDI com guias grupos somente).
CMDIFrameWndEx::OnShowPanes	Chamado pela estrutura para mostrar ou ocultar painéis.
CMDIFrameWndEx::OnShowPopupMenu	Chamado pela estrutura quando um menu pop-up é ativado.
CMDIFrameWndEx::OnSizeMDIClient
CMDIFrameWndEx::OnTearOffMenu	Chamado pela estrutura quando um menu que possui uma BAR destacável será ativado.
CMDIFrameWndEx::OnUpdateFrameMenu	Chamado pela estrutura para atualizar o menu de quadro.(Substitui CMDIFrameWnd::OnUpdateFrameMenu.)
CMDIFrameWndEx::PaneFromPoint	Retorna o painel de encaixe que contém o ponto especificado.
CMDIFrameWndEx::PreTranslateMessage	Usado por classe CWinApp para traduzir as mensagens de janela antes que eles são expedidos para o TranslateMessage and DispatchMessage Funções do Windows.(Substitui CMDIFrameWnd::PreTranslateMessage.)
CMDIFrameWndEx::RecalcLayout	Chamado pela estrutura para recalcular o layout da janela do quadro.(Substitui CFrameWnd::RecalcLayout.)
CMDIFrameWndEx::RemovePaneFromDockManager	Cancela o registro de um painel e a remove do Gerenciador de encaixe.
CMDIFrameWndEx::SaveMDIState	Salva o layout de grupos com guias MDI corrente e a lista de documentos abertos anteriormente.
CMDIFrameWndEx::SetPrintPreviewFrame
CMDIFrameWndEx::SetupToolbarMenu	Modifica um objeto de barra de ferramentas, procurando itens fictícios e substituí-los com os itens definidos pelo usuário especificados.
CMDIFrameWndEx::ShowFullScreen
CMDIFrameWndEx::ShowPane	Mostra ou oculta o painel especificado.
CMDIFrameWndEx::ShowWindowsDialog	Cria um CMFCWindowsManagerDialog caixa e o abre.
CMDIFrameWndEx::TabbedDocumentToControlBar	Converte o documento com guias especificado para um painel de encaixe.
CMDIFrameWndEx::UpdateCaption
CMDIFrameWndEx::UpdateMDITabbedBarsIcons	Define o ícone para cada painel com guias MDI.
CMDIFrameWndEx::WinHelp	Chamado pela estrutura para iniciar a Ajuda de contexto ou aplicativo WinHelp.(Substitui CWnd::WinHelp.)

Membros de dados

Nome	Descrição
CMDIFrameWndEx::m_bCanCovertControlBarToMDIChild	Determina se os painéis encaixe podem ser convertidas para janelas filho MDI.
CMDIFrameWndEx::m_bDisableSetRedraw	Habilita ou desabilita a otimização de redesenho de janelas filho MDI.

Comentários

Para tirar proveito dos recursos de personalização estendida em seu aplicativo MDI, derive a classe de janela de quadro MDI do aplicativo de CMDIFrameWndEx em vez de CMDIFrameWnd.

Exemplo

O exemplo a seguir deriva uma classe de CMDIFrameWndEx. Neste trecho de código é proveniente do Exemplo do DrawClient: Aplicativos de desenho de objeto OLE com a faixa de opções do MFC.

class CMainFrame : public CMDIFrameWndEx
{
    DECLARE_DYNAMIC(CMainFrame)
public:
    struct XStyle
    {
        COLORREF clrFill;
        COLORREF clrLine;
    };

public:
    CMainFrame();

    // Attributes
public:
    CMFCRibbonBar* GetRibbonBar() {return &m_wndRibbonBar;}

    // Operations
public:
    void UpdateUI(CDrawView* pCurrView);
    void UpdateContextTab(CDrawView* pCurrView);
    void UpdateContextTabFromObject(CDrawObjList& list);

    COLORREF GetColorFromColorButton(int nButtonID);
    int GetWeightFromLineWeight(int nButtonID);
    BOOL GetStyleFromStyles(XStyle& style);

    void SetRibbonContextCategory(UINT uiCategoryID);
    void ActivateRibbonContextCategory(UINT uiCategoryID);

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

protected:
    // control bar embedded members
    CMFCRibbonStatusBar m_wndStatusBar;
    CMFCRibbonBar m_wndRibbonBar;

    CMFCRibbonApplicationButton m_MainButton;

    // panel images
    CMFCToolBarImages m_PanelImages;

    // Document colors for demo:
    CList<COLORREF,COLORREF> m_lstMainColors;
    CList<COLORREF,COLORREF> m_lstAdditionalColors;
    CList<COLORREF,COLORREF> m_lstStandardColors;

    // Generated message map functions
protected:
    //{{AFX_MSG(CMainFrame)
    afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
    afx_msg void OnAppLook(UINT id);
    afx_msg void OnUpdateAppLook(CCmdUI* pCmdUI);
    afx_msg void OnWindowManager();
    afx_msg void OnMdiMoveToNextGroup();
    afx_msg void OnMdiMoveToPrevGroup();
    afx_msg void OnMdiNewHorzTabGroup();
    afx_msg void OnMdiNewVertGroup();
    afx_msg void OnMdiCancel();
    afx_msg LRESULT OnRibbonCustomize(WPARAM wp, LPARAM lp);
    afx_msg LRESULT OnHighlightRibbonListItem(WPARAM wp, LPARAM lp);
    afx_msg void OnToolsOptions();
    afx_msg void OnDummy();
    afx_msg void OnSysColorChange();
    //}}AFX_MSG

    DECLARE_MESSAGE_MAP()

    virtual BOOL OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop);
    virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenuPopup);

    void ShowOptions(int nPage);
    void CreateDocumentColors();

private:
    BOOL CreateRibbonBar();
    BOOL CreateStatusBar();

    void InitMainButton();
    void InitHomeCategory();
    void InitViewCategory();
    void InitTabButtons();

    void AddContextTab_Format();

    void AdjustObjectSubmenu(CMFCPopupMenu* pMenuPopup);
    void UpdateStatusBarCountPane(int nID, CString strText, int nCount);

    UINT m_nAppLook;
};