CTabbedPane osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Levehető lapokkal rendelkező panel funkcióit valósítja meg.

vagy további részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CTabbedPane : public CBaseTabbedPane

Tagok

Nyilvános konstruktorok

Név	Description
CTabbedPane::CTabbedPane	Alapértelmezett konstruktor.

Nyilvános metódusok

Név	Description
CTabbedPane::D etachPane	(Felülbírálja a CBaseTabbedPane::D etachPane.)
CTabbedPane::EnableTabAutoColor	Engedélyezi vagy letiltja a lapok automatikus színezését.
CTabbedPane::FloatTab	Egy panelt lebegtet, de csak akkor, ha az ablaktábla jelenleg leválasztható lapon található. (A CBaseTabbedPane felülbírálása::FloatTab.)
CTabbedPane::GetTabArea	A lapfülterület méretét és pozícióját adja vissza a lapfüles ablakban.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode	Meghatározza, hogy a lapozott panel átváltható-e automatikus felfedés módra. (Felülbírálja a CBaseTabbedPane::HasAutoHideMode.)
CTabbedPane::IsTabLocationBottom	Meghatározza, hogy a lapok az ablak alján találhatók-e.
CTabbedPane::ResetTabs	Alaphelyzetbe állítja az összes lapozott panelt az alapértelmezett állapotra.
CTabbedPane::SetTabAutoColors	Beállítja az automatikus színfunkció engedélyezésekor használható egyéni színek listáját.

Adattagok

Név	Description
CTabbedPane::m_bTabsAlwaysTop	Az alkalmazás lapfüleinek alapértelmezett helye.
CTabbedPane::m_pTabWndRTC	Az egyéni CMFCTabCtrlszármaztatott objektumok futtatókörnyezeti osztályának adatai.

Megjegyzések

A keretrendszer automatikusan létrehozza az osztály egy példányát, amikor egy felhasználó az egyik panelt egy másikhoz csatolja a második panel feliratára mutatva. A keretrendszer által létrehozott összes lapozott panel -1 azonosítóval rendelkezik.

Ha az Outlook-stílusú lapok helyett normál lapokat szeretne megadni, adja át a AFX_CBRS_REGULAR_TABS stílust a CDockablePane::CreateEx metódusnak.

Ha levehető lapokat tartalmazó füles panelt hoz létre, előfordulhat, hogy a keretrendszer automatikusan megsemmisíti a panelt, ezért ne tárolja a mutatót. Ha a lapozott panelre szeretne mutatót kapni, hívja meg a metódust CBasePane::GetParentTabbedPane .

Examples

Ebben a példában létrehozunk egy objektumot CTabbedPane . A következő lépésben a CBaseTabbedPane::AddTab parancsot használjuk további lapok csatolásához.

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);

Többlapos vezérlősáv-objektum létrehozásának másik módja a CDockablePane::AttachToTabWnd használata. A AttachToTabWnd metódus dinamikusan hoz létre egy többlapos panelobjektumot a CDockablePane::SetTabbedPaneRTC által beállított futtatókörnyezeti osztályadatok használatával.

Ebben a példában dinamikusan hozunk létre egy lapfület, csatolunk két lapot, és a második lapot nem leválaszthatóvá tesszük.

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);

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CBaseTabbedPane

CTabbedPane

Requirements

Fejléc: afxTabbedPane.h

CTabbedPane::D etachPane

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

Paraméterek

[in] pBar

[in] bHide

Visszaadott érték

Megjegyzések

CTabbedPane::EnableTabAutoColor

Engedélyezi vagy letiltja a lapok automatikus színezését.

static void EnableTabAutoColor(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] IGAZ a lapok automatikus színezésének engedélyezéséhez; egyéb esetben HAMIS.

Megjegyzések

Ezzel a statikus módszerrel engedélyezheti vagy letilthatja a lapok automatikus színezését az alkalmazás összes lapozott ablaktábláján. Ha ez a funkció engedélyezve van, minden lap saját színnel van kitöltve. A lapok színezéséhez használt színek listáját a CMFCBaseTabCtrl::GetAutoColors metódus meghívásával találja meg.

A lapokhoz használt színek listáját a CTabbedPane::SetTabAutoColors meghívásával adhatja meg.

Ez a beállítás alapértelmezés szerint le van tiltva.

CTabbedPane::FloatTab

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

Paraméterek

[in] pBar
[in] nTabID
[in] dockMethod
[in] bHide

Visszaadott érték

Megjegyzések

CTabbedPane::GetTabArea

A lapfülterület méretét és pozícióját adja vissza a lapfüles ablakban.

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

Paraméterek

rectTabAreaTop
[kifelé] A felső lapterület méretét és pozícióját tartalmazza képernyőkoordinátákban.

rectTabAreaBottom
[kifelé] Az alsó lapterület méretét és pozícióját tartalmazza a képernyő koordinátáiban.

Megjegyzések

A keretrendszer meghívja ezt a metódust, hogy meghatározza, hogyan rögzíthet egy olyan panelt, amelyet a felhasználó húz. Amikor a felhasználó áthúz egy panelt a célpanel lapterülete fölé, a keretrendszer megpróbálja hozzáadni azt a célpanel új lapjaként. Ellenkező esetben megpróbálja a célpanel oldalára rögzíteni az ablaktáblát, amely magában foglalja egy új ablaktábla-tároló létrehozását a két ablaktáblát elválasztó ablaktábla-elválasztóval.

A viselkedés módosításához felülbírálja ezt a metódust egy CTabbedPane-származtatott osztályban.

CTabbedPane::GetTabWnd

CMFCTabCtrl* GetTabWnd() const;

Visszaadott érték

Megjegyzések

CTabbedPane::HasAutoHideMode

virtual BOOL HasAutoHideMode() const;

Visszaadott érték

Megjegyzések

CTabbedPane::IsTabLocationBottom

Meghatározza, hogy a lapok az ablak alján találhatók-e.

virtual BOOL IsTabLocationBottom() const;

Visszaadott érték

IGAZ, ha a tabulátorterület a füles ablak alján található; egyéb esetben HAMIS.

Megjegyzések

CTabbedPane::m_bTabsAlwaysTop

Az alkalmazás lapfüleinek alapértelmezett helye.

AFX_IMPORT_DATA static BOOL m_bTabsAlwaysTop;

Megjegyzések

Állítsa ezt a statikus tagot IGAZ értékre, hogy az alkalmazás összes lapja megjelenjen a lapfül tetején.

Ezt az értéket a lapozott ablaktábla létrehozása előtt kell beállítania.

Az alapértelmezett érték HAMIS.

CTabbedPane::m_pTabWndRTC

Az egyéni CMFCTabCtrlszármaztatott objektumok futtatókörnyezeti osztályának adatai.

AFX_IMPORT_DATA static CRuntimeClass* m_pTabWndRTC;

Megjegyzések

Állítsa ezt a statikus tagváltozót egy -származtatott objektum futtatókörnyezeti osztályadataira CMFCTabCtrlmutató mutatóra, ha egy lapozott panelen belül egyéni lapozott ablakot használ.

CTabbedPane::ResetTabs

Alaphelyzetbe állítja az összes lapozott panelt az alapértelmezett állapotra.

static void ResetTabs();

Megjegyzések

Ennek a metódusnak a meghívásával visszaállíthatja az összes lapozott panelt az alapértelmezett állapotba. Hívás esetén ez a metódus alaphelyzetbe állítja az összes lapozott ablaktábla szegélyméretét és automatikus színállapotát.

CTabbedPane::SetTabAutoColors

Beállítja az automatikus színfunkció engedélyezésekor használt egyéni színek listáját.

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

Paraméterek

arColors
[in] A beállítandó színek tömbjét tartalmazza.

Megjegyzések

Ezzel a módszerrel testre szabhatja az automatikus színfunkció engedélyezésekor használt színek listáját. Ez egy statikus függvény, amely az alkalmazás összes lapozott ablaktábláját érinti.

A CTabbedPane::EnableTabAutoColor használatával engedélyezheti vagy letilthatja az automatikus szín funkciót.

Lásd még

hierarchiadiagram
osztályok
CDockablePane osztály
CBaseTabbedPane osztály
CMFCOutlookBar osztály