CMFCTabCtrl 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.

Az CMFCTabCtrl osztály egy tabulátorvezérlő funkcióit biztosítja. A tabulátor vezérlőelem egy rögzíthető ablakot jelenít meg, amelynek tetején vagy alján lapos vagy háromdimenziós fülek találhatók. A lapok megjeleníthetik a szöveget és a képet, és aktív állapotban módosíthatják a színt.

Szemantika

class CMFCTabCtrl : public CMFCBaseTabCtrl

Tagok

Nyilvános konstruktorok

Név	Description
CMFCTabCtrl::CMFCTabCtrl	Alapértelmezett konstruktor.
CMFCTabCtrl::~CMFCTabCtrl	Destruktor.

Nyilvános metódusok

Név	Description
CMFCTabCtrl::ActivateMDITab	Megjeleníti az aktuális lap vezérlőelem megadott lapját, és beállítja a fókuszt erre a lapra.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Megadja, hogy a keretrendszer átméretezi-e az összes lapvezérlő ablak ügyfélterületét, amikor megváltozik a lapvezérlő felhasználói felületének eleme.
CMFCTabCtrl::CalcRectEdit	A megadott lapterület méretének lefedése. (Felülbírálások CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create	Létrehozza a tabulátorvezérlőt, és csatolja az CMFCTabCtrl objektumhoz.
CMFCTabCtrl::CreateObject	A keretrendszer egy ilyen típusú dinamikus példány létrehozásához használja.
CMFCTabCtrl::EnableActiveTabCloseButton	Megjeleníti vagy elrejti a Bezárás gombot ( X) az aktív lapon.
CMFCTabCtrl::EnableInPlaceEdit	Engedélyezi vagy letiltja a szerkeszthető lapcímkéket. (Felülbírálások CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu	Lecserél két gombot, amelyek görgetik az ablakfüleket egy olyan gombra, amely megnyitja a többlapos ablakok menüjét.
CMFCTabCtrl::EnsureVisible	Biztosítja, hogy egy lap látható legyen.
CMFCTabCtrl::GetDocumentIcon	Lekéri a lapfülhöz társított szimbólumot a füles ablakok előugró menüjében.
CMFCTabCtrl::GetFirstVisibleTabNum	Az aktuális lap vezérlőelemben látható első lap indexét kéri le.
CMFCTabCtrl::GetResizeMode	Beolvas egy értéket, amely meghatározza az aktuális lap vezérlőelem átméretezését.
CMFCTabCtrl::GetScrollBar	A lap vezérlőelemhez társított görgetősáv-objektumra mutató mutatót kér le.
CMFCTabCtrl::GetTabArea	Lekéri a tabulátorcímke területének határoló téglalapját a tabulátor vezérlőelem tetején vagy alján. (Felülbírálások CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint	Lekéri a megadott pontot tartalmazó lapot. (Felülbírálások CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth	Lekéri egy lap maximális szélességét.
CMFCTabCtrl::GetTabsHeight	Lekéri az aktuális tabulátor vezérlőelem lapterületének magasságát.
CMFCTabCtrl::GetTabsRect	Beolvas egy téglalapot, amely az aktuális tabulátor vezérlőelem lapterületét határolja. (Felülbírálások CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass	A keretrendszer az ehhez az CRuntimeClass osztálytípushoz társított objektumra mutató mutató lekéréséhez használja.
CMFCTabCtrl::GetWndArea	Lekéri az aktuális lap vezérlőelem ügyfélterületének határát.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Elrejti az aktív ablak vízszintes görgetősávját, ha van ilyen.
CMFCTabCtrl::HideInactiveWindow	Megadja, hogy a keretrendszer inaktív lapvezérlő ablakokat jelenít-e meg.
CMFCTabCtrl::HideNoTabs	Engedélyezi vagy letiltja a lapterület rajzolását, ha nincsenek látható lapok.
CMFCTabCtrl::HideSingleTab	Engedélyezi vagy letiltja a lap rajzolását, ha egyetlen többlapos ablak van. (Felülbírálások CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup	Azt jelzi, hogy egy tabulátor vezérlőelem aktuális lapja egy több dokumentumfelület lapcsoport aktív lapja-e.
CMFCTabCtrl::IsActiveTabBoldFont	Azt jelzi, hogy az aktív lap szövege félkövér betűtípussal jelenik-e meg.
CMFCTabCtrl::IsActiveTabCloseButton	Azt jelzi, hogy a Bezárás gomb ( X) aktív lapon vagy a lapterület jobb felső sarkában jelenik-e meg.
CMFCTabCtrl::IsDrawFrame	Azt jelzi, hogy a lapozott ablak keretes téglalapot rajzol-e a beágyazott ablaktáblák köré.
CMFCTabCtrl::IsFlatFrame	Azt jelzi, hogy a tabulátorterület körüli keret lapos vagy 3D.
CMFCTabCtrl::IsFlatTab	Azt jelzi, hogy a lapok megjelenése az aktuális lap vezérlőelemben lapos-e vagy sem.
CMFCTabCtrl::IsLeftRightRounded	Azt jelzi, hogy a lap bal és jobb oldalának megjelenése le van-e kerekítve az aktuális tabulátor vezérlőelemben.
CMFCTabCtrl::IsMDITabGroup	Azt jelzi, hogy az aktuális lap vezérlőelem egy több dokumentumból álló felület ablakának ügyfélterületén található-e.
CMFCTabCtrl::IsOneNoteStyle	Azt jelzi, hogy az aktuális lap vezérlőelem a Microsoft OneNote stílusában jelenik-e meg.
CMFCTabCtrl::IsPtInTabArea	Meghatározza, hogy egy pont a tabulátor területén belül van-e. (Felülbírálások CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll	Azt jelzi, hogy az aktuális lap vezérlőelem rendelkezik-e görgetősávval, amely csoportként görgetheti a lapjait.
CMFCTabCtrl::IsTabDocumentsMenu	Azt jelzi, hogy a tabulátorvezérlő görgetőgombokat vagy többlapos ablakokat megjelenítő gombot jelenít-e meg.
CMFCTabCtrl::IsVS2005Style	Azt jelzi, hogy a lapok a Visual Studio .NET 2005 stílusában jelennek-e meg.
CMFCTabCtrl::ModifyTabStyle	A tabulátorok megjelenését adja meg az aktuális lap vezérlőelemben.
CMFCTabCtrl::MoveTab	Tabulátor áthelyezése másik tabulátor pozícióba. (Felülbírálások CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter	A keretrendszer hívja meg, amikor a kurzor először a tabulátorablakba húzódik.
CMFCTabCtrl::OnDragOver	A keretrendszer meghívta egy húzási művelet során, amikor az egér átkerül a célablakon. (Felülbírálások CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu	Megjeleníti a lapfüles ablakok előugró menüjét, megvárja, amíg a felhasználó kiválaszt egy lapot, és aktív laptá teszi a kijelölt lapot.
CMFCTabCtrl::PreTranslateMessage	Lefordítja az ablaküzeneteket, mielőtt elküldené őket a és DispatchMessage a TranslateMessage Windows-függvényeknek. (Felülbírálások CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout	Újraszámítja a tabulátorvezérlő belső elrendezését. (Felülbírálások CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup	Egy tabulátor vezérlőelem aktuális lapját állítja be aktív lapként több dokumentumfelület lapcsoportjában.
CMFCTabCtrl::SetActiveTab	Egy lap aktiválása. (Felülbírálások CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont	Engedélyezi vagy letiltja a félkövér betűtípus használatát az aktív lapokon.
CMFCTabCtrl::SetDrawFrame	Engedélyezi vagy letiltja egy keret téglalap rajzolását egy beágyazott sáv körül.
CMFCTabCtrl::SetFlatFrame	Megadja, hogy egy lapos vagy 3D-s keretet rajzoljon-e a lapterület köré.
CMFCTabCtrl::SetImageList	Képlistát ad meg. (Felülbírálások CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode	Megadja, hogyan méretezhető át az aktuális tabulátorvezérlő, majd visszajelzi a vezérlőt.
CMFCTabCtrl::SetTabMaxWidth	A lapfülek maximális szélességét adja meg egy többlapos ablakban.
CMFCTabCtrl::StopResize	Leállítja az aktuális átméretezési műveletet a tabulátorvezérlőn.
CMFCTabCtrl::SwapTabs	Felcserél egy pár lapot. (Felülbírálások CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar	Vízszintes görgetősáv rajzolása egy lap vezérlőelemen, amely lapos lapokat jelenít meg.

Adattagok

Név	Description
CMFCTabCtrl::m_bEnableActivate	Megakadályozza, hogy az aktív nézet elveszítse a fókuszt egy új lap beszúrása és engedélyezése esetén.

Megjegyzések

Az CMFCTabCtrl osztály a következőket támogatja:

• 3D, lapos és lapos, közös vízszintes görgetősávot tartalmazó tabulátorvezérlési stílusok.

• Az ablak tetején vagy alján található lapok.

• Szövegeket, képeket vagy szöveget és képeket megjelenítő lapok.

• Azok a lapok, amelyek a lap aktív állapotában módosítják a színt.

• Az állítható lapok szegélymérete megváltozik.

• Levehető többlapos ablakok.

Az CMFCTabCtrl osztály párbeszédpanelen is használható, de olyan alkalmazásokhoz készült, amelyek dokkoló vezérlősávokat használnak, például a Microsoft Excelt és a Visual Studiót. További információ: CDockablePane Osztály.

Az alábbi lépéseket követve hozzáadhat egy méretezhető, dokkoló lap vezérlőelemet az alkalmazásban:

1. Hozzon létre egy osztálypéldánytCTabbedPane.

2. Hívja fel: CDockablePane::Create.

3. Új lapok használata CBaseTabbedPane::AddTab vagy CMFCBaseTabCtrl::InsertTab hozzáadása.

4. Hívja meg CBasePane::EnableDocking , hogy az aktuális dokkolás lap vezérlőelem a fő keretablakban rögzíthető legyen.

5. Hívás CFrameWndEx::DockPane a lapozott ablak rögzítéséhez a főkereten.

A többlapos ablak dokkoló vezérlősávként való létrehozásáról az Osztály című témakörben talál CTabbedPanepéldát. Ha nem dokkoló vezérlőelemként szeretné használni CMFCTabCtrl , hozzon létre egy objektumot CMFCTabCtrl , majd hívja meg CMFCTabCtrl::Create.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Example

Az alábbi példa bemutatja, hogyan konfigurálhat különböző metódusokat az CMFCTabCtrl osztályban egy CMFCTabCtrl objektum konfigurálásához. A példa bemutatja, hogyan vehet fel lapokat, hogyan jelenítheti meg a Bezárás gombot az aktív lapon, engedélyezheti a szerkeszthető lapfeliratokat, és megjelenítheti a lapfüles ablakfeliratok előugró menüjét. Ez a példa az Állapotgyűjtemény minta része.

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

Requirements

Fejléc:afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Megjeleníti az aktuális lap vezérlőelem megadott lapját, és beállítja a fókuszt erre a lapra.

void ActivateMDITab(int nTab = -1);

Paraméterek

nTab
[in] A megjelenítendő lap nullaalapú indexe, vagy -1 az aktuálisan aktív lap megadásához.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

További részletekért tekintse meg a Visual Studio-telepítés mappájában mfc található forráskódot. Például: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Visszaadott érték

Mindig TRUE.

Megjegyzések

CMFCTabCtrl::AutoSizeWindow

Megadja, hogy a keretrendszer átméretezi-e az összes lapvezérlő ablak ügyfélterületét, amikor megváltozik a lapvezérlő felhasználói felületének eleme.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Paraméterek

bAutoSize
[in] TRUE a tabulátorablakok automatikus átméretezése; egyéb esetben. FALSE Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::Create

Létrehozza a tabulátorvezérlőt, és csatolja az CMFCTabCtrl objektumhoz.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Paraméterek

style
[in] A tabulátor vezérlőelem stílusa. További információ: Megjegyzések.

rect
[in] Egy téglalap, amely a tabulátor vezérlőelemet határolja.

pParentWnd
[in] Egy szülőablakra mutató mutató. Nem lehet NULL.

nID
[in] A tabulátor vezérlőelem azonosítója.

location
[in] A lapok helye. Az alapértelmezett érték a LOCATION_BOTTOM. További információ: Megjegyzések.

bCloseBtn
[in] TRUE bezárás gomb megjelenítése a lapon; egyéb esetben. FALSE Az alapértelmezett érték a FALSE.

Visszaadott érték

TRUEha sikeres; egyéb esetben. FALSE

Megjegyzések

Az alábbi táblázat a paraméterhez style megadható értékeket ismerteti.

Stílus	Description
STYLE_3D	Háromdimenziós megjelenésű tabulátorvezérlőt hoz létre.
STYLE_FLAT	Tabulátor vezérlőelemet hoz létre lapos lapokkal.
STYLE_FLAT_SHARED_HORZ_SCROLL	Egy lapvezérlőt hoz létre lapos lapokkal és görgetősávokkal, amelyek görgethetik a lapokat, ha egy szülőablak levágja őket.
STYLE_3D_ONENOTE	Tabulátor vezérlőelemet hoz létre a Microsoft OneNote stílusában.
STYLE_3D_VS2005	Tabulátor vezérlőelemet hoz létre a Microsoft Visual Studio 2005 stílusában.
STYLE_3D_ROUNDED	A Microsoft Visual Studio 2005 stílusában lekerekített lapokat tartalmazó tabulátort hoz létre.
STYLE_3D_ROUNDED_SCROLL	A Microsoft Visual Studio 2005 stílusában lekerekített lapokat és görgetőgombokat tartalmazó tabulátort hoz létre.

Az alábbi táblázat a paraméterhez location megadható értékeket sorolja fel.

Elhelyezkedés	Description
LOCATION_BOTTOM	A tabulátorok a tabulátor vezérlőelem alján találhatók.
LOCATION_TOP	A tabulátorok a tabulátor vezérlőelem tetején találhatók.

Example

Az alábbi példa bemutatja, hogyan használható a Create metódus az CMFCTabCtrl osztályban. Ez a példa az Állapotgyűjtemény minta része.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

A megadott lapterület méretének lefedése.

virtual void CalcRectEdit(CRect& rectEdit);

Paraméterek

rectEdit
[in] Egy téglalap, amely egy lap területét adja meg.

Megjegyzések

Ezt a metódust akkor hívjuk meg, ha módosítja egy lap címkéjét. Ez a módszer a megadott téglalap bal és jobb oldalát az aktuális lapmagasság felével, a felső és az alsó rész pedig egy egységre olvasztja.

CMFCTabCtrl::EnableActiveTabCloseButton

Megjeleníti vagy elrejti a Bezárás gombot ( X) az aktív lapon.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] TRUE a Bezárás gomb megjelenítéséhez az aktív lapon; FALSE a Bezárás gomb megjelenítéséhez a lapterület jobb felső sarkában. Az alapértelmezett érték a TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Engedélyezi vagy letiltja a szerkeszthető lapcímkéket.

virtual void EnableInPlaceEdit(BOOL bEnable);

Paraméterek

bEnable
[in] TRUE a szerkeszthető tabulátorcímkék engedélyezéséhez; FALSE a szerkeszthető tabulátorcímkék letiltásához.

Megjegyzések

CMFCTabCtrl::EnableTabDocumentsMenu

Váltás egy olyan felhasználói felület között, amely két gombot használ az ablakfülek görgetéséhez, valamint egy olyan felület között, amely lapozott ablakok előugró menüjét jeleníti meg.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] TRUE lapozott ablakfeliratok előugró menüjének megjelenítése; FALSE az előre és hátra görgető gombok megjelenítéséhez. Az alapértelmezett érték a TRUE.

Megjegyzések

Amikor a felhasználó egy fülcímkére kattint, a keretrendszer megjeleníti a megfelelő lapozott ablakot. Ha a tabulátorcímke látható, a lapozott ablak a pozíciójának módosítása nélkül nyílik meg. Ha a felhasználó kiválaszt egy dokumentumot az előugró menüből, és a megfelelő füles ablak ki van kapcsolva a képernyőn, a lapozott ablak lesz az első lap.

CMFCTabCtrl::EnsureVisible

Biztosítja, hogy egy lap látható legyen.

virtual BOOL EnsureVisible(int iTab);

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

Visszaadott érték

TRUE ha sikeres; FALSE ha a iTab paraméterindex érvénytelen.

Megjegyzések

Ezzel a módszerrel garantálhatja, hogy a megadott lap látható legyen. Ha szükséges, a tabulátor vezérlőelem görgetni fog.

CMFCTabCtrl::GetDocumentIcon

Lekéri a laphoz társított képet a lapfüles ablakok előugró menüjében.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Paraméterek

nCmdID
[in] A lap parancsazonosítója a lapfülek lapfülek előugró menüjében.

Visszaadott érték

Egy bitkép fogópontja.

CMFCTabCtrl::GetFirstVisibleTabNum

Az aktuális lap vezérlőelemben látható első lap indexét kéri le.

virtual int GetFirstVisibleTabNum() const;

Visszaadott érték

A tabulátor vezérlőelem egyik lapjának nullaalapú indexe.

Megjegyzések

Ezt a módszert csak akkor használja, ha a tabulátor vezérlőelem a Microsoft OneNote stílusában jelenik meg. CMFCTabCtrl::IsOneNoteStyle A stílus meghatározásához használja a metódust.

CMFCTabCtrl::GetResizeMode

Beolvas egy értéket, amely meghatározza az aktuális lap vezérlőelem átméretezését.

ResizeMode GetResizeMode() const;

Visszaadott érték

Az egyik CMFCTabCtrl::ResizeMode számbavételi érték, amely meghatározza, hogyan méretezhető át a tabulátorvezérlő. A lehetséges értékek listáját a metódus Megjegyzések szakaszában CMFCTabCtrl::SetResizeMode találja.

CMFCTabCtrl::GetScrollBar

A lap vezérlőelemhez társított görgetősáv-objektumra mutató mutatót kér le.

CScrollBar* GetScrollBar();

Visszaadott érték

Egy görgetősáv-objektumra mutató mutató, vagy NULL ha a tabulátor vezérlőelem nem a STYLE_FLAT_SHARED_HORZ_SCROLL stílus használatával lett létrehozva.

Megjegyzések

Ezzel a módszerrel érheti el a tabulátor beágyazott görgetősávját. A görgetősáv-objektum csak akkor jön létre, ha a tabulátor vezérlőelem stílussal rendelkezik STYLE_FLAT_SHARED_HORZ_SCROLL .

CMFCTabCtrl::GetTabArea

Lekéri a tabulátorcímke területének határoló téglalapját a tabulátor vezérlőelem tetején vagy alján.

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

Paraméterek

rectTabAreaTop
[kifelé] A metódus visszatérésekor ez a hivatkozás egy téglalapot tartalmaz, amely a felső lapfelirat területét határolja. A téglalap ügyfélkoordinátákban található. Ez a hivatkozás üres, ha nincs lapcímketerület a tabulátor vezérlőelem tetején.

rectTabAreaBottom
[kifelé] A metódus visszatérésekor ez a hivatkozás egy téglalapot tartalmaz, amely az alsó lapcímke területét határolja. A téglalap ügyfélkoordinátákban található. Ez a hivatkozás üres, ha a tabulátor vezérlőelem alján nincs tabulátorcímketerület.

Megjegyzések

Ezzel a módszerrel meghatározhatja a lapterület méretét és pozícióját a lapfüles ablakban.

CMFCTabCtrl::GetTabMaxWidth

Lekéri egy lap maximális szélességét.

int GetTabMaxWidth() const;

Visszaadott érték

A lap maximális szélessége képpontban. Ha a visszatérési érték 0, a lap szélessége korlátlan.

Megjegyzések

Használja a CMFCTabCtrl::SetTabMaxWidth metódust a maximális lapszélesség beállításához.

CMFCTabCtrl::GetTabsHeight

Lekéri az aktuális tabulátor vezérlőelem lapterületének magasságát.

virtual int GetTabsHeight() const;

Visszaadott érték

A lapterület magassága, ha bármelyik lap látható, vagy nulla, ha nincs látható lap.

CMFCTabCtrl::GetTabsRect

Beolvas egy téglalapot, amely az aktuális tabulátor vezérlőelem lapterületét határolja.

virtual void GetTabsRect(CRect& rect) const;

Paraméterek

rect
[kifelé] Amikor ez a metódus visszatér, a rect paraméter egy téglalapot tartalmaz, amely a tabulátorterületet határolja.

CMFCTabCtrl::GetWndArea

Lekéri az aktuális lap vezérlőelem ügyfélterületének határát.

void GetWndArea(CRect& rect) const;

Paraméterek

rect
[be, ki] A metódus visszatérésekor ez a paraméter egy téglalapot tartalmaz, amely az aktuális tabulátor vezérlőelemet köti össze.

Megjegyzések

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Elrejti a vízszintes görgetősávot (ha van ilyen) az aktív ablakban.

void HideActiveWindowHorzScrollBar();

Megjegyzések

Ezzel a módszerrel megakadályozhatja, hogy a tabulátorvezérlő villogjon, amikor a felhasználó átvált a tabulátorlapok között.

CMFCTabCtrl::HideInactiveWindow

Megadja, hogy a keretrendszer inaktív lapvezérlő ablakokat jelenít-e meg.

void HideInactiveWindow(BOOL bHide = TRUE);

Paraméterek

bHide
[in] TRUE nem jeleníthet meg inaktív ablakot; FALSE inaktív ablak megjelenítéséhez. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::HideNoTabs

Engedélyezi vagy letiltja a lapterület rajzát, ha nincsenek látható lapok.

void HideNoTabs(BOOL bHide=TRUE);

Paraméterek

bHide
[in] TRUE a tabulátorterület rajzolásához; FALSE a rajz letiltásához. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::HideSingleTab

Engedélyezi vagy letiltja a lap rajzolását, ha egyetlen többlapos ablak van.

virtual void HideSingleTab(BOOL bHide=TRUE);

Paraméterek

bHide
[in] TRUE nem lehet lapfület rajzolni egyetlen többlapos ablakhoz; FALSE egyetlen lap rajzolásához. Az alapértelmezett érték a következő TRUE: .

Megjegyzések

CMFCTabCtrl::IsActiveInMDITabGroup

Azt jelzi, hogy egy tabulátor vezérlőelem aktuális lapja egy több dokumentumfelület lapcsoport aktív lapja-e.

BOOL IsActiveInMDITabGroup() const;

Visszaadott érték

TRUEha egy lap vezérlőelem aktuális lapja egy MDI-lapcsoport aktív lapja; egyéb esetben. FALSE

Megjegyzések

Több dokumentumablakot függőleges vagy vízszintes lapcsoportokba rendezhet, és egyszerűen áthelyezheti a dokumentumokat az egyik lapcsoportból a másikba.

CMFCTabCtrl::IsActiveTabBoldFont

Azt jelzi, hogy az aktív lap szövege félkövér betűtípussal jelenik-e meg.

BOOL IsActiveTabBoldFont() const;

Visszaadott érték

TRUEha az aktív lap félkövér betűtípussal jelenik meg; egyéb esetben. FALSE

Megjegyzések

A metódussal CMFCTabCtrl::SetActiveTabBoldFont módosíthatja az aktív lap betűtípusát.

CMFCTabCtrl::IsActiveTabCloseButton

Azt jelzi, hogy a Bezárás gomb ( X) aktív lapon vagy a lapterület jobb felső sarkában jelenik-e meg.

virtual BOOL IsActiveTabCloseButton() const;

Visszaadott érték

TRUE ha az aktív lapon megjelenik a Bezárás gomb; FALSE ha a Bezárás gomb megjelenik a lapterület jobb felső sarkában.

Megjegyzések

CMFCTabCtrl::IsDrawFrame

Azt jelzi, hogy a lapozott ablak keretes téglalapot rajzol-e a beágyazott ablaktáblák köré.

BOOL IsDrawFrame() const;

Visszaadott érték

TRUEkeret téglalap rajzolása esetén; egyéb esetben. FALSE

Megjegyzések

Ezzel a CMFCTabCtrl::SetDrawFrame módszerrel engedélyezheti vagy letilthatja a keret téglalapjának rajzolását.

CMFCTabCtrl::IsFlatFrame

Azt jelzi, hogy a tabulátorterület körüli keret lapos vagy 3D.

BOOL IsFlatFrame() const;

Visszaadott érték

TRUE ha a tabulátorterület körüli keret lapos; FALSE ha a keret háromdimenziós.

Megjegyzések

CMFCTabCtrl::SetFlatFrame A módszerrel módosíthatja a keret rajzolási módját.

CMFCTabCtrl::IsFlatTab

Azt jelzi, hogy a lapok megjelenése az aktuális lap vezérlőelemben lapos-e vagy sem.

virtual BOOL IsFlatTab() const;

Visszaadott érték

TRUEha a lapok megjelenése az aktuális lap vezérlőelemben lapos; egyéb esetben. FALSE

CMFCTabCtrl::IsLeftRightRounded

Azt jelzi, hogy a lap bal és jobb oldalának megjelenése le van-e kerekítve az aktuális tabulátor vezérlőelemben.

virtual BOOL IsLeftRightRounded() const;

Visszaadott érték

TRUEha az egyes lapok oldalai le vannak kerekítve; egyéb esetben. FALSE

CMFCTabCtrl::IsMDITabGroup

Azt jelzi, hogy az aktuális lap vezérlőelem egy több dokumentumból álló felület ablakának ügyfélterületén található-e.

virtual BOOL IsMDITabGroup() const;

Visszaadott érték

TRUEha az aktuális lap vezérlőelem egy MDI-ügyfélterület ablakában van; egyéb esetben. FALSE

CMFCTabCtrl::IsOneNoteStyle

Azt jelzi, hogy az aktuális lap vezérlőelem a Microsoft OneNote stílusában jelenik-e meg.

virtual BOOL IsOneNoteStyle() const;

Visszaadott érték

TRUEha a tabulátor vezérlőelem a Microsoft OneNote stílusában jelenik meg; egyéb esetben. FALSE

CMFCTabCtrl::IsSharedScroll

Azt jelzi, hogy az aktuális lap vezérlőelem rendelkezik-e görgetősávval, amely csoportként görgetheti a lapjait.

BOOL IsSharedScroll() const;

Visszaadott érték

TRUEha a tabulátor vezérlőelem rendelkezik megosztott görgetősávval; egyéb esetben. FALSE

Megjegyzések

Ez a metódus akkor ad TRUE vissza, ha a styleCMFCTabCtrl::Create metódus paramétere .STYLE_FLAT_SHARED_HORZ_SCROLL

CMFCTabCtrl::IsTabDocumentsMenu

Azt jelzi, hogy a tabulátorvezérlő görgetőgombokat vagy többlapos ablakokat megjelenítő gombot jelenít-e meg.

BOOL IsTabDocumentsMenu() const;

Visszaadott érték

TRUE ha a lapozott ablakok lapozása lapozott ablakfeliratok előugró menüjével történik; FALSE ha a többlapos ablakok görgetése előre és hátra görgető gombokkal történik.

Megjegyzések

Ezzel a CMFCTabCtrl::EnableTabDocumentsMenu módszerrel adhatja meg a többlapos ablakok görgetésének módját.

CMFCTabCtrl::IsVS2005Style

Azt jelzi, hogy a lapok a Visual Studio 2005 stílusával vannak-e rajzolva.

virtual BOOL IsVS2005Style() const;

Visszaadott érték

TRUEha a tabulátorok a Visual Studio 2005 stílusával vannak rajzolva; egyéb esetben. FALSE

Megjegyzések

style A metódus paraméterével adja meg a CMFCTabCtrl::Create lapok rajzolásának módját.

CMFCTabCtrl::m_bEnableActivate

Megakadályozza, hogy az aktív nézet elveszítse a fókuszt egy új lap beszúrása és engedélyezése esetén.

static BOOL m_bEnableActivate;

Megjegyzések

A fókuszt általában egy új lapozott ablak veszi át, amikor a lap be van szúrva és aktívvá vált. Állítsa be a CMFCTabCtrl::m_bEnableActivate tagváltozót úgy, hogy FALSE megtartsa az eredeti fókuszt. Az alapértelmezett érték a TRUE.

CMFCTabCtrl::ModifyTabStyle

A tabulátorok megjelenését adja meg az aktuális lap vezérlőelemben.

BOOL ModifyTabStyle(Style style);

Paraméterek

style
[in] A tabulátor vezérlőelem megjelenését meghatározó számbavételi értékek egyike. További információkért tekintse meg a Megjegyzések táblát.

Visszaadott érték

Mindig TRUE.

Megjegyzések

A paraméter értéke az style alábbi CMFCTabCtrl::Style enumerálások egyike lehet.

Név	Description
STYLE_3D	Háromdimenziós, négyszögletes lapokat jelenít meg, amelyek kerek sarkokkal rendelkeznek.
STYLE_3D_ONENOTE	Olyan háromdimenziós lapokat jelenít meg, amelyek egy függőleges és egy ferde oldallal rendelkeznek, és amelyek lekerekített sarkokkal rendelkeznek.
STYLE_3D_ROUNDED	Háromdimenziós lapokat jelenít meg, amelyek ferde oldalokkal és lekerekített sarkokkal rendelkeznek.
STYLE_3D_ROUNDED_SCROLL	Háromdimenziós lapokat jelenít meg, amelyek ferde oldalokkal és lekerekített sarkokkal rendelkeznek. Ha több lap van, mint amennyi egyszerre megjeleníthető, a keretrendszer egy legördülő nyilat és egy lapmenüt jelenít meg az aktívvá tétele érdekében.
STYLE_3D_SCROLLED	Háromdimenziós, téglalap alakú lapokat jelenít meg. Ha több lap van, mint amennyi egyszerre megjeleníthető, a keretrendszer egy legördülő nyilat és egy lapmenüt jelenít meg az aktívvá tétele érdekében.
STYLE_3D_VS2005	Háromdimenziós, lekerekített lapokat jelenít meg, amelyek egy ferde oldallal és egy függőleges oldallal rendelkeznek.
STYLE_FLAT	Kétdimenziós lapokat jelenít meg, amelyek bal és jobb oldalt ferdeek.
STYLE_FLAT_SHARED_HORZ_SCROLL	Kétdimenziós lapokat jelenít meg. Ha több lap van, mint amennyi egyszerre megjeleníthető, a keretrendszer görgető nyilakat jelenít meg a lapterület végén.

CMFCTabCtrl::OnDragEnter

A keretrendszer egy húzási művelet során hívja meg, amikor a kurzor először belép az aktuális tabulátor vezérlőelem ablakába.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Paraméterek

pDataObject
[in] A felhasználó által áthúzott adatokat tartalmazó adatobjektumra mutat.

dwKeyState
[in] A módosító kulcsok állapotát tartalmazza. Ez a paraméter a következő értékek bitenkénti "vagy" (|) kombinációja: MK_CONTROL, , MK_SHIFT, MK_ALTMK_LBUTTON, MK_MBUTTONés MK_RBUTTON. További információkért tekintse meg az Egérbemenetüzenetparaméterek szakaszát.

point
[in] A kurzor aktuális helyét tartalmazza az ügyfélkoordinátákban.

Visszaadott érték

Mindig DROPEFFECT_NONE, ami azt jelenti, hogy a dobási cél nem tudja elfogadni az adatokat.

Megjegyzések

Ezzel a módszerrel támogathatja a húzási műveletet. Bírálja felül ezt a módszert a saját egyéni viselkedésének implementálásához.

Alapértelmezés szerint ez a metódus csak a hívásokat hívja CMFCTabCtrl::OnDragOvermeg , amely mindig visszaadja a függvényt DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

A keretrendszer meghívta egy húzási művelet során, amikor az egér átkerül a célablakon.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Paraméterek

pDataObject
[in] Mutasson egy COleDataObject olyan objektumra, amelyet a cél cél fölé húz.

dwKeyState
[in] A módosító kulcsok állapota, amely a , MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONés MK_RBUTTONbitenkénti "vagy" (|) MK_CONTROLkombinációja. További információ: "Üzenetparaméterek" a About Mouse Input (Üzenetparaméterek) című témakörben.

point
[in] Az egér aktuális pozíciója.

Visszaadott érték

Mindig DROPEFFECT_NONE.

Megjegyzések

Bírálja felül ezt a módszert az egyéni implementációval. További információkért tekintse meg a metódust CView::OnDragOver .

CMFCTabCtrl::OnShowTabDocumentsMenu

Megjeleníti a többlapos ablakok előugró menüjét, megvárja, amíg a felhasználó kiválaszt egy lapot, és aktív laptá teszi a kijelölt lapot.

virtual void OnShowTabDocumentsMenu(CPoint point);

Paraméterek

point
[in] Az előugró menü megjelenítésének koordinátái.

Megjegyzések

CMFCTabCtrl::SetActiveInMDITabGroup

Egy tabulátor vezérlőelem aktuális lapját állítja be aktív lapként több dokumentumfelület lapcsoportjában.

void SetActiveInMDITabGroup(BOOL bActive);

Paraméterek

bActive
[in] TRUE az aktuális lap aktív lapká alakításához; FALSE az aktuális lap inaktívvá tételéhez.

Megjegyzések

Több dokumentumablakot függőleges vagy vízszintes lapcsoportokba rendezhet, és egyszerűen áthelyezheti a dokumentumokat az egyik lapcsoportból a másikba.

CMFCTabCtrl::SetActiveTab

Aktivál egy lapot.

virtual BOOL SetActiveTab(int iTab);

Paraméterek

iTab
[in] Az aktiválandó lap nulla alapú indexét adja meg.

Visszaadott érték

TRUE ha a megadott lap aktív; FALSE ha a megadott iTab paraméterérték érvénytelen.

Megjegyzések

Ez elküldi az AFX_WM_CHANGE_ACTIVE_TAB értesítést a szülőablaknak és a tabulátor vezérlőelem szülőkeretének.

A SetActiveTab metódus automatikusan meghívja a CMFCTabCtrl::HideActiveWindowHorzScrollBar metódust, hogy megakadályozza a képernyő villogását.

CMFCTabCtrl::SetActiveTabBoldFont

Engedélyezi vagy letiltja a félkövér betűtípus használatát az aktív lapokon.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Paraméterek

bIsBold
[in] TRUE félkövér betűtípus használata az aktív lap feliratának megjelenítéséhez; FALSE a címke megjelenítéséhez használja a szabványos betűtípust. Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::SetDrawFrame

Megadja, hogy egy keret téglalapja egy beágyazott sáv köré legyen-e rajzolva.

void SetDrawFrame(BOOL bDraw=TRUE);

Paraméterek

bDraw
[in] TRUE keret téglalap megjelenítése beágyazott sáv körül; egyéb esetben. FALSE Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::SetFlatFrame

Megadja, hogy egy lapos vagy 3D-s keretet rajzoljon-e a lapterület köré.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Paraméterek

bFlat
[in] TRUE lapos (2D) keret rajzolása a lapterület körül; FALSE háromdimenziós (3D) keret rajzolásához. Az alapértelmezett érték a TRUE.

bRepaint
[in] TRUE az ablak azonnali újrarajzlásához; egyéb esetben. FALSE Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCTabCtrl::SetImageList

Képlistát ad meg.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Paraméterek

uiID
[in] A képlistát tartalmazó bitkép-erőforrás azonosítója.

cx
[in] Az egyes képek szélessége képpontban. Az alapértelmezett érték 15.

clrTransp
[in] Az áttetsző kép színe. Az ilyen színű képrészek átlátszóak lesznek. Az alapértelmezett érték a színmágnes, RGB(255,0,255).

hImageList
[in] Egy előre betöltött képlista leírója.

Visszaadott érték

TRUE ha ez a módszer sikeres. FALSE ha a tabulátor vezérlőelem egy lapos stílussal jön létre, vagy ha az első metódus túlterhelése nem tudja betölteni a paraméter által uiID megadott bitképet.

Megjegyzések

Ezzel a módszerrel állíthat be egy képlistát a tabulátor vezérlőelemhez. A képlista képei a tabulátorcímke mellett jelennek meg. Ez a módszer újraszámítja a lap magasságát, hogy a lap úgy legyen méretezve, hogy tartalmazza a képet és a szöveget is.

CMFCBaseTabCtrl::AddTab A tabulátor vezérlőelem által öröklő metódus használatával adja meg a megjelenítendő kép indexét.

CMFCTabCtrl::SetResizeMode

Megadja, hogyan méretezhető át az aktuális tabulátorvezérlő, majd visszajelzi a vezérlőt.

void SetResizeMode(ResizeMode resizeMode);

Paraméterek

resizeMode
[in] Az egyik CMFCTabCtrl::ResizeMode számbavételi érték, amely meghatározza, hogyan méretezhető át a tabulátorvezérlő. A lehetséges értékek listáját a Megjegyzések táblában találja.

Megjegyzések

Az resizeMode paraméter az alábbi ResizeMode enumerálási értékek egyike lehet.

Név	Description
RESIZE_NO	A tabulátorvezérlő nem méretezhető át.
RESIZE_VERT	A tabulátor vezérlőelem átméretezhető függőlegesen, de vízszintesen nem.
RESIZE_HORIZ	A tabulátor vezérlőelem vízszintesen átméretezhető, függőlegesen azonban nem.

CMFCTabCtrl::SetTabMaxWidth

A lapfülek maximális szélességét adja meg egy többlapos ablakban.

void SetTabMaxWidth(int nTabMaxWidth);

Paraméterek

nTabMaxWidth
[in] A maximális lapszélesség képpontban.

Megjegyzések

Ezzel a módszerrel korlátozhatja a lapfülek szélességét egy többlapos ablakban. Ez a módszer akkor hasznos, ha a lapok nagyon hosszú címkéket használnak. Az CMFCTabCtrl osztálykonstruktor a lap maximális szélességét 0-ra inicializálja, ami valójában azt jelenti, hogy a szélesség nincs korlátozva.

CMFCTabCtrl::StopResize

Leállítja az aktuális átméretezési műveletet a tabulátorvezérlőn.

void StopResize(BOOL bCancel);

Paraméterek

bCancel
[in] TRUE az aktuális átméretezési művelet megszakításához; FALSE az aktuális átméretezési művelet végrehajtásához. Mindkét esetben a keretrendszer nem rajzolja meg az átméretező téglalapot.

CMFCTabCtrl::SynchronizeScrollBar

Vízszintes görgetősáv rajzolása egy lap vezérlőelemen, amely lapos lapokat jelenít meg.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Paraméterek

pScrollInfo
[kifelé] Mutató egy SCROLLINFO struktúra vagy NULL. Ha ez a metódus visszatér, és ez a paraméter nem NULL, a struktúra tartalmazza a görgetősáv összes paraméterét. Az alapértelmezett érték a NULL.

Visszaadott érték

TRUEha ez a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ez a módszer csak a lapfüleket megjelenítő vezérlőelemet érinti. A görgetősáv egyszerre befolyásolja az összes lapot.

Lásd még

hierarchiadiagram
osztályok
CDockablePane osztály
CMFCBaseTabCtrl osztály