CDockablePane::AttachToTabWnd

Artykuł
02/27/2013

Dołącza bieżące okienko okienku docelowego tworzenie okienko z kartami.

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

Parametry

[w] [out]pTabControlBarAttachTo
Określa, w okienku docelowego łączący bieżącego okienka.W okienku docelowego musi być dokujące okienka.
[w]dockMethod
Określa metodę dokowania.
[w]bSetActive
TRUEAby uaktywnić okienko z kartami po operacji dołączania; w przeciwnym razie FALSE.
[out]ppTabbedControlBar
Zawiera okienko z kartami, wynikającą z operacji dołączania.

Wartość zwracana

Wskaźnik do bieżącego okienka, jeśli nie jest okienko z kartami; w przeciwnym razie wskaźnik do okienka z kartami, wynikającą z operacji dołączania.Zwracana jest wartość NULL , jeśli nie można dołączyć bieżącego okienka lub jeśli wystąpi błąd.

Uwagi

Gdy jeden dokujące okienko dołącza się do innego okienka, za pomocą tej metody, są następujące operacje:

Ramy kontroli czy okienku docelowego pTabControlBarAttachTo jest regularnie Dokowanie okienka lub jeśli jest pochodną CBaseTabbedPane.
Jeśli okienko docelowy jest okienko z kartami, ramy dodaje bieżącego okienka do niej jako karty.
Jeśli okienko docelowy jest regularne okienku dokowania, ramy tworzy okienko z kartami.
- Wywołania RAM pTabControlBarAttachTo->CreateTabbedPane.Styl okienka z kartami zależy od m_pTabbedControlBarRTC Członkowskich.Domyślnie, członek ten jest ustawiona do klasy runtime CTabbedPane.Jeśli przekaże AFX_CBRS_OUTLOOK_TABS styl jako dwTabbedStyle parametr CDockablePane::Create metody obiektu klasy runtime jest ustawiona do klasy runtime CMFCOutlookBar.Członek ten można zmienić w dowolnym momencie zmienić styl nowego okienka.
- Ta metoda tworzy się okienko z kartami, ramy zastępuje wskaźnik do pTabControlBarAttachTo (Jeśli okienko jest ruchomego lub zadokowanego w oknie multi-miniframe) za pomocą wskaźnika do okienka z kartami.
- Dodaje w ramach pTabControlBarAttachTo okienku do okienka z kartami jako pierwszy tabulator.Ramy dodaje jako druga karta bieżącego okienka.
Jeśli bieżące okienko jest pochodną CBaseTabbedPane, wszystkie swoje karty są przenoszone do pTabControlBarAttachTo i bieżące okienko jest niszczony.Dlatego należy zachować ostrożność podczas wywołanie tej metody, ponieważ wskaźnik do bieżącego okienka mogą być nieprawidłowe, gdy metoda zwraca wartość.