Classe de CFrameWndEx

Article
03/04/2013

Implémente les fonctionnalités d'une interface monodocument fenêtre frame chevauchée ou instantanée de (SDI) windows, et fournit des membres pour gérer la fenêtre.Elle étend la classe de CFrameWnd .

class CFrameWndEx : public CFrameWnd

Membres

Méthodes publiques

Nom	Description
CFrameWndEx::ActiveItemRecalcLayout	Règle la disposition du élément OLE client et de la zone cliente du frame.
CFrameWndEx::AddDockSite	Cette méthode n'est pas utilisée.
CFrameWndEx::AddPane	Enregistre une barre de contrôles avec le gestionnaire d'ancrage.
CFrameWndEx::AdjustDockingLayout	Recalcule la disposition de tous les volets qui sont ancrés à la fenêtre frame.
CFrameWndEx::DelayUpdateFrameMenu	Définit le menu puis les mises à jour de frame il lorsque le traitement de commande est inactif.
CFrameWndEx::DockPane	Ancre le volet spécifié à la fenêtre frame.
CFrameWndEx::DockPaneLeftOf	S'ancre un volet gauche d'un autre volet.
CFrameWndEx::EnableAutoHidePanes	Active le mode de masquer automatiquement pour les volets lorsqu'elles sont ancrées aux côtés spécifiés de la fenêtre frame principale.
CFrameWndEx::EnableDocking	Active l'ancrage des volets qui appartiennent à la fenêtre frame.
CFrameWndEx::EnableFullScreenMainMenu	Affiche ou masque le menu principal dans un mode plein écran.
CFrameWndEx::EnableFullScreenMode	Active le mode plein écran de la fenêtre frame.
CFrameWndEx::EnableLoadDockState	Active ou désactive le chargement de l'état d'ancrage.
CFrameWndEx::EnablePaneMenu	Active ou désactive la gestion automatique du menu de volet.
CFrameWndEx::GetActivePopup	Retourne un pointeur vers le menu contextuel actuellement affiché.
CFrameWndEx::GetDefaultResId	Retourne l'ID de ressource que vous avez spécifié lorsque l'infrastructure a chargé la fenêtre frame.
CFrameWndEx::GetDockingManager	Récupère l'objet de Classe de CDockingManager de la fenêtre frame.
CFrameWndEx::GetMenuBar	Retourne un pointeur vers l'objet de barre de menus attaché à la fenêtre frame.
CFrameWndEx::GetPane	Retourne un pointeur vers le volet ayant l'ID spécifiée
CFrameWndEx::GetRibbonBar	Récupère le contrôle de barre de ruban pour le frame.
CFrameWndEx::GetTearOffBars	Retourne une liste d'objets du volet qui sont dans un état d'arrachement.
CFrameWndEx::GetToolbarButtonToolTipText	Appelé par l'infrastructure lorsque l'application affiche l'info-bulle d'un bouton de barre d'outils.
CFrameWndEx::InsertPane	Enregistre un volet avec le gestionnaire d'ancrage.
CFrameWndEx::IsFullScreen	Détermine si la fenêtre frame est en mode plein écran.
CFrameWndEx::IsMenuBarAvailable	Détermine si le pointeur à l'objet de barre de menus est valide.
CFrameWndEx::IsPointNearDockSite	Indique si le point se trouve dans une zone de la fenêtre contextuelle.
CFrameWndEx::IsPrintPreview	Indique si la fenêtre frame est en mode d'aperçu avant impression.
CFrameWndEx::LoadFrame	Cette méthode est appelée après construction pour créer la fenêtre frame et charger ses ressources.
CFrameWndEx::NegotiateBorderSpace	Négociation OLE de bordure de client d'outils.
CFrameWndEx::OnActivate	L'infrastructure appelle cette méthode lorsque l'entrée d'utilisateur est basculée ou quitte y retourne le frame.
CFrameWndEx::OnActivateApp	Appelé par l'infrastructure lorsque l'application est activée ou désélectionnée.
CFrameWndEx::OnChangeVisualManager	Appelé par l'infrastructure lorsqu'une modification au frame requiert une modification au gestionnaire visuel.
CFrameWndEx::OnClose	l'infrastructure appelle cette méthode pour fermer le frame.
CFrameWndEx::OnCloseDockingPane	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton Fermer dans un volet d'ancrage.
CFrameWndEx::OnCloseMiniFrame	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton Fermer sur un mini fenêtre frame flottante.
CFrameWndEx::OnClosePopupMenu	Appelé par l'infrastructure lorsqu'un menu contextuel actif traite un message de WM_DESTROY.
CFrameWndEx::OnCmdMsg	Messages de commande des expéditions.
CFrameWndEx::OnContextHelp	Appelé par l'infrastructure au contexte d'affichage associé l'aide.
CFrameWndEx::OnCreate	Appelé par l'infrastructure après le frame est créé.
CFrameWndEx::OnDestroy	Appelé par l'infrastructure lorsque le frame est détruit.
CFrameWndEx::OnDrawMenuImage	Appelé par l'infrastructure lorsque l'application dessine l'image associée à un élément de menu.
CFrameWndEx::OnDrawMenuLogo	Appelé par l'infrastructure lorsqu'un objet d' CMFCPopupMenu traite un message de WM_PAINT .
CFrameWndEx::OnDWMCompositionChanged	Appelé par l'infrastructure lorsque la composition (DWM) du gestionnaire de fenêtrage a été activée ou désactivée.
CFrameWndEx::OnExitSizeMove	Appelé par l'infrastructure lorsque le frame cesse de se déplacer ou redimensionner.
CFrameWndEx::OnGetMinMaxInfo	Appelé par l'infrastructure lorsque le frame est redimensionné pour définir des limites de dimension de fenêtre.
CFrameWndEx::OnIdleUpdateCmdUI	Appelé par l'infrastructure pour mettre à jour l'affichage de frame lorsque le traitement de commande est inactif.
CFrameWndEx::OnLButtonDown	L'infrastructure appelle cette méthode lorsque l'utilisateur appuie sur le bouton gauche de la souris.
CFrameWndEx::OnLButtonUp	L'infrastructure appelle cette méthode lorsque l'utilisateur relâche le bouton gauche de la souris.
CFrameWndEx::OnMenuButtonToolHitTest	Appelé par l'infrastructure lorsqu'un objet d' CMFCToolBarButton traite un message d' WM_NCHITTEST .
CFrameWndEx::OnMenuChar	Appelé par l'infrastructure lorsqu'un menu est affiché et l'utilisateur appuie sur une touche qui ne correspond pas à une commande.
CFrameWndEx::OnMouseMove	L'infrastructure appelle cette méthode lorsque le pointeur de l'se déplace.
CFrameWndEx::OnMoveMiniFrame	Appelé par l'infrastructure lorsqu'une fenêtre de volet déplace.
CFrameWndEx::OnNcActivate	Appelé par l'infrastructure lorsque la zone non cliente du cadre doit être redessinée pour indiquer une modification de l'état actif.
CFrameWndEx::OnNcCalcSize	Appelé par l'infrastructure lorsque la taille et la position de la zone cliente doivent être calculées.
CFrameWndEx::OnNcHitTest	Appelé par l'infrastructure lorsque le pointeur de l'se déplace ou qu'un bouton de la souris est enfoncé ou libéré.
CFrameWndEx::OnNcMouseMove	Appelé par l'infrastructure lorsque le pointeur de l'se déplace dans une zone non cliente.
CFrameWndEx::OnNcPaint	Appelé par l'infrastructure lorsque la zone non cliente doit être peinte.
CFrameWndEx::OnPaneCheck	Appelé par l'infrastructure pour contrôler la visibilité d'un volet.
CFrameWndEx::OnPostPreviewFrame	Appelé par l'infrastructure lorsque l'utilisateur a modifié l'état d'aperçu avant impression.
CFrameWndEx::OnPowerBroadcast	Appelé par l'infrastructure lorsqu'un événement puissant se produit.
CFrameWndEx::OnSetMenu	Appelé par l'infrastructure pour remplacer le menu de fenêtre frame.
CFrameWndEx::OnSetPreviewMode	Appelé par l'infrastructure pour définir le mode d'aperçu avant impression pour le frame.
CFrameWndEx::OnSetText	Appelé par l'infrastructure pour définir le texte d'une fenêtre.
CFrameWndEx::OnShowCustomizePane	Appelé par l'infrastructure lorsqu'un rapide personnaliser le volet est activé.
CFrameWndEx::OnShowPanes	Appelé par l'infrastructure pour afficher ou masquer des volets.
CFrameWndEx::OnShowPopupMenu	Appelé par l'infrastructure lorsqu'un menu contextuel est activé.
CFrameWndEx::OnSize	L'infrastructure appelle cette méthode lorsque la taille du frame de modification.
CFrameWndEx::OnSizing	L'infrastructure appelle cette méthode lorsque l'utilisateur redimensionne le frame.
CFrameWndEx::OnSysColorChange	Appelé par l'infrastructure lorsque les couleurs système sont modifiées.
CFrameWndEx::OnTearOffMenu	Appelé par l'infrastructure lorsqu'un menu qui contient une barre d'arrachement est activé.
CFrameWndEx::OnToolbarContextMenu	Appelé par l'infrastructure pour générer un menu contextuel de barre d'outils.
CFrameWndEx::OnToolbarCreateNew	l'infrastructure appelle cette méthode pour créer une nouvelle barre d'outils.
CFrameWndEx::OnToolbarDelete	Appelé par l'infrastructure lorsqu'une barre d'outils est désactivée.
CFrameWndEx::OnUpdateFrameMenu	Appelé par l'infrastructure pour définir le menu de frame.
CFrameWndEx::OnUpdateFrameTitle	l'infrastructure appelle cette méthode pour mettre à jour la barre de titre de la fenêtre frame.
CFrameWndEx::OnUpdatePaneMenu	Appelé par l'infrastructure pour mettre à jour le menu de volet.
CFrameWndEx::OnWindowPosChanged	Appelé par l'infrastructure lorsque le format d'image, la position, ou l'ordre de plan a changé en raison d'un appel à une méthode de gestion des fenêtres.
CFrameWndEx::PaneFromPoint	Retourne le volet d'ancrage qui contient le point spécifié.
CFrameWndEx::PreTranslateMessage	Messages spécifiques de fenêtre de handles avant leur acheminées.
CFrameWndEx::RecalcLayout	Règle la disposition du frame et de ses fenêtres enfants.
CFrameWndEx::RemovePaneFromDockManager	Annule l'inscription d'un volet et le supprimer de la liste interne dans le gestionnaire d'ancrage.
CFrameWndEx::SetDockState	Restaure la disposition d'ancrage à l'état d'ancrage stocké dans le Registre.
CFrameWndEx::SetPrintPreviewFrame	Définit la fenêtre frame d'aperçu avant impression.
CFrameWndEx::SetupToolbarMenu	Insère des commandes définies par l'utilisateur dans un menu de la barre d'outils.
CFrameWndEx::ShowFullScreen	Bascule le frame principale entre les modes pleine page et normaux.
CFrameWndEx::ShowPane	Affiche ou masque le volet spécifié.
CFrameWndEx::UpdateCaption	Appelé par l'infrastructure pour mettre à jour la légende du frame de fenêtre.
CFrameWndEx::WinHelp	Appelle l'application d' WinHelp ou l'aide associée par contexte.

Exemple

L'exemple suivant montre comment hériter d'une classe de la classe d' CFrameWndEx .l'exemple montre les signatures de méthode dans la sous-classe, et comment substituer la méthode d' OnShowPopupMenu .Cet extrait de code fait partie d' Exemple de protection de Word.

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