CDockablePane::AttachToTabWnd

Článek
06/10/2015

Připojí aktuálním podokně do podokna cíl vytváření podokno s kartami.

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

Parametry

[v] [výstup]pTabControlBarAttachTo
Určuje cílový panel, který připojí aktuální podokno.Podokno cíl musí být dokovací podokna.
[v]dockMethod
Určuje metodu dokovací.
[v]bSetActive
TRUEaktivujte podokno s kartami po operaci připojit; jinak FALSE .
[výstup]ppTabbedControlBar
Obsahuje podokno s kartami, která je výsledkem operace připojit.

Vrácená hodnota

Ukazatel aktuální podokna, pokud není podokno s kartami; jinak ukazatel na podokno s kartami, která je výsledkem operace připojit.Vrácená hodnota je NULL aktuální podokno nelze připojit nebo dojde k chybě.

Poznámky

Při jednom podokně dokovací připojí do jiného podokna touto metodou, nastane následující:

Rámec kontroly zda cílové podokno pTabControlBarAttachTo je pravidelně ukotvení podokna nebo pokud je odvozen od CBaseTabbedPane.
Pokud je cíl podokno podokno s kartami, rámci přidána v aktuálním podokně jako karta.
Pokud je podokno cílové pravidelné ukotvení podokna, vytvoří rámci podokno s kartami.
- Volání rámci pTabControlBarAttachTo->CreateTabbedPane .Styl podokna s kartami závisí m_pTabbedControlBarRTC člena.Výchozí nastavení tohoto člena je třída runtime CTabbedPane.Pokud předáte AFX_CBRS_OUTLOOK_TABS styl jako dwTabbedStyle parametr CDockablePane::Create , objekt třídy runtime je metoda nastavena na třídu runtime CMFCOutlookBar.Tohoto člena můžete změnit kdykoli změnit styl podokna.
- Tato metoda vytvoří podokno s kartami, nahradí rámci ukazatel na pTabControlBarAttachTo (Pokud v podokně je ukotvený nebo plovoucí v okně multi-miniframe) s ukazatelem na nové podokno s kartami.
- Přidá rozhraní pTabControlBarAttachTo podokně do podokna s kartami jako první kartu.Rámci pak přidá druhé kartě aktuálního podokna.
Pokud aktuální podokno je odvozen od CBaseTabbedPane , všechny své karty přesunuty do pTabControlBarAttachTo a aktuální podokno zničen.Proto buďte opatrní při volání této metody, protože ukazatel aktuální podokno může být neplatná metoda vrátí.