CMDIChildWndEx, classe

Article
10/12/2023

La CMDIChildWndEx classe fournit les fonctionnalités d’une fenêtre enfant MDI (Multi Document Interface) Windows. Il étend les fonctionnalités de la classe CMDIChildWnd. L'infrastructure requiert cette classe lorsqu'une application MDI utilise certaines classes MFC.

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMDIChildWndEx : public CMDIChildWnd

Membres

Méthodes publiques

Nom	Description
CMDIChildWndEx ::ActivateTopLevelFrame	Appelé en interne par l’infrastructure pour activer une trame de niveau supérieur lorsque l’application doit être activée à partir d’un onglet de barre des tâches.
`CMDIChildWndEx::AddDockSite`	Cette méthode n’est pas utilisée ou implémentée.
CMDIChildWndEx ::AddPane	Ajoute un volet.
CMDIChildWndEx ::AddTabbedPane	Ajoute un volet à onglets.
CMDIChildWndEx ::AdjustDockingLayout	Ajuste la disposition d’ancrage.
CMDIChildWndEx ::CanShowOnMDITabs
CMDIChildWndEx ::CanShowOnTaskBarTabs	Indique à l’infrastructure si cet enfant MDI peut être affiché sous les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::CanShowOnWindowsList	Renvoie TRUE si le nom de la fenêtre enfant MDI peut être affiché dans la boîte de dialogue CLASSE CMFCWindowsManagerDialog . Sinon, retourne la valeur FALSE.
`CMDIChildWndEx::CreateObject`	Appelé par l’infrastructure pour créer une instance dynamique de ce type de classe.
CMDIChildWndEx ::D ockPane	Ancre un volet.
CMDIChildWndEx ::D ockPaneLeftOf	Ancre un volet à gauche d’un autre volet.
CMDIChildWndEx ::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.
CMDIChildWndEx ::EnableDocking	Active l’ancrage de la fenêtre enfant sur le cadre principal.
CMDIChildWndEx ::EnableTaskbarThumbnailClipRect	Active ou désactive la sélection automatique d’une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.
CMDIChildWndEx ::GetDockingManager
CMDIChildWndEx ::GetDocumentName	Retourne le nom du document affiché dans la fenêtre enfant MDI.
CMDIChildWndEx ::GetFrameIcon	Appelé par l’infrastructure pour récupérer l’icône de fenêtre enfant MDI.
CMDIChildWndEx ::GetFrameText	Appelé par l’infrastructure pour récupérer le texte de la fenêtre enfant MDI.
CMDIChildWndEx ::GetPane	Recherche un volet par l’ID de contrôle spécifié.
CMDIChildWndEx ::GetRelatedTabGroup
CMDIChildWndEx ::GetTabbedPane	Retourne un pointeur vers un volet d’ancrage incorporé qui a été converti en document à onglets.
CMDIChildWndEx ::GetTabProxyWnd	Retourne la fenêtre proxy de tabulation réellement inscrite avec les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::GetTaskbarPreviewWnd	Appelé par l’infrastructure lorsqu’il doit obtenir une fenêtre enfant (généralement une fenêtre d’affichage ou de fractionnement) à afficher sur la miniature de l’onglet de la barre des tâches Windows 7.
CMDIChildWndEx ::GetTaskbarThumbnailClipRect	Appelé par l’infrastructure lorsqu’il doit sélectionner une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.
`CMDIChildWndEx::GetThisClass`	Appelé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.
CMDIChildWndEx ::GetToolbarButtonToolTipText	Appelé par l’infrastructure pour récupérer une info-bulle pour un bouton de barre d’outils.
CMDIChildWndEx ::InsertPane	Inscrit le volet spécifié auprès du gestionnaire d’ancrage.
CMDIChildWndEx ::InvalidateIconicBitmaps	Invalide la représentation bitmap emblématique de l’enfant MDI.
CMDIChildWndEx ::IsPointNearDockSite	Détermine si un point spécifié est proche du site d’ancrage.
CMDIChildWndEx ::IsReadOnly	Renvoie TRUE si le document affiché dans la fenêtre enfant est en lecture seule. Sinon, retourne la valeur FALSE.
CMDIChildWndEx ::IsRegisteredWithTaskbarTabs	Retourne TRUE si l’enfant MDI a été correctement inscrit avec les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::IsTabbedPane	Retourne TRUE si la fenêtre enfant MDI contient un volet d’ancrage. Sinon, retourne la valeur FALSE.
CMDIChildWndEx ::IsTaskbarTabsSupportEnabled	Indique si l’enfant MDI peut apparaître sous les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::IsTaskbarThumbnailClipRectEnabled	Indique si la sélection automatique d’une partie de la zone cliente d’une fenêtre à afficher à mesure que la miniature de cette fenêtre dans la barre des tâches est activée ou désactivée.
CMDIChildWndEx ::m_dwDefaultTaskbarTabPropertyFlags	Combinaison d’indicateurs, qui est passée par l’infrastructure à la méthode SetTaskbarTabProperties, lorsqu’un onglet (enfant MDI) est inscrit avec les onglets de la barre des tâches Windows 7. La combinaison par défaut est `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx ::OnGetIconicLivePreviewBitmap	Appelé par l’infrastructure lorsqu’il doit obtenir une bitmap pour la préversion dynamique de l’enfant MDI.
CMDIChildWndEx ::OnGetIconicThumbnail	Appelé par l’infrastructure lorsqu’il doit obtenir une bitmap pour les miniatures emblématiques de l’enfant MDI.
CMDIChildWndEx ::OnMoveMiniFrame	Appelé par l’infrastructure pour déplacer une fenêtre mini-frame.
CMDIChildWndEx ::OnPressTaskbarThmbnailCloseButton	Appelé par l’infrastructure lorsque l’utilisateur appuie sur le bouton Fermer sous la miniature de l’onglet Barre des tâches..
CMDIChildWndEx ::OnSetPreviewMode	Appelé par l’infrastructure pour entrer ou quitter le mode aperçu avant impression.
CMDIChildWndEx ::OnTaskbarTabThumbnailActivate	Appelé par l’infrastructure lorsque la miniature de l’onglet Barre des tâches doit traiter WM_ACTIVATE message.
CMDIChildWndEx ::OnTaskbarTabThumbnailMouseActivate	Appelé par l’infrastructure lorsque la miniature de l’onglet Barre des tâches doit traiter WM_MOUSEACTIVATE message.
CMDIChildWndEx ::OnTaskbarTabThumbnailStretch	Appelé par l’infrastructure lorsqu’il doit étirer une bitmap pour l’aperçu miniature de l’onglet de barre des tâches Windows 7 de l’enfant MDI.
CMDIChildWndEx ::OnUpdateFrameTitle	Appelé par l’infrastructure pour mettre à jour le titre de l’image. (Substitue `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx ::P aneFromPoint	Retourne le volet qui contient le point donné.
`CMDIChildWndEx::PreTranslateMessage`	Utilisé par la classe CWinApp pour traduire les messages de fenêtre avant qu’ils ne soient distribués aux fonctions Windows TranslateMessage et DispatchMessage . (Substitue CWnd::PreTranslateMessage.)
CMDIChildWndEx ::RecalcLayout	Recalcule la disposition de la fenêtre.
CMDIChildWndEx ::RegisterTaskbarTab	Inscrit MDI enfant avec les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::RemovePaneFromDockManager	Supprime un volet du gestionnaire d’ancrage.
CMDIChildWndEx ::SetRelatedTabGroup
CMDIChildWndEx ::SetTaskbarTabActive	Active l’onglet de la barre des tâches Windows 7 correspondant.
CMDIChildWndEx ::SetTaskbarTabOrder	Insère L’enfant MDI avant la fenêtre spécifiée sous les onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::SetTaskbarTabProperties	Définit les propriétés d’un onglet de la barre des tâches Windows 7.
CMDIChildWndEx ::SetTaskbarThumbnailClipRect	Appelé en interne par l’infrastructure pour définir le rectangle de découpage pour sélectionner une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.
CMDIChildWndEx ::ShowPane
CMDIChildWndEx ::UnregisterTaskbarTab	Supprime l’enfant MDI des onglets de la barre des tâches Windows 7.
CMDIChildWndEx ::UpdateTaskbarTabIcon	Met à jour l’icône de l’onglet de la barre des tâches Windows 7.

Notes

Pour tirer parti des fonctionnalités d’ancrage étendues dans les applications MDI, dérivez la classe de fenêtre enfant MDI de votre application CMDIChildWndEx au lieu de CMDIChildWnd.

Exemple

L’exemple suivant dérive une classe de CMDIChildWndEx. Cet extrait de code provient de l’exemple VisualStudioDemo : MFC Visual Studio Application.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

   // Implementation
public:
   virtual ~CChildFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Hiérarchie d'héritage

Spécifications

En-tête : afxMDIChildWndEx.h

CMDIChildWndEx ::AddPane

Ajoute un volet.

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

Paramètres

pControlBar
[in] Pointeur vers le volet.

bTail
[in] TRUE pour ajouter le volet à la fin de la liste des volets du gestionnaire d’ancrage ; sinon, FALSE.

Valeur de retour

TRUE si le volet a été correctement inscrit auprès du gestionnaire d’ancrage ; sinon, FALSE.

CMDIChildWndEx ::AddTabbedPane

Ajoute un volet à onglets.

void AddTabbedPane(CDockablePane* pControlBar);

Paramètres

pControlBar
[in] Pointeur vers le volet.

CMDIChildWndEx ::AdjustDockingLayout

Ajuste la disposition d’ancrage.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Paramètres

hdwp
[in] Gérer vers une structure de position de fenêtre différée.

CMDIChildWndEx ::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Valeur de retour

Notes

CMDIChildWndEx ::CanShowOnWindowsList

Spécifie si le nom de la fenêtre enfant MDI peut être affiché dans la boîte de dialogue CLASSE CMFCWindowsManagerDialog .

virtual BOOL CanShowOnWindowsList();

Valeur de retour

TRUE si la fenêtre peut être affichée dans la boîte de dialogue Windows ; sinon, FALSE.

Notes

Remplacez cette méthode dans une classe dérivée et retournez FALSE si la fenêtre ne doit pas être affichée dans la boîte de dialogue Windows . Cette fonction est appelée à partir de CMFCWindowsManagerDialog.

CMDIChildWndEx ::D ockPane

Ancre un volet.

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

Paramètres

pBar
[in] Pointeur vers le volet.

nDockBarID
[in] ID du volet.

lpRect
[in] Pointeur vers un rectangle.

Notes

Le paramètre lpRect n’est pas utilisé.

CMDIChildWndEx ::D ockPaneLeftOf

Ancre un volet à gauche d’un autre volet.

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

Paramètres

pBar
Pointeur vers le volet à ancrer.

pLeftOf
Pointeur vers le volet qui sert de point de référence.

Valeur de retour

TRUE en cas de réussite, FALSE en cas d’échec.

Notes

Cette méthode prend le volet spécifié par pBar et l’ancre à gauche du volet spécifié par pLeftOf.

Appelez cette méthode lorsque vous souhaitez ancrer plusieurs volets dans un ordre prédéfini.

CMDIChildWndEx ::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.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Paramètres

dwDockStyle
[in] Spécifie les côtés de la fenêtre de cadre principale activée. Utilisez un ou plusieurs des indicateurs suivants.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Valeur de retour

TRUE si la méthode réussit ; sinon FALSE.

CMDIChildWndEx ::EnableDocking

Active l’ancrage de la fenêtre enfant sur le cadre principal.

BOOL EnableDocking(DWORD dwDockStyle);

Paramètres

dwDockStyle
[in] Spécifie l’alignement d’ancrage à activer.

Valeur de retour

TRUE si la méthode réussit ; sinon FALSE.

Notes

Appelez cette méthode pour activer l’alignement de l’ancrage sur le cadre principal. Vous pouvez passer une combinaison d’indicateurs CBRS_ALIGN_ (pour plus d’informations, consultez CControlBar ::EnableDocking).

CMDIChildWndEx ::GetDockingManager

CDockingManager* GetDockingManager();

Valeur de retour

Notes

CMDIChildWndEx ::GetDocumentName

Retourne le nom du document affiché dans la fenêtre enfant MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Valeur de retour

Pointeur vers une chaîne qui contient le nom d’un document.

Notes

Un document est ce que la fenêtre enfant MDI affiche. En règle générale, la fenêtre affiche les données chargées depuis ou enregistrées dans un fichier. Par conséquent, le nom du document est le nom du fichier. L’implémentation par défaut de GetDocumentName retourne une chaîne obtenue à partir de CDocument::GetPathName.

Si la fenêtre affiche un document qui n’est pas chargé à partir d’un fichier, remplacez cette méthode dans une classe dérivée et retournez un identificateur de document unique.

GetDocumentName est appelé par l’infrastructure lorsqu’elle enregistre l’état de tous les documents ouverts. La chaîne retournée est écrite dans le Registre.

Lorsque l’infrastructure restaure l’état ultérieurement, le nom du document est lu à partir du registre et transmis à CMDIFrameWndEx ::CreateDocumentWindow. Remplacez cette méthode dans une classe dérivée de CMDIFrameWndEx et créez ou ouvrez un document portant ce nom et lu dans le fichier portant ce nom. Si le document n’est pas basé sur un fichier, créez le document en fonction de l’identificateur de document lui-même. Vous devez effectuer les actions précédentes uniquement si vous envisagez d’enregistrer et de restaurer des documents.

Exemple

L'exemple suivant illustre l'utilisation de la méthode GetDocumentName. Cet extrait de code provient de l’exemple VisualStudioDemo : MFC Visual Studio Application.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx ::GetFrameIcon

Appelé par l’infrastructure pour récupérer l’icône de la fenêtre enfant MDI.

virtual HICON GetFrameIcon() const;

Valeur de retour

Handle vers l’icône de fenêtre.

Notes

Cette méthode est appelée par l’infrastructure pour déterminer l’icône à afficher sous l’onglet MDI qui contient la fenêtre image enfant MDI.

Par défaut, cette méthode retourne l’icône de fenêtre. Substituez-les GetFrameIcon dans une CMDIChildWndExclasse dérivée pour personnaliser ce comportement.

CMDIChildWndEx ::GetFrameText

Appelé par l’infrastructure pour récupérer le texte de la fenêtre enfant MDI.

virtual CString GetFrameText() const;

Valeur de retour

Chaîne qui contient le texte de la fenêtre cadre.

Notes

Cette méthode est appelée par l’infrastructure pour déterminer le texte à afficher sous l’onglet MDI qui contient la fenêtre de cadre enfant MDI.

Par défaut, cette méthode retourne le texte de la fenêtre. Substituez-les GetFrameText dans une CMDIChildWndExclasse dérivée pour personnaliser ce comportement.

CMDIChildWndEx ::GetPane

Recherche un volet par l’ID de contrôle spécifié.

CBasePane* GetPane(UINT nID);

Paramètres

nID
[in] ID de contrôle du volet à rechercher.

Valeur de retour

Pointeur vers le volet s’il est trouvé, sinon NULL.

CMDIChildWndEx ::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Valeur de retour

Notes

CMDIChildWndEx ::GetTabbedPane

Retourne un pointeur vers un volet d’ancrage qui fait partie d’un groupe de documents à onglets MDI.

CDockablePane* GetTabbedPane() const;

Valeur de retour

Pointeur vers un volet d’ancrage qui fait partie d’un groupe de documents à ongletS MDI.

CMDIChildWndEx ::GetToolbarButtonToolTipText

Appelé par l’infrastructure pour récupérer une info-bulle pour un bouton de barre d’outils.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Valeur de retour

TRUE si l’info-bulle a été affichée. L’implémentation par défaut retourne FALSE.

Notes

Remplacez cette méthode si vous souhaitez afficher des conseils d’outils personnalisés pour les boutons de barre d’outils.

CMDIChildWndEx ::InsertPane

Inscrit le volet spécifié auprès du gestionnaire d’ancrage.

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

Paramètres

pControlBar
[in] Pointeur vers le volet à insérer.

pTarget
[in] Pointeur vers le volet adjacent.

bAfter
[in] Si la valeur est TRUE, pControlBar est inséré après pTarget. Si la valeur est FALSE, pControlBar est inséré avant pTarget.

Valeur de retour

TRUE si la méthode réussit, FALSE sinon.

CMDIChildWndEx ::IsPointNearDockSite

Détermine si un point spécifié est proche du site d’ancrage.

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

Paramètres

point
[in] Point spécifié.

dwBarAlignment
[in] Spécifie le bord proche du point. Les valeurs possibles sont CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP et CBRS_ALIGN_BOTTOM

bOuterEdge
[in] TRUE si le point est proche de la bordure externe du site d’ancrage ; FALSE dans le cas contraire.

Valeur de retour

TRUE si le point est proche du site d’ancrage ; sinon FALSE.

Notes

Le point est proche du site d’ancrage lorsqu’il se trouve dans l’ensemble de sensibilité défini dans le gestionnaire d’ancrage. La sensibilité par défaut est de 15 pixels.

CMDIChildWndEx ::IsReadOnly

Spécifie si le document affiché dans la fenêtre enfant est en lecture seule.

virtual BOOL IsReadOnly();

Valeur de retour

TRUE si le document est en lecture seule ; sinon FALSE.

Notes

Cette fonction est utilisée pour empêcher l’enregistrement de documents en lecture seule.

Exemple

L’exemple suivant illustre la substitution de la IsReadOnly méthode. Cet extrait de code provient de l’exemple VisualStudioDemo : MFC Visual Studio Application.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx ::IsTabbedPane

Spécifie si la fenêtre enfant MDI contient un volet d’ancrage.

BOOL IsTabbedPane() const;

Valeur de retour

TRUE si la fenêtre enfant MDI contient un volet d’ancrage qui a été converti en document à onglets ; sinon FALSE.

CMDIChildWndEx ::OnMoveMiniFrame

Appelé par l’infrastructure pour déplacer une fenêtre mini-frame.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Paramètres

pFrame
[in] Pointeur vers une fenêtre mini-frame.

Valeur de retour

TRUE si la méthode réussit, sinon FALSE.

CMDIChildWndEx ::OnSetPreviewMode

Appelé par l’infrastructure pour entrer ou quitter le mode aperçu avant impression.

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

Paramètres

bPreview
[in] Si la valeur est TRUE, entrez le mode aperçu avant impression. Si la valeur est FALSE, quittez le mode aperçu avant impression.

pState
[in] Pointeur vers la structure d’état d’aperçu avant impression.

CMDIChildWndEx ::OnUpdateFrameTitle

Appelé par l’infrastructure pour mettre à jour le titre de l’image.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Paramètres

bAddToTitle
[in] Si la valeur est TRUE, ajoutez le nom du document au titre.

CMDIChildWndEx ::P aneFromPoint

Retourne le volet qui contient 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] Spécifie le point, dans les coordonnées de l’écran, à vérifier.

nSensitivity
[in] Augmentez la zone de recherche de cette quantité. Un volet répond aux critères de recherche si le point donné tombe dans la zone augmentée.

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

pRTCBarType
[in] Si elle n’est pas NULL, la méthode recherche uniquement les volets du type spécifié.

dwAlignment
[in] Si un volet se trouve au point spécifié, ce paramètre contient le côté du volet le plus proche du point spécifié. Pour plus d'informations, consultez la section Notes.

Valeur de retour

Pointeur vers l’objet CBasePanedérivé qui contient le point donné, ou NULL si aucun volet n’a été trouvé.

Notes

Appelez cette méthode pour déterminer si un volet contient le point spécifié en fonction des conditions spécifiées, telles que la classe runtime et la visibilité.

Lorsque la fonction retourne et qu’un volet a été trouvé, dwAlignment contient l’alignement du point spécifié. Par exemple, si le point était le plus proche du haut du volet, dwAlignment est défini sur CBRS_ALIGN_TOP.

CMDIChildWndEx ::RecalcLayout

Recalcule la disposition de la fenêtre.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Paramètres

bNotify
[in] Si la valeur est TRUE, l’élément actif sur place de la fenêtre reçoit la notification du changement de disposition.

CMDIChildWndEx ::RemovePaneFromDockManager

Supprime un volet du gestionnaire d’ancrage.

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

Paramètres

pControlBar
[in] Pointeur vers le volet à supprimer.

bDestroy
[in] Si la valeur est TRUE, le volet supprimé est détruit.

bAdjustLayout
[in] Si la valeur est TRUE, ajustez immédiatement la disposition d’ancrage.

bAutoHide
[in] Si la valeur est TRUE, la disposition d’ancrage est liée à la liste des barres d’autohide. Si la valeur est FALSE, la disposition d’ancrage est liée à la liste des volets standard.

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

CMDIChildWndEx ::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Paramètres

[in] p

Notes

CMDIChildWndEx ::ShowPane

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

Paramètres

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Notes

CMDIChildWndEx ::UpdateTaskbarTabIcon

Met à jour l’icône de l’onglet de la barre des tâches Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Paramètres

hIcon
Handle vers une icône à afficher sous l’onglet de la barre des tâches Windows 7.

Notes

CMDIChildWndEx ::UnregisterTaskbarTab

Supprime l’enfant MDI des onglets de la barre des tâches Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Paramètres

bCheckRegisteredMDIChildCount
Spécifie si cette fonction doit vérifier le nombre d’enfants MDI inscrits avec des onglets MDI. Si ce nombre est 0, cette fonction supprime le rectangle de découpage de la miniature de la barre des tâches de l’application.

Notes

CMDIChildWndEx ::SetTaskbarThumbnailClipRect

Appelé par l’infrastructure pour définir le rectangle de découpage pour sélectionner une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Paramètres

rect
Spécifie le nouveau rectangle de découpage. Si le rectangle est vide ou null, le découpage est supprimé.

Valeur de retour

TRUE en cas de réussite, sinon FALSE.

Notes

CMDIChildWndEx ::SetTaskbarTabProperties

Définit les propriétés d’un onglet de la barre des tâches Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Paramètres

dwFlags
Combinaison de valeurs STPFLAG. Pour plus d’informations, consultez ITaskbarList4 ::SetTabProperties.

Notes

CMDIChildWndEx ::SetTaskbarTabOrder

Insère l’enfant MDI avant la fenêtre spécifiée sous les onglets de la barre des tâches Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Paramètres

pWndBefore
Pointeur vers la fenêtre enfant MDI dont la miniature est insérée à gauche. Cette fenêtre doit déjà être inscrite via RegisterTaskbarTab. Si cette valeur est NULL, la nouvelle miniature est ajoutée à la fin de la liste.

Notes

CMDIChildWndEx ::SetTaskbarTabActive

Active l’onglet de la barre des tâches Windows 7 correspondant.

void SetTaskbarTabActive();

Notes

CMDIChildWndEx ::RegisterTaskbarTab

Inscrit l’enfant MDI avec les onglets de la barre des tâches Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Paramètres

Notes

CMDIChildWndEx ::OnTaskbarTabThumbnailStretch

Appelé par l’infrastructure lorsqu’il doit étirer une bitmap pour un aperçu miniature de la barre des tâches Windows 7 de l’enfant MDI.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Paramètres

hBmpDst
Handle vers une bitmap de destination.

rectDst
Spécifie le rectangle de destination.

hBmpSrc
Handle vers une bitmap source.

rectSrc
Spécifie le rectangle source.

Notes

Condition requise : afxmdichildwndex.h

CMDIChildWndEx ::OnTaskbarTabThumbnailMouseActivate

Appelé par l’infrastructure lorsque la miniature de l’onglet Barre des tâches doit traiter le message WM_MOUSEACTIVATE.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Paramètres

pDesktopWnd
Spécifie un pointeur vers la fenêtre parente de niveau supérieur de la fenêtre activée. Le pointeur peut être temporaire et ne doit pas être stocké.

nHitTest
Spécifie le code de zone de test de positionnement. Un test de positionnement est un test qui détermine l’emplacement du curseur.

message
Spécifie le numéro de message de la souris.

Notes

L’implémentation par défaut active l’image enfant MDI associée.

CMDIChildWndEx ::OnTaskbarTabThumbnailActivate

Appelé par l’infrastructure lorsque la miniature de l’onglet Barre des tâches doit traiter le message WM_ACTIVATE.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Paramètres

nState
Spécifie si l’option CWnd est activée ou désactivée.

pWndOther
Pointeur vers l’activation CWnd ou la désactivation. Le pointeur peut être NULL et il peut être temporaire.

bMinimized
Spécifie l’état réduit de l’activation ou de la CWnd désactivation. La valeur TRUE indique que la fenêtre est réduite.

Notes

L’implémentation par défaut active l’image enfant MDI associée.

CMDIChildWndEx ::OnPressTaskbarThmbnailCloseButton

Appelé par l’infrastructure lorsque l’utilisateur appuie sur le bouton Fermer sous l’onglet Barre des tâches.

virtual void OnPressTaskbarThmbnailCloseButton();

Notes

CMDIChildWndEx ::OnGetIconicThumbnail

Appelé par l’infrastructure lorsqu’il doit obtenir une bitmap pour la miniature emblématique de l’enfant MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Paramètres

nWidth
Spécifie la largeur de la bitmap requise.

nHeight
Spécifie la hauteur de la bitmap requise.

Notes

CMDIChildWndEx ::OnGetIconicLivePreviewBitmap

Appelé par l’infrastructure lorsqu’il doit obtenir une bitmap pour la préversion dynamique de l’enfant MDI.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Paramètres

bIsMDIChildActive
Ce paramètre a la valeur TRUE si la bitmap est demandée pour l’enfant MDI, qui est actuellement actif et que la fenêtre principale n’est pas réduite. Le traitement par défaut dans ce cas prend un instantané de la fenêtre principale.

ptLocation
Spécifie l’emplacement de la bitmap dans les coordonnées du client de fenêtre principale (de niveau supérieur). Ce point doit être fourni par l’appelé.

Valeur de retour

Si elle est traitée, retourne un handle à une bitmap 32bpp valide, sinon NULL.

Notes

Remplacez cette méthode dans une classe dérivée et retournez une bitmap 32bpp valide pour la préversion dynamique de l’enfant MDI. Cette méthode est appelée uniquement lorsque l’enfant MDI s’affiche sous les onglets de la barre des tâches Windows 7. Si vous retournez NULL, MFC appelle les gestionnaires par défaut et obtient des bitmaps à l’aide PrintClient ou PrintWindow.

CMDIChildWndEx ::m_dwDefaultTaskbarTabPropertyFlags

Combinaison d’indicateurs, qui est passée par l’infrastructure à la SetTaskbarTabProperties méthode, lorsqu’un onglet (enfant MDI) est inscrit avec les onglets de la barre des tâches Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Notes

La combinaison par défaut est STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx ::IsTaskbarThumbnailClipRectEnabled

Indique si la sélection automatique d’une partie de la zone cliente d’une fenêtre à afficher à mesure que la miniature de cette fenêtre dans la barre des tâches est activée ou désactivée.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Valeur de retour

Retourne TRUE si la sélection automatique d’une partie de la zone cliente d’une fenêtre à afficher est activée ; sinon FALSE.

Notes

CMDIChildWndEx ::IsTaskbarTabsSupportEnabled

Indique si l’enfant MDI peut apparaître sous les onglets de la barre des tâches Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Valeur de retour

TRUE si l’enfant MDI peut apparaître sous les onglets de la barre des tâches Windows 7 ; FALSE si l’enfant MDI ne peut pas apparaître sous les onglets de la barre des tâches Windows 7.

Notes

CMDIChildWndEx ::IsRegisteredWithTaskbarTabs

Retourne TRUE si l’enfant MDI a été correctement inscrit avec les onglets de la barre des tâches Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Valeur de retour

TRUE si l’enfant MDI est inscrit avec les onglets de la barre des tâches Windows 7 ; sinon FALSE.

Notes

CMDIChildWndEx ::InvalidateIconicBitmaps

Invalide une représentation bitmap emblématique d’un enfant MDI.

BOOL InvalidateIconicBitmaps();

Valeur de retour

Retourne FALSE si la prise en charge de la barre des tâches Windows 7 est désactivée ou si l’enfant MDI n’est pas inscrit avec les onglets de la barre des tâches Windows 7 ; retourne sinon TRUE.

Notes

Doit être appelé lorsque le contenu ou la taille dynamique d’un enfant MDI a changé.

CMDIChildWndEx ::GetTaskbarThumbnailClipRect

Appelé par l’infrastructure lorsqu’il doit sélectionner une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.

virtual CRect GetTaskbarThumbnailClipRect() const;

Valeur de retour

Rectangle dans les coordonnées windows. Ce rectangle est mappé à la zone cliente du cadre de niveau supérieur. Le rectangle doit être vide pour effacer le rectangle de découpage.

Notes

CMDIChildWndEx ::GetTaskbarPreviewWnd

Appelé par l’infrastructure lorsqu’il doit obtenir une fenêtre enfant (généralement une fenêtre d’affichage ou de fractionnement) à afficher sur une miniature de la barre des tâches Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Valeur de retour

Doit retourner un pointeur valide vers un CWnd objet, dont l’aperçu doit être affiché sous un onglet de barre des tâches Windows 7 lié à cet enfant MDI. L’implémentation par défaut retourne une fenêtre enfant de cet enfant MDI avec AFX_IDW_PANE_FIRST ID de contrôle (qui est généralement une CViewclasse dérivée).

Notes

CMDIChildWndEx ::GetTabProxyWnd

Retourne la fenêtre proxy d’onglet inscrite avec les onglets de la barre des tâches Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Valeur de retour

Pointeur vers un CMDITabProxyWnd objet, qui est inscrit avec les onglets de la barre des tâches Windows 7.

Notes

CMDIChildWndEx ::EnableTaskbarThumbnailClipRect

Active ou désactive la sélection automatique d’une partie de la zone cliente d’une fenêtre à afficher en tant que miniature de cette fenêtre dans la barre des tâches.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Paramètres

bEnable
Spécifie s’il faut activer (TRUE) ou désactiver la sélection automatique (FALSE) d’une partie de la zone cliente d’une fenêtre à afficher.

Notes

CMDIChildWndEx ::CanShowOnTaskBarTabs

Indique à l’infrastructure si cet enfant MDI peut être affiché sous les onglets de la barre des tâches Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Valeur de retour

TRUE si le contenu de l’enfant MDI peut être affiché sur les miniatures de la barre des tâches Windows 7.

Notes

Remplacez cette méthode dans une classe dérivée et retournez FALSE pour désactiver l’apparence de cet enfant MDI sous les onglets de la barre des tâches Windows 7.

CMDIChildWndEx ::ActivateTopLevelFrame

Appelé par l’infrastructure pour activer le cadre de niveau supérieur lorsque l’application est activée à partir d’un onglet de barre des tâches.

virtual void ActivateTopLevelFrame();

Notes

Voir aussi

Graphique hiérarchique
Classes
CMDIChildWnd, classe
CMFCWindowsManagerDialog, classe
CMDIFrameWndEx, classe

Partager via

CMDIChildWndEx, classe

Syntaxe

Membres

Méthodes publiques

Notes

Exemple

Hiérarchie d'héritage

Spécifications

CMDIChildWndEx ::AddPane

Paramètres

Valeur de retour

CMDIChildWndEx ::AddTabbedPane

Paramètres

CMDIChildWndEx ::AdjustDockingLayout

Paramètres

CMDIChildWndEx ::CanShowOnMDITabs

Valeur de retour

Notes

CMDIChildWndEx ::CanShowOnWindowsList

Valeur de retour

Notes

CMDIChildWndEx ::D ockPane

Paramètres

Notes

CMDIChildWndEx ::D ockPaneLeftOf

Paramètres

Valeur de retour

Notes

CMDIChildWndEx ::EnableAutoHidePanes

Paramètres

Valeur de retour

CMDIChildWndEx ::EnableDocking

Paramètres

Valeur de retour

Notes

CMDIChildWndEx ::GetDockingManager

Valeur de retour

Notes

CMDIChildWndEx ::GetDocumentName

Valeur de retour

Notes

Exemple

CMDIChildWndEx ::GetFrameIcon

Valeur de retour

Notes

CMDIChildWndEx ::GetFrameText

Valeur de retour

Notes

CMDIChildWndEx ::GetPane

Paramètres

Valeur de retour

CMDIChildWndEx ::GetRelatedTabGroup

Valeur de retour

Notes

CMDIChildWndEx ::GetTabbedPane

Valeur de retour

CMDIChildWndEx ::GetToolbarButtonToolTipText

Valeur de retour

Notes

CMDIChildWndEx ::InsertPane

Paramètres

Valeur de retour

CMDIChildWndEx ::IsPointNearDockSite

Paramètres

Valeur de retour

Notes

CMDIChildWndEx ::IsReadOnly

Valeur de retour

Notes

Exemple

CMDIChildWndEx ::IsTabbedPane

Valeur de retour

CMDIChildWndEx ::OnMoveMiniFrame

Paramètres

Valeur de retour

CMDIChildWndEx ::OnSetPreviewMode

Paramètres

CMDIChildWndEx ::OnUpdateFrameTitle

Paramètres