Classe de CMDIFrameWndEx

Article
03/04/2013

Étend les fonctionnalités d' CMDIFrameWnd, une fenêtre frame d'interface multidocument (MDI) windows.

class CMDIFrameWndEx : public CMDIFrameWnd

Membres

Méthodes publiques

Nom	Description
CMDIFrameWndEx::ActiveItemRecalcLayout	Recalcule la disposition de l'élément actif.
CMDIFrameWndEx::AddDockSite	Cette méthode n'est pas utilisée.
CMDIFrameWndEx::AddPane	Enregistre un volet avec le gestionnaire d'ancrage.
CMDIFrameWndEx::AdjustClientArea	Réduit la zone cliente pour permettre d'une bordure.
CMDIFrameWndEx::AdjustDockingLayout	Recalcule la disposition de tous les volets ancrés.
CMDIFrameWndEx::AreMDITabs	Détermine si les onglets MDI comportent les ou la fonctionnalité de groupes tabulée par MDI est activée.
CMDIFrameWndEx::CanCovertControlBarToMDIChild	Appelé par l'infrastructure pour déterminer si la fenêtre frame peut convertir des volets d'ancrage aux documents avec onglet.
CMDIFrameWndEx::ControlBarToTabbedDocument	Convertit le volet d'ancrage spécifié à un document avec onglets.
CMDIFrameWndEx::CreateDocumentWindow	Crée une fenêtre de document enfant.
CMDIFrameWndEx::CreateNewWindow	Appelé par l'infrastructure pour créer une fenêtre.
CMDIFrameWndEx::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMDIFrameWndEx::DockPane	Ancre le volet spécifié à la fenêtre frame.
CMDIFrameWndEx::DockPaneLeftOf	S'ancre un volet gauche d'un autre volet.
CMDIFrameWndEx::EnableAutoHidePanes	Enables masquer automatiquement le mode pour les volets lorsqu'ils sont ancrés sur les côtés spécifiés de la fenêtre frame principale.
CMDIFrameWndEx::EnableDocking	Active l'ancrage des volets qui appartiennent à la fenêtre frame MDI.
CMDIFrameWndEx::EnableFullScreenMainMenu	Affiche ou masque le menu principal en mode plein écran.
CMDIFrameWndEx::EnableFullScreenMode	Active le mode plein écran de la fenêtre frame.
CMDIFrameWndEx::EnableLoadDockState	Active ou désactive le chargement de l'état d'ancrage.
CMDIFrameWndEx::EnableMDITabbedGroups	Active ou désactive la fonctionnalité de groupes tabulée par MDI.
CMDIFrameWndEx::EnableMDITabs	Active ou désactive la fonctionnalité d'onglets MDI.Une fois activé, la fenêtre frame affiche un onglet pour chaque fenêtre enfant MDI.
CMDIFrameWndEx::EnableMDITabsLastActiveActivation	Spécifie si le dernier onglet actif doit être lancé lorsque l'utilisateur ferme l'onglet actuel.
CMDIFrameWndEx::EnablePaneMenu	Active ou désactive la création automatique et la gestion du menu contextuel de volet, qui affiche une liste des volets de l'application..
CMDIFrameWndEx::EnableWindowsDialog	Insère un élément de menu dont l'ID de commande appelle une boîte de dialogue d' CMFCWindowsManagerDialog .
CMDIFrameWndEx::GetActivePopup	Retourne un pointeur vers le menu popup actuellement affiché.
CMDIFrameWndEx::GetPane	Retourne un pointeur vers le volet ayant l'ID spécifiée de contrôle
CMDIFrameWndEx::GetDefaultResId	Retourne l'ID des ressources partagées de la fenêtre frame MDI.
CMDIFrameWndEx::GetMDITabGroups	Retourne une liste MDI est tabulé windows.
CMDIFrameWndEx::GetMDITabs	Retourne une référence à la fenêtre avec tabulation soulignée.
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems	Retourne une combinaison des balises qui détermine les éléments de menu contextuel sont valides lorsque la fonctionnalité de groupes tabulée par MDI est activée.
CMDIFrameWndEx::GetMenuBar	Retourne un pointeur vers un objet de barre de menus attaché à la fenêtre frame.
CMDIFrameWndEx::GetRibbonBar	Récupère le contrôle de barre de ruban pour le frame.
CMDIFrameWndEx::GetTearOffBars	Retourne une liste d' CPane- les objets dérivés qui sont dans un état d'arrachement.
CMDIFrameWndEx::GetThisClass	Appelé par l'infrastructure pour obtenir un pointeur vers l'objet d' CRuntimeClass associé à ce type de classe.
CMDIFrameWndEx::GetToolbarButtonToolTipText	Appelé par l'infrastructure lorsque l'application affiche l'info-bulle d'un bouton de barre d'outils.
CMDIFrameWndEx::InsertPane	Stocke le volet spécifié par le gestionnaire d'ancrage.
CMDIFrameWndEx::IsFullScreen	Détermine si la fenêtre frame est en mode plein écran.
CMDIFrameWndEx::IsMDITabbedGroup	Détermine si MDI est tabulé des groupes que la fonctionnalité est activée.
CMDIFrameWndEx::IsMemberOfMDITabGroup	Détermine si la fenêtre avec tabulation est spécifiée dans la liste de fenêtres qui sont dans MDI est tabulé des groupes.
CMDIFrameWndEx::IsMenuBarAvailable	Détermine si la fenêtre frame a une barre de menus.
CMDIFrameWndEx::IsPointNearDockSite	Détermine si un point spécifié est vers le site d'ancrage.
CMDIFrameWndEx::IsPrintPreview	Détermine si la fenêtre frame est en mode d'aperçu avant impression.
CMDIFrameWndEx::LoadFrame	Crée une fenêtre frame des informations sur les ressources.(Substitutions CMDIFrameWnd::LoadFrame.)
CMDIFrameWndEx::LoadMDIState	Charge la mise en page spécifiée MDI est tabulé les groupes et la liste de documents précédemment ouverts.
CMDIFrameWndEx::MDITabMoveToNextGroup	Déplace l'onglet actif actuel )de la fenêtre avec tabulation permet au suivant ou précédent groupe avec tabulation.
CMDIFrameWndEx::MDITabNewGroup	Crée un nouveau groupe avec tabulation qui a un guichet unique.
CMDIFrameWndEx::NegotiateBorderSpace	Négocie l'espace de bordure dans une fenêtre frame pendant OLE activation sur place.
CMDIFrameWndEx::OnCloseDockingPane	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton Fermer dans un volet ancrable.
CMDIFrameWndEx::OnCloseMiniFrame	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton Fermer sur un mini fenêtre frame flottante.
CMDIFrameWndEx::OnClosePopupMenu	Appelé par l'infrastructure lorsqu'un menu contextuel actif traite un message d' WM_DESTROY .
CMDIFrameWndEx::OnCmdMsg	Appelé par l'infrastructure pour router et distribuer des messages de commande et mettre à jour les objets interface utilisateur de commande.
CMDIFrameWndEx::OnDrawMenuImage	Appelé par l'infrastructure lorsque l'image associée à un élément de menu est dessinée.
CMDIFrameWndEx::OnDrawMenuLogo	Appelé par l'infrastructure lorsque CMFCPopupMenutraite un message d' WM_PAINT .
CMDIFrameWndEx::OnEraseMDIClientBackground	Appelé par l'infrastructure lorsque la fenêtre frame MDI traite un message d' WM_ERASEBKGND .
CMDIFrameWndEx::OnMenuButtonToolHitTest	Appelé par l'infrastructure lorsqu'un objet d' CMFCToolBarButtontraite un message d' WM_NCHITTEST .
CMDIFrameWndEx::OnMoveMiniFrame	Appelé par l'infrastructure pour déplacer une fenêtre mini-frame.
CMDIFrameWndEx::OnSetPreviewMode	Définit le mode aperçu avant impression de la fenêtre frame principale de l'application.(Substitutions CFrameWnd::OnSetPreviewMode.)
CMDIFrameWndEx::OnShowCustomizePane	Appelé par l'infrastructure lorsqu'un rapide personnaliser le volet est activé.
CMDIFrameWndEx::OnShowMDITabContextMenu	Appelé par l'infrastructure lorsqu'un menu contextuel doit être affiché sur l'un des onglets.(Valide pour MDI est tabulé des groupes uniquement.)
CMDIFrameWndEx::OnShowPanes	Appelé par l'infrastructure pour afficher ou masquer des volets.
CMDIFrameWndEx::OnShowPopupMenu	Appelé par l'infrastructure lorsqu'un menu contextuel est activé.
CMDIFrameWndEx::OnSizeMDIClient	Appelé par l'infrastructure lorsque la taille de la fenêtre MDI de client change.
CMDIFrameWndEx::OnTearOffMenu	Appelé par l'infrastructure lorsqu'un menu qui contient une barre d'arrachement est activé.
CMDIFrameWndEx::OnUpdateFrameMenu	Appelé par l'infrastructure pour mettre à jour le menu de frame.(Substitutions CMDIFrameWnd::OnUpdateFrameMenu.)
CMDIFrameWndEx::PaneFromPoint	Retourne le volet d'ancrage qui contient le point spécifié.
CMDIFrameWndEx::PreTranslateMessage	Utilisé par la classe CWinApp pour convertir des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows d' TranslateMessage et d' DispatchMessage .(Substitutions CMDIFrameWnd::PreTranslateMessage.)
CMDIFrameWndEx::RecalcLayout	Appelé par l'infrastructure à recalculer la disposition de la fenêtre frame.(Substitutions CFrameWnd::RecalcLayout.)
CMDIFrameWndEx::RemovePaneFromDockManager	Annule l'inscription d'un volet et le supprime le gestionnaire d'ancrage.
CMDIFrameWndEx::SaveMDIState	Stocke la disposition actuelle MDI est tabulé les groupes et la liste de documents précédemment ouverts.
CMDIFrameWndEx::SetPrintPreviewFrame	Définit la fenêtre frame d'aperçu avant impression.
CMDIFrameWndEx::SetupToolbarMenu	Modifie un objet barre d'outils en recherchant les éléments fictifs et en les remplaçant par des éléments définis par l'utilisateur spécifié.
CMDIFrameWndEx::ShowFullScreen	Bascule le frame principal du mode normal en mode plein écran.
CMDIFrameWndEx::ShowPane	Affiche ou masque le volet spécifié.
CMDIFrameWndEx::ShowWindowsDialog	Crée une zone d' CMFCWindowsManagerDialog et l'ouvre.
CMDIFrameWndEx::TabbedDocumentToControlBar	Convertit le document avec onglets spécifié à un volet d'ancrage.
CMDIFrameWndEx::UpdateCaption	Appelé par l'infrastructure pour mettre à jour la légende du frame de fenêtre.
CMDIFrameWndEx::UpdateMDITabbedBarsIcons	Définit l'icône pour chaque volet tabulé par MDI.
CMDIFrameWndEx::WinHelp	Appelé par l'infrastructure pour initier l'application de WinHelp ou l'aide de contexte.(Substitutions CWnd::WinHelp.)

Membres de données

Nom	Description
CMDIFrameWndEx::m_bCanCovertControlBarToMDIChild	Détermine si les volets d'ancrage peuvent être convertis à des fenêtres MDI enfants.
CMDIFrameWndEx::m_bDisableSetRedraw	Active ou désactive les redessinent l'optimisation des fenêtres MDI enfants.

Notes

Pour tirer parti des fonctionnalités étendues de personnalisation de votre application MDI, dérivez la classe de fenêtre frame MDI de l'application d' CMDIFrameWndEx au lieu d' CMDIFrameWnd.

Exemple

L'exemple suivant dérive d'une classe d' CMDIFrameWndEx.Cet extrait de code provient d' Exemple DrawClient : MFC Ruban- est basé sur l'application de dessin d'objets 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;
};