CMDIChildWndEx, classe
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 | Mises à jour icône d’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, à case activée.
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
Mises à jour l’icône 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 case activée 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
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 ::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 une 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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour