La classe CFrameWndEx

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 la légende du cadre de fenêtre.
CFrameWndEx::WinHelp	Appelle l’aide liée à l’application ou au WinHelp contexte.

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

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Spécifications

En-tête : afxframewndex.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 autrement.

Valeur de retour

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

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.

Valeur	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.

Valeur	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. Sinon FALSE

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 autrement.

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.

Valeur	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 autrement.

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 bShow FALSE 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 bShow FALSE 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);

Paramètres

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

lp
[in] Pointeur vers une barre d’outils.

Valeur de retour

TRUE si la barre d’outils a été supprimée ; sinon, FALSE.

Notes

CFrameWndEx::OnUpdateFrameMenu

Appelé par l’infrastructure pour définir le menu frame.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Paramètres

hMenuAlt
[in] Gérez le menu de remplacement.

Notes

CFrameWndEx::OnUpdateFrameTitle

L’infrastructure appelle cette méthode pour mettre à jour la barre de titre de la fenêtre frame.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Paramètres

bAddToTitle
[in] TRUE pour ajouter le titre du document actif à la barre de titre de la fenêtre frame ; sinon FALSE.

Notes

CFrameWndEx::OnUpdatePaneMenu

Appelé par l’infrastructure pour mettre à jour le menu du volet.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Paramètres

pCmdUI
[in] Pointeur vers l’objet d’interface utilisateur du volet.

Notes

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.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Paramètres

lpwndpos
[in] Pointeur vers une WINDOWPOS structure qui contient la nouvelle taille et la position.

Notes

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 à vérifier.

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 autrement.

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

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

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 la légende du cadre de fenêtre.

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