CTabbedPane – třída
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
| Název | Popis |
|---|---|
CTabbedPane::CTabbedPane |
Výchozí konstruktor. |
Veřejné metody
| Název | 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
| Název | 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
Architektura automaticky vytvoří instanci této třídy, když uživatel připojí jedno podokno k druhému tak, že nasměruje na titulek 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
Požadavky
Záhlaví: afxTabbedPane.h
CTabbedPane::D etachPane
virtual BOOL DetachPane(
CWnd* pBar,
BOOL bHide = FALSE);
Parametry
[v] pBar
[v] bHide
Návratová 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
Návratová 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;
Návratová hodnota
Poznámky
CTabbedPane::HasAutoHideMode
virtual BOOL HasAutoHideMode() const;
Návratová hodnota
Poznámky
CTabbedPane::IsTabLocationBottom
Určuje, zda jsou karty umístěny v dolní části okna.
virtual BOOL IsTabLocationBottom() const;
Návratová 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