CMDIFrameWndEx Class

Artículo
06/10/2015

Extiende la funcionalidad de CMDIFrameWnd, una ventana de cuadro de (MDI) de interfaz de múltiples documentos de Windows.

class CMDIFrameWndEx : public CMDIFrameWnd

Members

Métodos públicos

Nombre	Descripción
CMDIFrameWndEx::ActiveItemRecalcLayout	Actualiza el diseño del elemento activo.
CMDIFrameWndEx::AddDockSite	Este método no se utiliza.
CMDIFrameWndEx::AddPane	Registra un panel con el administrador de acoplamiento.
CMDIFrameWndEx::AdjustClientArea	Reduce el área cliente para tener en cuenta un borde.
CMDIFrameWndEx::AdjustDockingLayout	Actualiza el diseño de todos los paneles acoplados.
CMDIFrameWndEx::AreMDITabs	Determina si la característica de pestañas MDI o características de los grupos de MDI organización por fichas está habilitada.
CMDIFrameWndEx::CanCovertControlBarToMDIChild	Llamado por el marco para determinar si la ventana de marco puede convertir los paneles de acoplamiento a documentos con fichas.
CMDIFrameWndEx::ControlBarToTabbedDocument	Convierte el panel de acoplamiento especificado a un documento con fichas.
CMDIFrameWndEx::CreateDocumentWindow	Crea una ventana de documento secundaria.
CMDIFrameWndEx::CreateNewWindow	Llamado por el marco para crear una nueva ventana.
CMDIFrameWndEx::CreateObject	Utiliza el marco para crear una instancia dinámica de este tipo de clase.
CMDIFrameWndEx::DockPane	Acoplar el panel especificado a la ventana de marco.
CMDIFrameWndEx::DockPaneLeftOf	Lo acopla un panel a la izquierda de otro panel.
CMDIFrameWndEx::EnableAutoHidePanes	Enables oculta automáticamente el modo para los paneles cuando se acoplan en los lados especificados de la ventana de marco principal.
CMDIFrameWndEx::EnableDocking	Habilita el acoplamiento de los paneles que pertenecen a la ventana de marco MDI.
CMDIFrameWndEx::EnableFullScreenMainMenu	Muestra u oculta el menú principal en modo de pantalla completa.
CMDIFrameWndEx::EnableFullScreenMode	Habilita el modo de pantalla completa para la ventana de marco.
CMDIFrameWndEx::EnableLoadDockState	Habilita o deshabilita la carga del estado de vinculación.
CMDIFrameWndEx::EnableMDITabbedGroups	Habilita o deshabilita la característica de los grupos de MDI organización por fichas.
CMDIFrameWndEx::EnableMDITabs	Habilita o deshabilita la característica de fichas de MDI. Cuando está habilitada, la ventana cuadro muestra una ficha para cada ventana MDI secundaria.
CMDIFrameWndEx::EnableMDITabsLastActiveActivation	Especifica si la pestaña activa última debe activarse cuando el usuario cierra la ficha actual.
CMDIFrameWndEx::EnablePaneMenu	Habilita o deshabilita la creación automática y administración del menú emergente del panel, que muestra una lista de paneles de la aplicación. .
CMDIFrameWndEx::EnableWindowsDialog	Inserta un elemento de menú cuyo identificador de comando llama a un cuadro de diálogo de CMFCWindowsManagerDialog.
CMDIFrameWndEx::GetActivePopup	Devuelve un puntero al menú emergente mostrado actualmente.
CMDIFrameWndEx::GetPane	Devuelve un puntero al panel que tiene el identificador especificado del control
CMDIFrameWndEx::GetDefaultResId	Devuelve el identificador de recursos compartidos de la ventana de marco MDI.
CMDIFrameWndEx::GetMDITabGroups	Devuelve una lista de MDI con las ventanas.
CMDIFrameWndEx::GetMDITabs	Devuelve una referencia a la ventana con fichas subrayada.
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems	Devuelve una combinación de marcadores que determina qué elementos de menú contextual son válidos cuando se habilita la característica de los grupos de MDI organización por fichas.
CMDIFrameWndEx::GetMenuBar	Devuelve un puntero a un objeto de la barra de menús asociado a la ventana de marco.
CMDIFrameWndEx::GetRibbonBar	Recupera el control de barra de la cinta de opciones del cuadro.
CMDIFrameWndEx::GetTearOffBars	Devuelve una lista de CPane- objetos derivados que están en estado de rasgón.
CMDIFrameWndEx::GetThisClass	Llamado por el marco para obtener un puntero al objeto de Recursos asociado a este tipo de clase.
CMDIFrameWndEx::GetToolbarButtonToolTipText	Llamado por el marco cuando la aplicación muestra información sobre herramientas de un botón de la barra de herramientas.
CMDIFrameWndEx::InsertPane	Registra el panel especificado con el administrador de acoplamiento.
CMDIFrameWndEx::IsFullScreen	Determina si la ventana de marco está en modo de pantalla completa.
CMDIFrameWndEx::IsMDITabbedGroup	Determina si la característica de los grupos de MDI organización por fichas está habilitada.
CMDIFrameWndEx::IsMemberOfMDITabGroup	Determina si la ventana con fichas especificada está en la lista de ventanas que están en grupos de MDI organización por fichas.
CMDIFrameWndEx::IsMenuBarAvailable	Determina si la ventana cuadro tiene una barra de menús.
CMDIFrameWndEx::IsPointNearDockSite	Determina si un punto especificado está cerca del sitio de vinculación.
CMDIFrameWndEx::IsPrintPreview	Determina si la ventana de marco está en modo de vista previa de impresión.
CMDIFrameWndEx::LoadFrame	Crea una ventana de marco de información de recursos. (Reemplaza CMDIFrameWnd::LoadFrame.)
CMDIFrameWndEx::LoadMDIState	Carga el diseño especificado de grupos de MDI organización por fichas y la lista de documentos abiertos previamente.
CMDIFrameWndEx::MDITabMoveToNextGroup	Mueve la pestaña activa actual de la ventana con fichas activo el grupo con siguiente o anterior.
CMDIFrameWndEx::MDITabNewGroup	Crea un nuevo grupo con fichas que tiene una sola ventana.
CMDIFrameWndEx::NegotiateBorderSpace	Negocia el espacio del borde en una ventana de marco durante la activación en contexto OLE.
CMDIFrameWndEx::OnCloseDockingPane	Llamado por el marco cuando el usuario hace clic en el botón Cerrar en un panel acoplable.
CMDIFrameWndEx::OnCloseMiniFrame	Llamado por el marco cuando el usuario hace clic en el botón Cerrar en una mini ventana flotante del cuadro.
CMDIFrameWndEx::OnClosePopupMenu	Llamado por el marco cuando un menú emergente activo procesa un mensaje de WM_DESTROY.
CMDIFrameWndEx::OnCmdMsg	Llamado por el marco para distribuir y enviar mensajes de comando y actualizar los objetos de la interfaz de usuario del comando.
CMDIFrameWndEx::OnDrawMenuImage	Llamado por el marco cuando la imagen asociada a un elemento de menú se dibuja.
CMDIFrameWndEx::OnDrawMenuLogo	Llamado por el marco cuando CMFCPopupMenu procesa un mensaje de WM_PAINT.
CMDIFrameWndEx::OnEraseMDIClientBackground	Llamado por el marco cuando la ventana de marco MDI procesa un mensaje de WM_ERASEBKGND.
CMDIFrameWndEx::OnMenuButtonToolHitTest	Llamado por el marco cuando un objeto de CMFCToolBarButton procesa un mensaje de WM_NCHITTEST.
CMDIFrameWndEx::OnMoveMiniFrame	Llamado por el marco para mover una ventana de mini- cuadro.
CMDIFrameWndEx::OnSetPreviewMode	Establece el modo de vista previa de impresión de la ventana de marco principal de la aplicación. (Reemplaza CFrameWnd::OnSetPreviewMode.)
CMDIFrameWndEx::OnShowCustomizePane	Llamado por el marco cuando un Quick personaliza se produce el panel.
CMDIFrameWndEx::OnShowMDITabContextMenu	Llamado por el marco cuando un menú contextual se debería mostrar en una de las pestañas. (Válido para grupos de MDI organización por fichas sólo.)
CMDIFrameWndEx::OnShowPanes	Llamado por el marco para mostrar u ocultar paneles.
CMDIFrameWndEx::OnShowPopupMenu	Llamado por el marco cuando se activa un menú emergente.
CMDIFrameWndEx::OnSizeMDIClient	Llamado por el marco cuando el tamaño de la ventana MDI de cliente está cambiando.
CMDIFrameWndEx::OnTearOffMenu	Llamado por el marco cuando se activa un menú que tiene una barra de rasgón.
CMDIFrameWndEx::OnUpdateFrameMenu	Llamado por el marco para actualizar el menú del cuadro. (Reemplaza CMDIFrameWnd::OnUpdateFrameMenu.)
CMDIFrameWndEx::PaneFromPoint	Devuelve el panel acoplable que contiene el punto especificado.
CMDIFrameWndEx::PreTranslateMessage	Utiliza la clase CWinApp para traducir mensajes de ventana antes de que se envíen a las funciones de TranslateMessage y de DispatchMessage Windows. (Reemplaza CMDIFrameWnd::PreTranslateMessage.)
CMDIFrameWndEx::RecalcLayout	Llamado por el marco para actualizar el diseño de la ventana de marco. (Reemplaza CFrameWnd::RecalcLayout.)
CMDIFrameWndEx::RemovePaneFromDockManager	Anula un panel y colóquelo de administrador de acoplamiento.
CMDIFrameWndEx::SaveMDIState	Guarda el diseño actual de grupos de MDI organización por fichas y la lista de documentos abiertos previamente.
CMDIFrameWndEx::SetPrintPreviewFrame	Establece la ventana cuadro de vista previa de impresión.
CMDIFrameWndEx::SetupToolbarMenu	Modifica un objeto de la barra de herramientas buscando los elementos ficticios y reemplazandolos con los elementos definidos por el usuario especificados.
CMDIFrameWndEx::ShowFullScreen	Cambia el marco principal de modo normal al modo de pantalla completa.
CMDIFrameWndEx::ShowPane	Muestra u oculta el panel especificado.
CMDIFrameWndEx::ShowWindowsDialog	Crea un cuadro de CMFCWindowsManagerDialog y lo abre.
CMDIFrameWndEx::TabbedDocumentToControlBar	Convierte el documento con fichas especificado a un panel acoplable.
CMDIFrameWndEx::UpdateCaption	Llamado por el marco para actualizar la leyenda de la ventana.
CMDIFrameWndEx::UpdateMDITabbedBarsIcons	Establece el icono para cada panel con MDI.
CMDIFrameWndEx::WinHelp	Llamado por el marco para iniciar la aplicación o la ayuda contextual de WinHelp. (Reemplaza CWnd::WinHelp.)

Miembros de datos

Nombre	Descripción
CMDIFrameWndEx::m_bCanCovertControlBarToMDIChild	Determina si acoplar paneles se puede convertir a las ventanas secundarias MDI.
CMDIFrameWndEx::m_bDisableSetRedraw	Habilita o deshabilita la optimización actualizar para las ventanas MDI secundarias.

Comentarios

Para aprovechar características extendidas de personalización de la aplicación MDI, derive la clase de ventana de marco MDI de la aplicación de CMDIFrameWndEx en lugar de CMDIFrameWnd.

Ejemplo

El ejemplo siguiente crea una clase derivada de CMDIFrameWndEx. Este fragmento de código procede de Ejemplo de DrawClient: MFC Cinta de opciones- en la aplicación de dibujo de objetos OLE.

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