La classe `CFrameWndEx`

Article
10/12/2023

Implémente les fonctionnalités d'une fenêtre frame superposée ou contextuelle à interface monodocument (SDI) Windows et fournit les membres permettant de gérer la fenêtre. Il étend la CFrameWnd classe.

Syntaxe

class CFrameWndEx : public CFrameWnd

Membres

Méthodes publiques

Nom	Description
`CFrameWndEx::ActiveItemRecalcLayout`	Ajuste la disposition de l’élément client OLE et de la zone cliente du frame.
`CFrameWndEx::AddDockSite`	Cette méthode n’est pas utilisée.
`CFrameWndEx::AddPane`	Inscrit une barre de contrôle auprès du gestionnaire d’ancrage.
`CFrameWndEx::AdjustDockingLayout`	Recalcule la disposition de tous les volets ancrés dans la fenêtre frame.
`CFrameWndEx::DelayUpdateFrameMenu`	Définit le menu frame, puis le met à jour lorsque le traitement des commandes est inactif.
`CFrameWndEx::DockPane`	Ancre le volet spécifié dans la fenêtre frame.
`CFrameWndEx::DockPaneLeftOf`	Ancre un volet à gauche d’un autre volet.
`CFrameWndEx::EnableAutoHidePanes`	Active le mode de masquage automatique pour les volets lorsqu’ils sont ancrés sur les côtés spécifiés de la fenêtre de cadre principal.
`CFrameWndEx::EnableDocking`	Active l’ancrage des volets qui appartiennent à la fenêtre frame.
`CFrameWndEx::EnableFullScreenMainMenu`	Affiche ou masque le menu principal en mode plein écran.
`CFrameWndEx::EnableFullScreenMode`	Active le mode plein écran pour 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 du 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 `CDockingManager` Class pour la fenêtre frame.
`CFrameWndEx::GetMenuBar`	Retourne un pointeur vers l’objet de barre de menu attaché à la fenêtre frame.
`CFrameWndEx::GetPane`	Retourne un pointeur vers le volet qui a l’ID spécifié.
`CFrameWndEx::GetRibbonBar`	Récupère le contrôle de barre de ruban pour le cadre.
`CFrameWndEx::GetTearOffBars`	Retourne une liste d’objets de volet qui sont dans un état détachable.
`CFrameWndEx::GetToolbarButtonToolTipText`	Appelé par l’infrastructure lorsque l’application affiche l’info-bulle d’un bouton de barre d’outils.
`CFrameWndEx::InsertPane`	Inscrit un volet auprès du gestionnaire d’ancrage.
`CFrameWndEx::IsFullScreen`	Détermine si la fenêtre frame est en mode plein écran.
`CFrameWndEx::IsMenuBarAvailable`	Détermine si le pointeur vers l’objet de barre de menus est valide.
`CFrameWndEx::IsPointNearDockSite`	Indique si le point se trouve dans une zone d’alignement.
`CFrameWndEx::IsPrintPreview`	Indique si la fenêtre frame est en mode aperçu avant impression.
`CFrameWndEx::LoadFrame`	Cette méthode est appelée après la construction pour créer la fenêtre frame et charger ses ressources.
`CFrameWndEx::NegotiateBorderSpace`	Implémente la négociation de bordure du client OLE.
`CFrameWndEx::OnActivate`	L’infrastructure appelle cette méthode lorsque l’entrée utilisateur est basculée vers ou loin de l’image.
`CFrameWndEx::OnActivateApp`	Appelé par l’infrastructure lorsque l’application est sélectionnée ou désélectionnée.
`CFrameWndEx::OnChangeVisualManager`	Appelé par l’infrastructure lorsqu’une modification de l’image nécessite une modification du gestionnaire de visuels.
`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 une fenêtre mini frame flottante.
`CFrameWndEx::OnClosePopupMenu`	Appelé par l’infrastructure lorsqu’un menu contextuel actif traite un `WM_DESTROY` message.
`CFrameWndEx::OnCmdMsg`	Répartit les messages de commande.
`CFrameWndEx::OnContextHelp`	Appelé par l’infrastructure pour afficher l’aide liée au contexte.
`CFrameWndEx::OnCreate`	Appelé par l’infrastructure après la création de l’image.
`CFrameWndEx::OnDestroy`	Appelé par l’infrastructure lorsque le cadre 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 `CMFCPopupMenu` objet traite un `WM_PAINT` message.
`CFrameWndEx::OnDWMCompositionChanged`	Appelé par l’infrastructure lorsque la composition de Desktop Window Manager (DWM) a été activée ou désactivée.
`CFrameWndEx::OnExitSizeMove`	Appelé par l’infrastructure lorsque l’image cesse de se déplacer ou de redimensionner.
`CFrameWndEx::OnGetMinMaxInfo`	Appelé par l’infrastructure lorsque le cadre est redimensionné pour définir des limites de dimension de fenêtre.
`CFrameWndEx::OnIdleUpdateCmdUI`	Appelé par l’infrastructure pour mettre à jour l’affichage de l’image lorsque le traitement des commandes 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 libère le bouton gauche de la souris.
`CFrameWndEx::OnMenuButtonToolHitTest`	Appelé par l’infrastructure lorsqu’un `CMFCToolBarButton` objet traite un `WM_NCHITTEST` message.
`CFrameWndEx::OnMenuChar`	Appelé par l’infrastructure lorsqu’un menu est affiché et que l’utilisateur appuie sur une touche qui ne correspond pas à une commande.
`CFrameWndEx::OnMouseMove`	L’infrastructure appelle cette méthode lorsque le pointeur se déplace.
`CFrameWndEx::OnMoveMiniFrame`	Appelé par l’infrastructure lorsqu’une fenêtre de volet se déplace.
`CFrameWndEx::OnNcActivate`	Appelé par l’infrastructure lorsque la zone non cliente de l’image 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 se déplace ou lorsqu’un bouton de la souris est enfoncé ou relâché.
`CFrameWndEx::OnNcMouseMove`	Appelé par l’infrastructure lorsque le pointeur 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é le mode aperçu avant impression.
`CFrameWndEx::OnPowerBroadcast`	Appelé par l’infrastructure lorsqu’un événement de gestion de l’alimentation se produit.
`CFrameWndEx::OnSetMenu`	Appelé par l’infrastructure pour remplacer le menu fenêtre frame.
`CFrameWndEx::OnSetPreviewMode`	Appelé par l’infrastructure pour définir le mode aperçu avant impression du cadre.
`CFrameWndEx::OnSetText`	Appelé par l’infrastructure pour définir le texte d’une fenêtre.
`CFrameWndEx::OnShowCustomizePane`	Appelé par l’infrastructure lorsqu’un volet de personnalisation rapide est activé.
`CFrameWndEx::OnShowPanes`	Appelé par l’infrastructure pour afficher ou masquer les volets.
`CFrameWndEx::OnShowPopupMenu`	Appelé par l’infrastructure lorsqu’un menu contextuel est activé.
`CFrameWndEx::OnSize`	L’infrastructure appelle cette méthode après la modification de la taille de l’image.
`CFrameWndEx::OnSizing`	L’infrastructure appelle cette méthode lorsque l’utilisateur redimensionne le cadre.
`CFrameWndEx::OnSysColorChange`	Appelé par l’infrastructure lorsque les couleurs système changent.
`CFrameWndEx::OnTearOffMenu`	Appelé par l’infrastructure lorsqu’un menu avec une barre de déchirure 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 supprimée.
`CFrameWndEx::OnUpdateFrameMenu`	Appelé par l’infrastructure pour définir le menu 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 du volet.
`CFrameWndEx::OnWindowPosChanged`	Appelé par l’infrastructure lorsque la taille, la position ou l’ordre z ont changé en raison d’un appel à une méthode de gestion de fenêtre.
`CFrameWndEx::PaneFromPoint`	Retourne le volet d’ancrage qui contient le point spécifié.
`CFrameWndEx::PreTranslateMessage`	Gère les messages de fenêtre spécifiques avant qu’ils ne soient distribués.
`CFrameWndEx::RecalcLayout`	Ajuste la disposition du cadre et de ses fenêtres enfants.
`CFrameWndEx::RemovePaneFromDockManager`	Annule l’inscription d’un volet et le supprime 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 barre d’outils.
`CFrameWndEx::ShowFullScreen`	Bascule le cadre principal entre l’écran plein et les modes réguliers.
`CFrameWndEx::ShowPane`	Affiche ou masque le volet spécifié.
`CFrameWndEx::UpdateCaption`	Appelé par l’infrastructure pour mettre à jour le cadre de fenêtre légende.
Aide liée à l’application ou au contexte deCFrameWndEx::WinHelp``](#winhelp)\|Invokes either the WinHelp.

Exemple

L’exemple suivant montre comment hériter d’une classe de la CFrameWndEx classe. L’exemple illustre les signatures de méthode dans la sous-classe et comment remplacer la OnShowPopupMenu méthode. Cet extrait de code fait partie de l’ exemple Word Pad.

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

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

Hiérarchie d'héritage

Spécifications

En-têteafxframewndex.h:

`CFrameWndEx::ActiveItemRecalcLayout`

Ajuste la disposition de l’élément client OLE et de la zone cliente du frame.

void ActiveItemRecalcLayout();

Notes

`CFrameWndEx::AddPane`

Inscrit une barre de contrôle auprès du gestionnaire d’ancrage.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

Paramètres

pControlBar
[in] Volet de barre de contrôle à inscrire.

bTail
[in] TRUE si vous souhaitez ajouter le volet de la barre de contrôle à la fin de la liste ; FALSE Sinon.

Valeur de retour

TRUE si la barre de contrôle a été correctement inscrite ; FALSE Sinon.

`CFrameWndEx::AdjustDockingLayout`

Recalcule la disposition de tous les volets ancrés dans la fenêtre frame.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Paramètres

hdwp
Handle vers une structure qui contient les positions de plusieurs fenêtres. .

Notes

La structure hdwp est initialisée par la BeginDeferWindowPos méthode.

`CFrameWndEx::DelayUpdateFrameMenu`

Définit le menu frame, puis le met à jour lorsque le traitement des commandes est inactif.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Paramètres

hMenuAlt
[in] Gérer vers un autre menu.

Notes

`CFrameWndEx::DockPane`

Ancre le volet spécifié dans la fenêtre frame.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

Paramètres

pBar
[in] Pointeur vers la barre de contrôle à ancrer.

nDockBarID
[in] ID du côté de la fenêtre frame à ancrer.

lpRect
[in] Pointeur vers une structure constante Rect qui spécifie la position et la taille de l’écran de la fenêtre.

Notes

Le nDockBarID paramètre peut avoir l’une des valeurs suivantes :

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

Ancre le volet spécifié à gauche d’un autre volet.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Paramètres

pBar
[in] Pointeur vers l’objet volet à ancrer.

pLeftOf
[in] Pointeur vers le volet à gauche duquel ancrer le volet spécifié par pBar.

Valeur de retour

TRUE si pBar elle est ancrée avec succès. Sinon FALSE.

Notes

La méthode prend la barre d’outils spécifiée par le pBar paramètre et l’ancre à gauche de la barre d’outils spécifiée par pLeftOf paramètre.

`CFrameWndEx::EnableAutoHidePanes`

Active le mode de masquage automatique pour le volet lorsqu’il est ancré sur le côté spécifié de la fenêtre du cadre principal.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Paramètres

dwDockStyle
[in] Spécifie le côté de la fenêtre de cadre principale à laquelle ancrer le volet.

Valeur de retour

TRUE si un volet de barres est correctement ancré au côté de la fenêtre frame spécifiée par dwDockStyle, FALSE sinon.

Notes

dwDockStyle peut avoir l’une des valeurs suivantes :

CBRS_ALIGN_TOP: permet à la barre de contrôle d’être ancrée en haut de la zone cliente d’une fenêtre frame.
CBRS_ALIGN_BOTTOM: permet à la barre de contrôle d’être ancrée au bas de la zone cliente d’une fenêtre frame.
CBRS_ALIGN_LEFT: permet à la barre de contrôle d’être ancrée à gauche de la zone cliente d’une fenêtre frame.
CBRS_ALIGN_RIGHT: permet à la barre de contrôle d’être ancrée à droite de la zone cliente d’une fenêtre frame.

`CFrameWndEx::EnableDocking`

Active l’ancrage des volets de la fenêtre frame.

BOOL EnableDocking(DWORD dwDockStyle);

Paramètres

dwDockStyle
[in] Spécifie le côté de la fenêtre de cadre principale où se trouve la barre de volets.

Valeur de retour

TRUE si un volet de barres peut être ancré avec succès sur le côté spécifié. Sinon FALSE.

Notes

Le dwDockStyle paramètre peut avoir l’une des valeurs suivantes :

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Affiche ou masque le menu principal en mode plein écran.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Paramètres

bEnableMenu
[in] TRUE pour afficher le menu principal en mode plein écran, FALSE sinon.

`CFrameWndEx::EnableFullScreenMode`

Active le mode plein écran pour la fenêtre frame.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Paramètres

uiFullScreenCmd
[in] ID d’une commande qui active et désactive le mode plein écran.

Notes

En mode plein écran, toutes les barres de contrôle d’ancrage, les barres d’outils et le menu sont masqués et l’affichage actif est redimensionné pour occuper l’écran plein écran.

Lorsque vous activez le mode plein écran, vous devez spécifier un ID de la commande qui active ou désactive le mode plein écran. Vous pouvez appeler EnableFullScreenMode à partir de la fonction du OnCreate cadre principal. Lorsqu’une fenêtre frame est en cours de basculement en mode plein écran, l’infrastructure crée une barre d’outils flottante avec un bouton avec l’ID de commande spécifié.

Si vous souhaitez conserver le menu principal à l’écran, appelez CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

Active ou désactive le chargement de l’état d’ancrage.

void EnableLoadDockState(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour activer le chargement de l’état d’ancrage pour FALSE désactiver le chargement de l’état d’ancrage.

`CFrameWndEx::EnablePaneMenu`

Active ou désactive la gestion automatique du menu du volet.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

Paramètres

bEnable
[in] TRUE pour activer la gestion automatique des menus contextuels de la barre de contrôle ; FALSE pour désactiver la gestion automatique des menus contextuels de la barre de contrôle.

uiCustomizeCmd
[in] ID de commande de l’élément de menu Personnaliser .

strCustomizeLabel
[in] Étiquette à afficher pour l’élément de menu Personnaliser

uiViewToolbarsMenuEntryID
[in] ID d’un élément de menu de barre d’outils qui ouvre le menu contextuel dans la barre de contrôle.

bContextMenuShowsToolbarsOnly
[in] Si TRUE, le menu contextuel de la barre de contrôle affiche uniquement la liste des barres d’outils. Si FALSE, le menu affiche la liste des barres d’outils et des barres d’ancrage.

bViewMenuShowsToolbarsOnly
[in] Si TRUE, le menu de la barre de contrôle affiche uniquement la liste des barres d’outils. Si FALSE, le menu affiche la liste des barres d’outils et des barres d’ancrage.

`CFrameWndEx::GetActivePopup`

Retourne un pointeur vers le menu contextuel actuellement affiché.

CMFCPopupMenu* GetActivePopup() const;

Valeur de retour

Pointeur vers le menu contextuel actuellement affiché ; sinon NULL.

`CFrameWndEx::GetDefaultResId`

Retourne l’ID de ressource que vous avez spécifié lorsque l’infrastructure a chargé la fenêtre frame.

UINT GetDefaultResId() const;

Valeur de retour

Valeur d’ID de ressource spécifiée par l’utilisateur lorsque l’infrastructure a chargé la fenêtre frame. Zéro si la fenêtre frame n’a pas de barre de menus.

`CFrameWndEx::GetDockingManager`

Récupère l’objet CDockingManager Class pour la fenêtre frame.

CDockingManager* GetDockingManager();

Valeur de retour

Pointeur vers la CDockingManager classe.

Notes

La fenêtre frame crée et utilise un CDockingManager objet Class pour gérer l’ancrage de fenêtre enfant.

`CFrameWndEx::GetMenuBar`

Retourne un pointeur vers l’objet de barre de menu attaché à la fenêtre frame.

const CMFCMenuBar* GetMenuBar() const;

Valeur de retour

Pointeur vers l’objet de barre de menus attaché à la fenêtre frame.

`CFrameWndEx::GetPane`

Retourne un pointeur vers le volet qui a l’ID spécifié.

CBasePane* GetPane(UINT nID);

Paramètres

nID
[in] ID de contrôle.

Valeur de retour

Pointeur vers le volet qui a l’ID spécifié. NULL s’il n’existe aucun volet de ce type.

`CFrameWndEx::GetRibbonBar`

Récupère le contrôle de barre de ruban pour le cadre.

CMFCRibbonBar* GetRibbonBar();

Valeur de retour

Pointeur vers la CMFCRibbonBar classe pour le frame.

Notes

`CFrameWndEx::GetTearOffBars`

Retourne une liste d’objets de volet qui sont dans un état détachable.

const CObList& GetTearOffBars() const;

Valeur de retour

Référence à CObList un objet qui contient une collection de pointeurs vers les objets de volet qui sont dans un état de déchirure.

`CFrameWndEx::GetToolbarButtonToolTipText`

Appelé par l’infrastructure lorsque l’application affiche l’info-bulle d’un bouton de barre d’outils.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Paramètres

pButton
[in] Pointeur vers un bouton de barre d’outils.

strTTText
[in] Texte d’info-bulle à afficher pour le bouton.

Valeur de retour

TRUE si l’info-bulle a été affichée. Sinon FALSE.

Notes

Par défaut, cette méthode ne fait rien. Remplacez cette méthode si vous souhaitez afficher l’info-bulle du bouton de barre d’outils.

`CFrameWndEx::InsertPane`

Insère un volet dans une liste de barres de contrôles et l’inscrit auprès du gestionnaire d’ancrage.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

Paramètres

pControlBar
Pointeur vers une barre de contrôle à insérer dans la liste des barres de contrôles et à inscrire auprès du gestionnaire d’ancrage.

pTarget
Pointeur vers une barre de contrôle avant ou après laquelle insérer le volet.

bAfter
TRUE si vous souhaitez insérer pControlBar après pTarget, FALSE sinon.

Valeur de retour

TRUE si la barre de contrôle a été correctement insérée et inscrite, FALSE sinon.

Notes

Vous devez inscrire chaque barre de contrôle à l’aide de la CDockingManager classe pour participer à la disposition d’ancrage.

`CFrameWndEx::IsFullScreen`

Détermine si la fenêtre frame est en mode plein écran.

BOOL IsFullScreen() const;

Valeur de retour

TRUE si la fenêtre frame est en mode plein écran ; sinon FALSE.

Notes

Vous pouvez définir le mode plein écran en appelant la CFrameWndEx::EnableFullScreenMode méthode.

`CFrameWndEx::IsMenuBarAvailable`

Détermine si le pointeur vers l’objet de barre de menus est valide.

BOOL IsMenuBarAvailable() const;

Valeur de retour

TRUE si la fenêtre frame a une barre de menus ; sinon FALSE.

`CFrameWndEx::IsPointNearDockSite`

Détermine si le point se trouve dans une zone d’alignement.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Paramètres

point
[in] Position du point.

dwBarAlignment
[out] Où le point est aligné. Consultez le tableau de la section Notes pour connaître les valeurs possibles.

bOuterEdge
[out] TRUE si le point se trouve à proximité de la bordure du cadre ; FALSE si le point se trouve dans une zone cliente.

Valeur de retour

TRUE si le point se trouve dans une zone d’alignement ; sinon, FALSE.

Notes

Le tableau suivant répertorie les valeurs possibles pour le dwBarAlignment paramètre.

Value	Description
`CBRS_ALIGN_TOP`	Aligné sur le haut.
`CBRS_ALIGN_RIGHT`	Aligné à droite.
`CBRS_ALIGN_BOTTOM`	Aligné sur le bas.
`CBRS_ALIGN_LEFT`	Aligné à gauche.

`CFrameWndEx::IsPrintPreview`

Détermine si la fenêtre frame est en mode aperçu avant impression.

BOOL IsPrintPreview();

Valeur de retour

TRUE si la fenêtre frame est en mode aperçu avant impression ; sinon, FALSE.

Notes

`CFrameWndEx::LoadFrame`

Cette méthode est appelée après la construction pour créer la fenêtre frame et charger ses ressources.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Paramètres

nIDResource
[in] ID de ressource utilisé pour charger toutes les ressources frame.

dwDefaultStyle
[in] Style de fenêtre frame par défaut.

pParentWnd
[in] Pointeur vers la fenêtre parente du cadre.

pContext
[in] Pointeur vers une CCreateContext classe Structure utilisée par l’infrastructure lors de la création de l’application.

Valeur de retour

TRUE si la méthode a réussi ; sinon, FALSE.

Notes

`CFrameWndEx::NegotiateBorderSpace`

Implémente la négociation de bordure du client OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Paramètres

nBorderCmd
[in] Commande de négociation de frontière. Consultez la section Remarques pour connaître les valeurs possibles.

lpRectBorder
[in, out] Dimensions de la bordure.

Valeur de retour

TRUE si la disposition doit être recalculée ; sinon, FALSE.

Notes

Le tableau suivant répertorie les valeurs possibles pour le nBorderCmd paramètre.

borderGet
Obtenir l’espace client OLE disponible.

borderRequest
Demandez l’espace client OLE.

borderSet
Définissez l’espace client OLE.

`CFrameWndEx::OnActivate`

L’infrastructure appelle cette méthode lorsque l’entrée utilisateur est basculée vers ou loin de l’image.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Paramètres

nState
[in] Indique si le frame est actif ou inactif. Consultez le tableau de la section Notes pour connaître les valeurs possibles.

pWndOther
[in] Pointeur vers une autre fenêtre qui change d’entrée utilisateur avec l’entrée actuelle.

bMinimized
[in] État réduit du cadre. TRUE si le cadre est réduit ; sinon, FALSE.

Notes

Le tableau suivant répertorie les valeurs possibles pour le nState paramètre.

Value	Description
`WA_ACTIVE`	Le cadre est sélectionné par une méthode autre qu’un clic de souris.
`WA_CLICKACTIVE`	Le cadre est sélectionné par un clic de souris.
`WA_INACTIVE`	Le cadre n’est pas sélectionné.

`CFrameWndEx::OnActivateApp`

Appelé par l’infrastructure lorsque l’application est sélectionnée ou désélectionnée.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Paramètres

bActive
[in] TRUE si l’application est sélectionnée ; FALSE si l’application n’est pas sélectionnée.

dwThreadID
[in] Ce paramètre n’est pas utilisé.

Notes

`CFrameWndEx::OnChangeVisualManager`

Appelé par l’infrastructure lorsqu’une modification de l’image nécessite une modification du gestionnaire de visuels.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Paramètres

wParam
[in] Ce paramètre n’est pas utilisé.

lParam
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Retourne toujours 0.

Notes

`CFrameWndEx::OnClose`

L’infrastructure appelle cette méthode pour fermer le frame.

afx_msg void OnClose();

Notes

Si le cadre est en mode aperçu avant impression, il envoie un message Windows pour fermer l’aperçu avant impression ; sinon, si le frame héberge un client OLE, le client est désactivé.

`CFrameWndEx::OnCloseDockingPane`

Appelé par l’infrastructure lorsque l’utilisateur clique sur le bouton Fermer dans un volet d’ancrage.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Valeur de retour

TRUE si la barre d’ancrage peut être fermée. FALSE Sinon

Notes

L’implémentation par défaut ne fait rien. Remplacez cette méthode si vous souhaitez gérer le masquage de la barre d’ancrage.

`CFrameWndEx::OnCloseMiniFrame`

Appelé par l’infrastructure lorsque l’utilisateur clique sur le bouton Fermer sur une fenêtre mini frame flottante.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Valeur de retour

TRUE si une fenêtre mini frame flottante peut être fermée. Sinon FALSE.

Notes

L'implémentation par défaut n'exécute aucune opération. Remplacez cette méthode si vous souhaitez traiter le masquage d’une fenêtre mini frame flottante.

`CFrameWndEx::OnClosePopupMenu`

Appelé par l’infrastructure lorsqu’un menu contextuel actif traite un WM_DESTROY message.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Paramètres

pMenuPopup
Pointeur vers un menu contextuel.

Notes

L’infrastructure envoie un WM_DESTROY message lorsqu’il est sur le point de fermer la fenêtre. Remplacez cette méthode si vous souhaitez gérer les notifications à partir d’objets CMFCPopupMenu appartenant à la fenêtre frame lorsqu’un CMFCPopupMenu objet traite un WM_DESTROY message envoyé par l’infrastructure lorsque la fenêtre est fermée.

`CFrameWndEx::OnCmdMsg`

Répartit les messages de commande.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Paramètres

nID
[in] ID de commande.

nCode
[in] Catégorie de message de commande.

pExtra
[in, out] Pointeur vers un objet de commande.

pHandlerInfo
[in, out] Pointeur vers une structure de gestionnaire de commandes.

Valeur de retour

TRUE si le message de commande a été géré ; sinon, FALSE.

Notes

`CFrameWndEx::OnContextHelp`

Appelé par l’infrastructure pour afficher l’aide liée au contexte.

afx_msg void OnContextHelp();

Notes

`CFrameWndEx::OnCreate`

Appelé par l’infrastructure après la création de l’image.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Paramètres

lpCreateStruct
[in] Pointeur vers la CREATESTRUCT structure du nouveau cadre.

Valeur de retour

0 pour poursuivre la création d’images ; -1 pour détruire le cadre.

Notes

`CFrameWndEx::OnDestroy`

Appelé par l’infrastructure lorsque le cadre est détruit.

afx_msg void OnDestroy();

Notes

La table de l’accélérateur et toutes les fenêtres sont détruites.

`CFrameWndEx::OnDrawMenuImage`

Appelé par l’infrastructure lorsque l’application dessine l’image associée à un élément de menu.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

pMenuButton
[in] Pointeur vers un bouton de menu dont l’image est affichée.

rectImage
[in] Pointeur vers une Rect structure qui spécifie la position et la taille de l’écran de l’image.

Valeur de retour

TRUE si l’infrastructure affiche correctement l’image ; FALSE Sinon.

Notes

Remplacez cette méthode si vous souhaitez personnaliser le rendu d’image pour les éléments de menu appartenant à la barre de menus appartenant à l’objet CFrameWndEx dérivé.

`CFrameWndEx::OnDrawMenuLogo`

Appelé par l’infrastructure lorsqu’un CMFCPopupMenu objet traite un WM_PAINT message.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

pMenu
[in] Pointeur vers l’élément de menu.

rectLogo
[in] Référence à une structure constante CRect qui spécifie la position et la taille de l’écran du logo de menu.

Notes

Remplacez cette fonction si vous souhaitez afficher un logo dans le menu contextuel qui appartient à la barre de menus appartenant à l’objet CFrameWndEx dérivé.

`CFrameWndEx::OnDWMCompositionChanged`

Appelé par l’infrastructure lorsque la composition de Desktop Window Manager (DWM) a été activée ou désactivée.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Paramètres

wp
[in] Ce paramètre n’est pas utilisé.

lp
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Retourne toujours 0.

Notes

`CFrameWndEx::OnExitSizeMove`

Appelé par l’infrastructure lorsque l’image cesse de se déplacer ou de redimensionner.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Paramètres

wp
[in] Ce paramètre n’est pas utilisé.

lp
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Retourne toujours 0.

Notes

`CFrameWndEx::OnGetMinMaxInfo`

Appelé par l’infrastructure lorsque le cadre est redimensionné pour définir des limites de dimension de fenêtre.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Paramètres

lpMMI
[in] Pointeur vers une MINMAXINFO structure.

Notes

`CFrameWndEx::OnIdleUpdateCmdUI`

Appelé par l’infrastructure pour mettre à jour l’affichage de l’image lorsque le traitement des commandes est inactif.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Paramètres

wParam
[in] Ce paramètre n’est pas utilisé.

lParam
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Retourne toujours 0.

Notes

`CFrameWndEx::OnLButtonDown`

L’infrastructure appelle cette méthode lorsque l’utilisateur appuie sur le bouton gauche de la souris.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Paramètres

nFlags
[in] Indique si l’utilisateur a appuyé sur les touches de modificateur. Pour connaître les valeurs possibles, consultez le paramètre wParam dans WM_LBUTTONDOWN Notification.

point
[in] Spécifie les coordonnées x et y du pointeur, par rapport au coin supérieur gauche de la fenêtre.

Notes

`CFrameWndEx::OnLButtonUp`

L’infrastructure appelle cette méthode lorsque l’utilisateur libère le bouton gauche de la souris.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Paramètres

nFlags
[in] Indique si l’utilisateur a appuyé sur les touches de modificateur. Pour connaître les valeurs possibles, consultez le paramètre wParam dans WM_LBUTTONUP Notification.

point
[in] Spécifie les coordonnées x et y du pointeur, par rapport au coin supérieur gauche de la fenêtre.

Notes

`CFrameWndEx::OnMenuButtonToolHitTest`

Appelé par l’infrastructure lorsqu’un CMFCToolBarButton objet traite un WM_NCHITTEST message.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Paramètres

pButton
[in] Pointeur vers le bouton de la barre d’outils.

pTI
[out] Pointeur vers une structure d’informations d’outil.

Valeur de retour

TRUE si l’application remplit le pTI paramètre. Sinon FALSE.

Notes

Remplacez cette méthode si vous souhaitez fournir des informations d’info-bulle sur un élément de menu spécifique.

`CFrameWndEx::OnMenuChar`

Appelé par l’infrastructure lorsqu’un menu est affiché et que l’utilisateur appuie sur une touche qui ne correspond pas à une commande.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

Paramètres

nChar
[in] Code de caractère de la touche enfoncée.

nFlags
[in] Contient l’indicateur MF_POPUP si le menu affiché est un sous-menu ; contient l’indicateur MF_SYSMENU si le menu affiché est un menu de contrôle.

pMenu
[in] Pointeur vers un menu.

Valeur de retour

Le mot à ordre élevé doit être l’une des valeurs suivantes.

Value	Description
`0`	L’infrastructure doit ignorer la séquence de touches.
`1`	L’infrastructure doit fermer le menu.
`2`	L’infrastructure doit sélectionner l’un des éléments affichés dans le menu. Le mot de faible ordre contient l’ID de la commande à sélectionner.

`CFrameWndEx::OnMouseMove`

L’infrastructure appelle cette méthode lorsque le pointeur se déplace.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Paramètres

nFlags
[in] Indique si un utilisateur a appuyé sur les touches de modificateur. Pour connaître les valeurs possibles, consultez le paramètre wParam dans WM_MOUSEMOVE Notification.

point
[in] Spécifie les coordonnées et y les x coordonnées du pointeur par rapport au coin supérieur gauche de la fenêtre.

Notes

`CFrameWndEx::OnMoveMiniFrame`

Appelé par l’infrastructure lorsqu’une fenêtre de volet se déplace.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Paramètres

pFrame
[in] Pointeur vers la CPaneFrameWnd fenêtre du volet Classe .

Valeur de retour

TRUE si la fenêtre du volet n’a pas été ancrée ; FALSE si la fenêtre du volet a été ancrée.

Notes

`CFrameWndEx::OnNcActivate`

Appelé par l’infrastructure lorsque la zone non cliente de l’image doit être redessinée pour indiquer une modification de l’état actif.

afx_msg BOOL OnNcActivate(BOOL bActive);

Paramètres

bActive
[in] TRUE pour dessiner le cadre actif ; FALSE pour dessiner le cadre inactif.

Valeur de retour

Non différent de zéro pour poursuivre le traitement par défaut ; 0 pour empêcher la désactivation de la zone non cliente.

Notes

`CFrameWndEx::OnNcCalcSize`

Appelé par l’infrastructure lorsque la taille et la position de la zone cliente doivent être calculées.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

Paramètres

bCalcValidRects
[in] TRUE quand l’application doit spécifier une zone cliente valide ; sinon, FALSE.

lpncsp
[in] Pointeur vers une NCCALCSIZE_PARAMS structure qui contient des modifications de dimension d’image.

Notes

`CFrameWndEx::OnNcHitTest`

Appelé par l’infrastructure lorsque le pointeur se déplace ou lorsqu’un bouton de la souris est enfoncé ou relâché.

afx_msg LRESULT OnNcHitTest(CPoint point);

Paramètres

point
[in] Emplacement du pointeur dans les coordonnées de l’écran.

Valeur de retour

Valeur énumérée d’un pointeur. Pour obtenir la liste des valeurs possibles, consultez WM_NCHITTEST Notification.

Notes

`CFrameWndEx::OnNcMouseMove`

Appelé par l’infrastructure lorsque le pointeur se déplace dans une zone non cliente.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Paramètres

nHitTest
[in] Valeur énumérée d’un pointeur. Pour obtenir la liste des valeurs possibles, consultez WM_NCHITTEST Notification.

point
[in] Emplacement du pointeur dans les coordonnées de l’écran.

Notes

`CFrameWndEx::OnNcPaint`

Appelé par l’infrastructure lorsque la zone non cliente doit être peinte.

afx_msg void OnNcPaint();

Notes

`CFrameWndEx::OnPaneCheck`

Appelé par l’infrastructure pour contrôler la visibilité d’un volet.

afx_msg BOOL OnPaneCheck(UINT nID);

Paramètres

nID
[in] ID de contrôle d’un volet.

Valeur de retour

TRUE si la commande a été gérée ; FALSE pour poursuivre le traitement des commandes.

Notes

`CFrameWndEx::OnPostPreviewFrame`

Appelé par l’infrastructure lorsque l’utilisateur modifie le mode aperçu avant impression.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Paramètres

wParam
[in] Ce paramètre n’est pas utilisé.

lParam
[in] TRUE lorsque le cadre est en mode aperçu avant impression ; FALSE lorsque le mode aperçu avant impression est désactivé.

Valeur de retour

Retourne toujours 0.

Notes

`CFrameWndEx::OnPowerBroadcast`

Appelé par l’infrastructure lorsqu’un événement de gestion de l’alimentation se produit.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Paramètres

wp
[in] Événement de gestion de l’alimentation. Pour obtenir la liste des valeurs possibles, consultez WM_POWERBROADCAST Message.

lp
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Résultat de l’appel de la procédure de fenêtre par défaut.

Notes

`CFrameWndEx::OnSetMenu`

Appelé par l’infrastructure pour remplacer le menu fenêtre frame.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Paramètres

wp
[in] Gérer le menu de la nouvelle fenêtre frame.

lp
[in] Gérer le menu de la nouvelle fenêtre.

hmenu
[in] Gérer le menu de la nouvelle fenêtre frame.

Valeur de retour

LRESULT est le résultat de l’appel de la procédure de fenêtre par défaut.

BOOL est TRUE si l’événement a été géré ; sinon, FALSE.

Notes

`CFrameWndEx::OnSetPreviewMode`

Appelé par l’infrastructure pour définir le mode aperçu avant impression du cadre.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Paramètres

bPreview
[in] TRUE pour activer l’aperçu avant impression ; FALSE pour désactiver l’aperçu avant impression.

pState
[in] Pointeur vers une structure d’état CPrintPreviewState frame.

Notes

`CFrameWndEx::OnSetText`

Appelé par l’infrastructure pour définir le texte d’une fenêtre.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Paramètres

wParam
[in] Ce paramètre n’est pas utilisé.

lParam
[in] Pointeur vers le texte de la fenêtre.

Valeur de retour

Retourne la valeur d’un appel à DefWindowProc.

Notes

`CFrameWndEx::OnShowCustomizePane`

Appelé par l’infrastructure lorsqu’il affiche un QuickCustomizePane.

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Paramètres

pMenuPane
[in] Pointeur vers le volet de personnalisation rapide.

uiToolbarID
[in] ID de contrôle de la barre d’outils à personnaliser.

Valeur de retour

Cette méthode retourne toujours TRUE.

Notes

Le menu personnalisé rapide est un menu contextuel qui s’affiche lorsque vous cliquez sur le bouton Personnaliser de la barre d’outils

`CFrameWndEx::OnShowPanes`

Appelé par l’infrastructure pour afficher ou masquer les volets.

virtual BOOL OnShowPanes(BOOL bShow);

Paramètres

bShow
[in] TRUE si l’application affiche les volets ; FALSE Sinon.

Valeur de retour

Cette méthode retourne toujours FALSE.

Notes

L’implémentation par défaut affiche les volets si bShow c’est TRUE et les volets sont masqués ou quand bShowFALSE et les volets sont visibles.

L’implémentation par défaut masque les volets si bShow c’est TRUE et les volets sont visibles ou quand bShowFALSE et les volets sont masqués.

Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’infrastructure affiche ou masque les volets.

`CFrameWndEx::OnShowPopupMenu`

Appelé par l’infrastructure lorsqu’il affiche un menu contextuel.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Paramètres

pMenu
[in] Pointeur vers un menu contextuel.

Valeur de retour

TRUE si le menu contextuel est visible ; sinon FALSE.

Notes

Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’infrastructure affiche un menu contextuel. Par exemple, remplacez cette méthode pour modifier la couleur d’arrière-plan des commandes dans un menu contextuel.

`CFrameWndEx::OnSize`

Appelé par l’infrastructure après la modification de la taille de l’image.

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

Paramètres

nType
[in] Type de redimensionnement. Pour connaître les valeurs possibles, consultez le paramètre wParam dans WM_SIZE Notification.

cx
[in] Nouvelle largeur du cadre en pixels.

cy
[in] Nouvelle hauteur du cadre en pixels.

Notes

`CFrameWndEx::OnSizing`

Appelé par l’infrastructure lorsque l’utilisateur redimensionne le cadre.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Paramètres

fwSide
[in] Bord du cadre déplacé. Consultez le paramètre wParam dans WM_SIZING Notification.

pRect
[in, out] Pointeur vers une ou RECT structure CRect qui contient les coordonnées du frame.

Notes

`CFrameWndEx::OnSysColorChange`

Appelé par l’infrastructure lorsque les couleurs système changent.

void OnSysColorChange();

Notes

`CFrameWndEx::OnTearOffMenu`

Appelé par l’infrastructure lorsque l’application affiche un menu qui a une barre de déchirure.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Paramètres

pMenuPopup
[in] Pointeur vers un menu contextuel.

pBar
[in] Pointeur vers une barre de déchirure.

Valeur de retour

TRUE si le menu contextuel avec la barre de déchirure est activé ; sinon FALSE.

Notes

Remplacez cette méthode dans une classe dérivée pour exécuter du code personnalisé lorsque l’infrastructure affiche une barre de contrôle.

L’implémentation par défaut ne fait rien et retourne TRUE.

`CFrameWndEx::OnToolbarContextMenu`

Appelé par l’infrastructure pour créer un menu contextuel de barre d’outils.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Paramètres

wp
[in] Ce paramètre n’est pas utilisé.

lp
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Retourne toujours 1.

Notes

`CFrameWndEx::OnToolbarCreateNew`

L’infrastructure appelle cette méthode pour créer une nouvelle barre d’outils.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Paramètres

wp
[in] Ce paramètre n’est pas utilisé.

lp
[in] Pointeur vers le texte de la barre de titre de la barre d’outils.

Valeur de retour

Pointeur vers la nouvelle barre d’outils ; ou NULL si une barre d’outils n’a pas été créée.

Notes

`CFrameWndEx::OnToolbarDelete`

Appelé par l’infrastructure lorsqu’une barre d’outils est supprimée.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

`CFrameWndEx::PaneFromPoint`

Recherche chaque volet pour le point donné.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Paramètres

point
[in] Coordonnées de l’écran du point à case activée.

nSensitivity
[in] Développez le rectangle englobant de chaque barre de contrôle de cette quantité lors de la recherche de point.

bExactBar
[in] TRUE pour ignorer le nSensitivity paramètre ; sinon, FALSE.

pRTCBarType
[in] Si ce n’est pas NULLle cas, la méthode recherche uniquement les barres de contrôle du type spécifié.

dwAlignment
[out] Si elle réussit, ce paramètre contient le côté de la barre de contrôle la plus proche du point spécifié. Sinon, ce paramètre n’est pas initialisé.

Valeur de retour

Pointeur vers une barre de contrôle qui contient le point; NULL si aucun contrôle n’est trouvé.

Notes

Cette méthode recherche toutes les barres de contrôle dans votre application.point

Permet nSensitivity d’augmenter la taille de la zone de recherche. Permet pRTCBarType de restreindre les types de barres de contrôle que la méthode recherche.

`CFrameWndEx::PreTranslateMessage`

Gère les messages de fenêtre spécifiques avant qu’ils ne soient distribués.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Paramètres

pMsg
[in] Pointeur vers une MSG structure qui contient le message à traiter.

Valeur de retour

Non zéro si le message a été géré et ne doit pas être distribué ; 0 si le message n’a pas été géré et doit être distribué.

Notes

`CFrameWndEx::RecalcLayout`

Ajuste la disposition du cadre et de ses fenêtres enfants.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Paramètres

bNotify
[in] Spécifie s’il faut informer l’élément client OLE de la modification de disposition.

Notes

Cette méthode est appelée lorsque la taille de la fenêtre frame a changé ou lorsque les barres de contrôle sont affichées ou masquées.

`CFrameWndEx::RemovePaneFromDockManager`

Annule l’inscription d’un volet et le supprime du gestionnaire d’ancrage.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Paramètres

pControlBar
[in] Pointeur vers le volet de la barre de contrôle à supprimer.

bDestroy
[in] TRUE pour détruire la barre de contrôle après l’avoir supprimée ; FALSE Sinon.

bAdjustLayout
[in] TRUE pour ajuster la disposition d’ancrage ; FALSE Sinon.

bAutoHide
[in] TRUE si la barre de contrôle est en mode masquer automatiquement ; FALSE Sinon.

pBarReplacement
[in] Pointeur vers un volet qui remplace le volet supprimé.

Notes

Utilisez cette méthode pour supprimer une barre de contrôle de la disposition d’ancrage de la fenêtre frame.

La CDockingManager classe gère la disposition des barres de contrôle. Vous devez inscrire chaque barre de contrôle auprès du gestionnaire d’ancrage à l’aide de la CFrameWndEx::AddPane méthode ou de la CFrameWndEx::InsertPane méthode.

`CFrameWndEx::SetDockState`

Restaure la disposition d’ancrage à l’état d’ancrage stocké dans le Registre.

void SetDockState(const CDockState& state);

Paramètres

state
État d’ancrage. Ce paramètre est ignoré.

`CFrameWndEx::SetPrintPreviewFrame`

Définit la fenêtre frame d’aperçu avant impression.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Paramètres

pWnd
[in] Pointeur vers une fenêtre frame d’aperçu avant impression.

Notes

`CFrameWndEx::SetupToolbarMenu`

Insère des commandes définies par l’utilisateur dans un menu de barre d’outils.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Paramètres

menu
[in] Objet CMenu à modifier.

uiViewUserToolbarCmdFirst
[in] Première commande définie par l’utilisateur.

uiViewUserToolbarCmdLast
[in] Dernière commande définie par l’utilisateur.

Notes

L’infrastructure stocke les commandes définies par l’utilisateur dans une liste. Utilisez uiViewUserToolbarCmdFirst et uiViewUserToolbarCmdList spécifiez les index des commandes à insérer.

`CFrameWndEx::ShowFullScreen`

Bascule le cadre principal entre le mode plein écran et le mode normal.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Affiche ou masque le volet spécifié.

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Paramètres

pBar
[in] Pointeur vers la barre de contrôle pour afficher ou masquer.

bShow
[in] Si TRUE, l’application affiche la barre de contrôle. Sinon, l’application masque la barre de contrôle.

bDelay
[in] Si TRUE, retardez l’ajustement de la disposition d’ancrage jusqu’à ce que l’infrastructure appelle CFrameWndEx::AdjustDockingLayout. Sinon, recalculez immédiatement la disposition d’ancrage.

bActivate
[in] Si TRUE, activez la barre de contrôle. Sinon, affichez la barre de contrôle dans un état inactif.

`CFrameWndEx::UpdateCaption`

Appelé par l’infrastructure pour mettre à jour le cadre de fenêtre légende.

void UpdateCaption();

Notes

`CFrameWndEx::WinHelp`

Appelle l’application WinHelp ou l’aide liée au contexte.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Paramètres

dwData
Données qui dépendent du nCmd paramètre. Pour obtenir la liste des valeurs possibles, consultez WinHelp.

nCmd
Commande d’aide. Pour obtenir la liste des valeurs possibles, consultez WinHelp.

Notes

Voir aussi

Graphique hiérarchique
Classes
CFrameWnd

Share via

La classe CFrameWndEx

Syntaxe

Membres

Méthodes publiques

Exemple

Hiérarchie d'héritage

Spécifications

CFrameWndEx::ActiveItemRecalcLayout

Notes

CFrameWndEx::AddPane

Paramètres

Valeur de retour

CFrameWndEx::AdjustDockingLayout

Paramètres

Notes

CFrameWndEx::DelayUpdateFrameMenu

Paramètres

Notes

CFrameWndEx::DockPane

Paramètres

Notes

CFrameWndEx::DockPaneLeftOf

Paramètres

Valeur de retour

Notes

CFrameWndEx::EnableAutoHidePanes

Paramètres

Valeur de retour

Notes

CFrameWndEx::EnableDocking

Paramètres

Valeur de retour

Notes

CFrameWndEx::EnableFullScreenMainMenu

Paramètres

CFrameWndEx::EnableFullScreenMode

Paramètres

Notes

CFrameWndEx::EnableLoadDockState

Paramètres

CFrameWndEx::EnablePaneMenu

Paramètres

CFrameWndEx::GetActivePopup

Valeur de retour

CFrameWndEx::GetDefaultResId

Valeur de retour

CFrameWndEx::GetDockingManager

Valeur de retour

Notes

CFrameWndEx::GetMenuBar

Valeur de retour

CFrameWndEx::GetPane

Paramètres

Valeur de retour

CFrameWndEx::GetRibbonBar

Valeur de retour

Notes

CFrameWndEx::GetTearOffBars

Valeur de retour

CFrameWndEx::GetToolbarButtonToolTipText

Paramètres

Valeur de retour

Notes

CFrameWndEx::InsertPane

Paramètres

Valeur de retour

Notes

CFrameWndEx::IsFullScreen

Valeur de retour

Notes

CFrameWndEx::IsMenuBarAvailable

Valeur de retour

CFrameWndEx::IsPointNearDockSite

Paramètres

Valeur de retour

Notes

CFrameWndEx::IsPrintPreview

Valeur de retour

Notes

La classe `CFrameWndEx`

`CFrameWndEx::ActiveItemRecalcLayout`

`CFrameWndEx::AddPane`

`CFrameWndEx::AdjustDockingLayout`

`CFrameWndEx::DelayUpdateFrameMenu`

`CFrameWndEx::DockPane`

`CFrameWndEx::DockPaneLeftOf`

`CFrameWndEx::EnableAutoHidePanes`

`CFrameWndEx::EnableDocking`

`CFrameWndEx::EnableFullScreenMainMenu`

`CFrameWndEx::EnableFullScreenMode`

`CFrameWndEx::EnableLoadDockState`

`CFrameWndEx::EnablePaneMenu`

`CFrameWndEx::GetActivePopup`

`CFrameWndEx::GetDefaultResId`

`CFrameWndEx::GetDockingManager`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`