Sdílet prostřednictvím

CTabbedPane – třída

  • Článek

Implementuje funkce podokna s odpojenými kartami.

Nebo více podrobností viz zdrojový kód umístěný ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CTabbedPane : public CBaseTabbedPane

Členové

Veřejné konstruktory

Jméno popis
CTabbedPane::CTabbedPane Výchozí konstruktor.

Veřejné metody

Jméno popis
CTabbedPane::D etachPane (Přepsání CBaseTabbedPane::D etachPane.)
CTabbedPane::EnableTabAutoColor Povolí nebo zakáže automatické zabarvení karet.
CTabbedPane::FloatTab Plovoucí podokno, ale pouze v případě, že je podokno aktuálně umístěné na odpojené kartě. (Přepíše CBaseTabbedPane::FloatTab.)
CTabbedPane::GetTabArea Vrátí velikost a umístění oblasti tabulátoru v okně s kartami.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode Určuje, zda lze podokno s kartami přepnout do režimu automatického skrytí. (Přepsání CBaseTabbedPane::HasAutoHideMode.)
CTabbedPane::IsTabLocationBottom Určuje, zda jsou karty umístěny v dolní části okna.
CTabbedPane::ResetTabs Obnoví výchozí stav všech podoken na záložkách.
CTabbedPane::SetTabAutoColors Nastaví seznam vlastních barev, které se dají použít, když je povolená funkce automatické barvy.

Datové členy

Jméno popis
CTabbedPane::m_bTabsAlwaysTop Výchozí umístění karet v aplikaci.
CTabbedPane::m_pTabWndRTC Informace o třídě modulu runtime pro vlastní CMFCTabCtrlodvozený objekt

Poznámky

Rozhraní automaticky vytvoří instanci této třídy, když uživatel připojí jedno podokno k druhému tak, že nasměruje na popis druhého podokna. Všechna podokna s kartami vytvořená architekturou mají ID -1.

Pokud chcete místo karet ve stylu Outlooku zadat běžné karty, předejte styl AFX_CBRS_REGULAR_TABS metodě CDockablePane::CreateEx .

Pokud vytvoříte podokno s kartami s odpojenými kartami, může být podokno automaticky zničeno architekturou, takže byste neměli uložit ukazatel. Pokud chcete získat ukazatel na podokno s kartami, zavolejte metodu CBasePane::GetParentTabbedPane .

Příklady

V tomto příkladu CTabbedPane vytvoříme objekt. Dále použijeme CBaseTabbedPane::AddTab k připojení dalších karet.

CTabbedPane* pTabbededBar = new CTabbedPane (TRUE);

if (!pTabbededBar->Create (_T(""),
    this,
    CRect (0,
    0,
    200,
    200),
    TRUE,
    (UINT) -1,
    WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |
    WS_CLIPCHILDREN | CBRS_LEFT |
    CBRS_FLOAT_MULTI))
{
    TRACE0("Failed to create Solution Explorer bar\n");

    return FALSE;      // fail to create
}

pTabbededBar->AddTab (&m_wndClassView);
pTabbededBar->AddTab (&m_wndResourceView);

pTabbededBar->AddTab (&m_wndFileView);
pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);

DockPane(pTabbededBar);

Dalším způsobem, jak vytvořit objekt řídicího panelu s kartami, je použít CDockablePane::AttachToTabWnd. Metoda AttachToTabWnd dynamicky vytvoří objekt podokna s kartami pomocí informací třídy modulu runtime nastavený CDockablePane ::SetTabbedPaneRTC.

V tomto příkladu vytvoříme dynamicky podokno s kartami, připojíme dvě karty a nastavíme druhou kartu, která není odpojitelná.

DockPane(&m_wndClassView);

CTabbedPane* pTabbedBar = NULL;
m_wndResourceView.AttachToTabWnd (&m_wndClassView,
    DM_SHOW,
    TRUE,
    (CDockablePane**) &pTabbedBar);

m_wndFileView.AttachToTabWnd (pTabbedBar,
    DM_SHOW,
    TRUE,
    (CDockablePane**) &pTabbedBar);

pTabbedBar->GetUnderlyingWindow ()->EnableTabDetach (1,
    FALSE);

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

CBasePane

Podokno CPane

CDockablePane

CBaseTabbedPane

CTabbedPane

Požadavky

Záhlaví: afxTabbedPane.h

CTabbedPane::D etachPane

virtual BOOL DetachPane(
    CWnd* pBar,
    BOOL bHide = FALSE);

Parametry

[v] pBar

[v] bHide

Vrácená hodnota

Poznámky

CTabbedPane::EnableTabAutoColor

Povolí nebo zakáže automatické zabarvení karet.

static void EnableTabAutoColor(BOOL bEnable = TRUE);

Parametry

bEnable
[v] TRUE pro povolení automatického barvení karet; jinak NEPRAVDA.

Poznámky

Tuto statickou metodu použijte k povolení nebo zakázání automatického obarvení karet ve všech podoknech s kartami v aplikaci. Pokud je tato funkce povolená, každá karta se vyplní vlastní barvou. Seznam barev, které se používají k obarvení karet můžete najít voláním CMFCBaseTabCtrl::GetAutoColors metoda.

Seznam barev, které se použijí pro karty, můžete zadat voláním CTabbedPane::SetTabAutoColors.

Ve výchozím nastavení je tato možnost zakázaná.

CTabbedPane::FloatTab

virtual BOOL FloatTab(
    CWnd* pBar,
    int nTabID,
    AFX_DOCK_METHOD dockMethod,
    BOOL bHide = FALSE);

Parametry

[v] pBar
[v] nTabID
[v] dockMethod
[v] bHide

Vrácená hodnota

Poznámky

CTabbedPane::GetTabArea

Vrátí velikost a umístění oblasti tabulátoru v okně s kartami.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parametry

rectTabAreaTop
[ven] Obsahuje velikost a umístění v souřadnicích obrazovky horní oblasti tabulátoru.

rectTabAreaBottom
[ven] Obsahuje velikost a umístění v souřadnicích obrazovky v oblasti dolní karty.

Poznámky

Architektura volá tuto metodu k určení, jak ukotvit podokno, které uživatel přetahuje. Když uživatel přetáhne podokno přes oblast karty cílového podokna, architektura se ji pokusí přidat jako novou kartu cílového podokna. V opačném případě se pokusí ukotvit podokno na stranu cílového podokna, což zahrnuje vytvoření nového kontejneru podokna s oddělovačem podokna, který odděluje obě podokna.

Přepsat tuto metodu v -odvozené CTabbedPanetřídě změnit toto chování.

CTabbedPane::GetTabWnd

CMFCTabCtrl* GetTabWnd() const;

Vrácená hodnota

Poznámky

CTabbedPane::HasAutoHideMode

virtual BOOL HasAutoHideMode() const;

Vrácená hodnota

Poznámky

CTabbedPane::IsTabLocationBottom

Určuje, zda jsou karty umístěny v dolní části okna.

virtual BOOL IsTabLocationBottom() const;

Vrácená hodnota

TRUE, pokud je oblast karty umístěna v dolní části okna s kartami; jinak NEPRAVDA.

Poznámky

CTabbedPane::m_bTabsAlwaysTop

Výchozí umístění karet v aplikaci.

AFX_IMPORT_DATA static BOOL m_bTabsAlwaysTop;

Poznámky

Nastavte tento statický člen na hodnotu TRUE, aby se všechny karty v aplikaci zobrazovaly v horní části podokna s kartami.

Tuto hodnotu musíte nastavit před vytvořením podokna s kartami.

Výchozí hodnota je FALSE.

CTabbedPane::m_pTabWndRTC

Informace o třídě modulu runtime pro vlastní CMFCTabCtrlodvozený objekt

AFX_IMPORT_DATA static CRuntimeClass* m_pTabWndRTC;

Poznámky

Tuto statickou členovou proměnnou nastavte na ukazatel na informace o třídě modulu runtime odvozeného CMFCTabCtrlobjektu, pokud používáte vlastní okno s kartami uvnitř podokna s kartami.

CTabbedPane::ResetTabs

Obnoví výchozí stav všech podoken na záložkách.

static void ResetTabs();

Poznámky

Voláním této metody vrátíte všechna podokna s kartami do výchozího stavu. Při zavolání tato metoda obnoví velikosti ohraničení a stav automatické barvy všech podoken karet.

CTabbedPane::SetTabAutoColors

Nastaví seznam vlastních barev, které se použijí, když je povolená funkce automatické barvy.

static void SetTabAutoColors(const CArray<COLORREF, COLORREF>& arColors);

Parametry

arColors
[v] Obsahuje pole barev, které chcete nastavit.

Poznámky

Pomocí této metody můžete přizpůsobit seznam barev, které se použijí, když je povolená funkce automatické barvy. Jedná se o statickou funkci, která ovlivňuje všechna podokna s kartami ve vaší aplikaci.

K povolení nebo zakázání funkce automatické barvy použijte CTabbedPane::EnableTabAutoColor .

Viz také

Graf hierarchie
Třídy
CDockablePane – třída
CBaseTabbedPane – třída
CMFCOutlookBar – třída