CFrameWndEx, classe

Article
06/10/2015

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 CDockingManager, classe 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;
}