CDockablePane::AttachToTabWnd

Article
06/10/2015

Joint le volet actif à un volet cible, la création d'un volet à onglets.

virtual CDockablePane* AttachToTabWnd( 
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive = TRUE,
    CDockablePane** ppTabbedControlBar = NULL
);

Paramètres

[in] [out] pTabControlBarAttachTo
Spécifie le volet cible à laquelle le volet actif est attaché. Le volet cible doit être un volet ancrable.
[in] dockMethod
Spécifie la méthode d'ancrage.
[in] bSetActive
TRUE pour activer le volet à onglets après l'opération d'attachement ; sinon, FALSE.
[out] ppTabbedControlBar
Contient le volet à onglets ce les résultats de l'opération d'attachement.

Valeur de retour

Pointeur vers le volet actif, si ce n'est pas un volet à onglets ; sinon un pointeur vers le volet à onglets qui résulte de l'opération d'attachement. La valeur de retour est NULL si le volet actif ne peut pas être attaché, ou si une erreur se produit.

Notes

Lorsqu'un volet ancrable s'attache à un autre volet à l'aide de cette méthode, suivants se produit :

l'infrastructure vérifie si le volet cible pTabControlBarAttachTo est un volet d'ancrage normal ou s'il est dérivé de CBaseTabbedPane.
Si le volet cible est un volet à onglets, l'infrastructure ajoute le volet actif à celui-ci comme un tableau.
Si le volet cible est un volet d'ancrage normal, l'infrastructure crée un volet à onglets.
- l'infrastructure appelle pTabControlBarAttachTo->CreateTabbedPane. Le style du nouveau volet à onglets dépend du membre d' m_pTabbedControlBarRTC . Par défaut, ce membre est défini à la classe d'exécution de CTabbedPane. Si vous passez le style d' AFX_CBRS_OUTLOOK_TABS comme paramètre d' dwTabbedStyle à la méthode de CDockablePane::Create , l'objet de classe de runtime est défini à la classe d'exécution de CMFCOutlookBar. Vous pouvez modifier ce membre à tout moment pour modifier le style du nouveau volet.
- Lorsque cette méthode crée un volet à onglets, l'infrastructure remplace le pointeur à pTabControlBarAttachTo (si le volet est ancré ou flottant dans une fenêtre mini-frame multi -) avec un pointeur vers le nouveau volet à onglets.
- L'infrastructure ajoute le volet d' pTabControlBarAttachTo au volet à onglets comme première table. L'infrastructure ajoute ensuite le volet actif comme deuxième tableau.
Si le volet actuel est dérivé d' CBaseTabbedPane, tous ses onglets sont déplacés vers pTabControlBarAttachTo et le volet actif est détruit. , Soyez vigilant par conséquent lorsque vous appelez cette méthode, car un pointeur vers le volet actuel peut être incorrect lorsque la méthode retourne.