CMFCBaseTabCtrl osztály

Implementálja a többlapos ablakok alapfunkcióját. További részletekért lásd a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CMFCBaseTabCtrl : public CWnd

Tagok

Nyilvános metódusok

Név	Leírás
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Új fület ad hozzá a lapfüles ablakhoz.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::D etachTab	Levesz egy lapot egy füles ablakból.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Engedélyezi vagy letiltja az automatikus lapszínezést.
CMFCBaseTabCtrl::EnableCustomToolTips	Engedélyezi vagy letiltja az egyéni elemleírásokat a lapokhoz.
CMFCBaseTabCtrl::EnableInPlaceEdit	Engedélyezi vagy letiltja a tabulátorcímkék közvetlen szerkesztését.
CMFCBaseTabCtrl::EnableTabDetach	Levehető lapok engedélyezése.
CMFCBaseTabCtrl::EnableTabSwap	Engedélyezi vagy letiltja, hogy a felhasználó egérrel módosíthatja-e a lapsorrendet.
CMFCBaseTabCtrl::EnsureVisible	Görgeti a lapokat, amíg a megadott lap meg nem jelenik. Ennek a metódusnak nincs hatása, ha a megadott lap már látható.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Egy adott pontot tartalmazó panelt ad vissza.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Az aktív lap indexét adja vissza.
CMFCBaseTabCtrl::GetActiveTabColor	Az aktív lap háttérszínét adja vissza.
CMFCBaseTabCtrl::GetActiveTabTextColor	Az aktív lap szövegszínét adja vissza.
CMFCBaseTabCtrl::GetActiveWnd	A tabulátor vezérlőelem aktív lapját mutató mutatót ad vissza.
CMFCBaseTabCtrl::GetAutoColors	Az automatikus színezéshez használt színtömbre mutató hivatkozást ad vissza.
CMFCBaseTabCtrl::GetFirstVisibleTab	Az első látható lapra mutató mutatót ad vissza.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Az aktuálisan kiemelt lap indexét adja vissza.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	A LOCATION adattípus változóját adja vissza, amely azt jelzi, hogy a tabulátorterület a tabulátor vezérlőelemhez képest hol van elhelyezve. Például felül vagy alul.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	A lapfülterület méretét és pozícióját adja vissza a lapfüles ablakban. A tabulátorterület pozíciója koordináták használatával van meghatározva.
CMFCBaseTabCtrl::GetTabBkColor	A megadott lap háttérszínét adja vissza.
CMFCBaseTabCtrl::GetTabBorderSize	A tabulátor vezérlőelem tabulátorszegélyeinek méretét adja vissza.
CMFCBaseTabCtrl::GetTabByID	Egy megadott azonosító által azonosított lap indexét adja vissza.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Egy megadott HWND-objektumot tartalmazó lap indexét adja vissza.
CMFCBaseTabCtrl::GetTabFromPoint	A megadott pontot tartalmazó lapot adja vissza.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	A megadott laphoz társított ikont adja vissza.
CMFCBaseTabCtrl::GetTabID	Egy lap azonosítóját adja vissza a lap indexével.
CMFCBaseTabCtrl::GetTabIcon	Egy adott lap ikonazonosítóját adja vissza.
CMFCBaseTabCtrl::GetTabLabel	Egy megadott lap szövegét adja vissza.
CMFCBaseTabCtrl::GetTabRect	Lekéri egy adott lap méretét és pozícióját.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Egy megadott lap szövegszínét adja vissza.
CMFCBaseTabCtrl::GetTabWnd	Az egérmutatót egy adott lapon található panelre adja vissza.
CMFCBaseTabCtrl::GetTabWndNoWrapper	A közvetlen mutatót egy adott laplapon található vezérlőelemre adja vissza, még akkor is, ha a vezérlő burkolóval rendelkezik.
CMFCBaseTabCtrl::GetTabsNum	A tabulátor vezérlőelemben található lapok számát adja vissza.
CMFCBaseTabCtrl::GetToolTipCtrl	Az objektumhoz `CMFCBaseTabCtrl` társított elemleírás-vezérlőre mutató hivatkozást ad vissza.
CMFCBaseTabCtrl::GetVisibleTabsNum	A látható lapok számát adja vissza.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Beállít egy olyan beállítást, amely elrejt egy ablakfület, de csak akkor, ha a lapfül csak egy látható lapot jelenít meg.
CMFCBaseTabCtrl::InsertTab	Új lap beszúrása.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Olyan értéket ad vissza, amely jelzi, hogy egy lapozott ablak automatikus szín módban van-e.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Olyan értéket ad vissza, amely jelzi, hogy a lapterület kerete sík vagy 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Olyan értéket ad vissza, amely jelzi, hogy a tabulátor vezérlőelem úgy van-e konfigurálva, hogy elrejtsen egy lapot, de csak akkor, ha egy lapfül csak egy látható lapfület tartalmaz.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Azt jelzi, hogy a felhasználók módosíthatják-e a címkét egy lapon.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Azt jelzi, hogy egy lapozott ablak microsoft OneNote-stílusban jeleníti-e meg a lapokat.
CMFCBaseTabCtrl::IsPtInTabArea	Ellenőrzi, hogy létezik-e megadott pont a tabulátorterületen.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Azt jelzi, hogy egy lap leválasztható-e.
CMFCBaseTabCtrl::IsTabIconOnly	Azt jelzi, hogy a lapok ikonokat jelenítenek-e meg, de címkéket nem.
CMFCBaseTabCtrl::IsTabSwapEnabled	Azt jelzi, hogy a felhasználó módosíthatja-e a tabulátorpozíciókat a lapok húzásával.
CMFCBaseTabCtrl::IsTabVisible	Azt jelzi, hogy egy megadott lap látható-e.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	A keretrendszer meghívja, amikor a lapok száma megváltozik.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::P reTranslateMessage	A CWinApp az TranslateMessage és DispatchMessage Windows-függvényekhez való küldés előtt fordítja le az ablaküzeneteket. (Felülbírálások CWnd::P reTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Újraszámítja egy lapozott ablak belső elrendezését.
CMFCBaseTabCtrl::RemoveAllTabs	Eltávolítja az összes lapot a lapfüles ablakból.
CMFCBaseTabCtrl::RemoveTab	Lap eltávolítása egy lapfülről egy lapfüles ablakból.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Alaphelyzetbe állítja a lapozott ablakhoz csatolt képlistát.
CMFCBaseTabCtrl::Szerializálás	Beolvassa vagy beírja ezt az objektumot egy archívumból vagy egy archívumba. (Felülbírálja a CObject::Serialize parancsot.)
CMFCBaseTabCtrl::SetActiveTab	Aktivál egy lapot.
CMFCBaseTabCtrl::SetActiveTabColor	Beállítja az aktuálisan aktív lap háttérszínét.
CMFCBaseTabCtrl::SetActiveTabTextColor	Az aktív lapok szövegszínét állítja be.
CMFCBaseTabCtrl::SetAutoColors	Beállítja az automatikus szín módban alkalmazott tabulátorszíneket.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Beállítja a CDockablePane osztályból nem származtatott objektumokhoz használt burkolóosztályt.
CMFCBaseTabCtrl::SetDrawNoPrefix	Engedélyezi és letiltja az előtagkarakterek feldolgozását tabulátorfeliratok rajzolásakor.
CMFCBaseTabCtrl::SetImageList	Beállítja az ikon képlistáját.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Beállítja egy adott lap háttérszínét.
CMFCBaseTabCtrl::SetTabBorderSize	Új lapszegélyméret beállítása.
CMFCBaseTabCtrl::SetTabHicon	Tabulátor ikon beállítása.
CMFCBaseTabCtrl::SetTabIcon	Tabulátor ikonazonosítójának beállítása.
CMFCBaseTabCtrl::SetTabIconOnly	Engedélyezi és letiltja a "csak ikon" módot egy adott laphoz.
CMFCBaseTabCtrl::SetTabLabel	Egy megadott sztringértékkel egyenlő tabulátorcímkét állít be.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	A megadott lap szövegszínét állítja be.
CMFCBaseTabCtrl::SetTabsOrder	A lapok elrendezése a megadott sorrendben.
CMFCBaseTabCtrl::ShowTab	Megjeleníti vagy elrejti a megadott lapot.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Védett metódusok

Név	Leírás
CMFCBaseTabCtrl::CreateWrapper	Létrehoz egy burkolót egy olyan CWnd-ból származtatott objektumhoz, amely nem a következőből `CDockablePane`származik: . Az `CMFCBaseTabCtrl` objektumok rögzítéséhez minden beágyazott vezérlőnek rendelkeznie kell egy dokkoló burkolóval, vagy abból kell származnia `CDockablePane`. A burkoló osztályát a következővel `SetDockingBayWrapperRTC`állíthatja be: .

Adattagok

Név	Leírás
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Azt határozza meg, hogy a lapok bal egérkattintással vagy jobb egérkattintással vannak-e kijelölve.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Megadja, hogy a lapokban található panelek automatikusan megsemmisülnek-e.

Megjegyzések

Az CMFCBaseTabCtrl osztály egy absztrakt osztály. Ezért nem lehet példányosítva. Többlapos ablak létrehozásához egy osztályt kell származtatnia a forrásból CMFCBaseTabCtrl. Az MFC-kódtár néhány származtatott osztálypéldát tartalmaz, amelyek közül kettő a CMFCTabCtrl osztály és a CMFCOutlookBarTabCtrl osztály.

A Visual Studio 2015-től kezdve ez az osztály támogatja a Microsoft Active Accessibilityet.

Testreszabási tippek

Az alábbi tippek a CMFCBaseTabCtrl Class tőle öröklő osztályokra vonatkoznak:

Ha engedélyezi a levehető lapokat, ne tartsa a mutatókat a lapfüles ablakokhoz. Ezek a levehető lapok dinamikusan hozhatók létre és semmisíthetők meg. Ezért a mutatók érvénytelenné válhatnak.
A tabulátor vezérlőelemet úgy konfigurálhatja, hogy a felhasználók dinamikusan mozgathassák a lapfüleket egy tabulátor vezérlőelemen az egérrel. Ez a funkció be van építve az CMFCBaseTabCtrl osztályba. Az engedélyezéshez hívja meg a CMFCBaseTabCtrl::EnableTabSwap parancsot.
Alapértelmezés szerint a lapok le lesznek választva, amikor hozzáadja őket egy tabulátor vezérlőelemhez. Nem leválasztható lapokat a CMFCBaseTabCtrl::AddTab használatával is hozzáadhat. Ha a paramétert bDetachable úgy állítja be, hogy FALSEa lap nem lesz leválasztható. A CMFCBaseTabCtrl::EnableTabDetach metódus meghívásával azt is módosíthatja, hogy a lapok leválaszthatók-e.
A CWnd osztályból származó objektumok rögzíthető vezérlősávra vagy dokkolható lapra helyezhetők. Ahhoz, hogy az egész vezérlő rögzíthető legyen, az CWnd objektumot dokkolhatóvá kell tennie. Ehhez az MFC burkolóosztályt használ. Ez a burkolóosztály a CDockablePaneAdapter osztály. A CWnd dokkolható vezérlősávhoz vagy dokkolható laphoz hozzáadott objektumok egy CDockablePaneAdapter objektumba lesznek burkolva. Az automatikus körbefuttatás letiltásához állítsa az objektum paraméterét m_bEnableWrappingCMFCBaseTablCtrl a következőre FALSE: . Az alkalmazás által burkolóként használt osztályt a CMFCBaseTabCtrl::SetDockingBarWrapperRTC metódussal is módosíthatja.

Öröklési hierarchia

Követelmények

Fejléc: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Hozzáad egy ikont a védett CMap m_mapAddedIcons tag ikonlistájához.

void AddIcon(
    HICON hIcon,
    int iIcon);

Paraméterek

hIcon
[in] A hozzáadni kívánt ikon fogópontja.

iIcon
[in] A védett CImageList m_Images tag ikonjának nullaalapú indexe.

Megjegyzések

CMFCBaseTabCtrl::AddTab

Új lapot ad hozzá a tabulátor vezérlőelemhez.

virtual void AddTab(
    CWnd* pTabWnd,
    LPCTSTR lpszTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void AddTab(
    CWnd* pTabWnd,
    UINT uiResTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Paraméterek

pTabWnd
[in] Egy mutató arra az ablakra, amelyet ez a metódus új lapként jelöl.

lpszTabLabel
[in] Az új lap címkéjét tartalmazó sztring.

uiImageId
[in] Képazonosító a képlistából. A tabulátor vezérlőelem ezt a képet használja az új lap ikonjaként.

uiResTabLabel
[in] A címke erőforrás-azonosítója.

bDetachable
[in] Logikai paraméter, amely meghatározza, hogy az új lap leválasztható-e.

Megjegyzések

Ha a pTabWnd olyan objektumra mutat, amely nem a CDockablePane osztályból származik, és ha a bDetachable ÉRTÉKE IGAZ, a keretrendszer automatikusan létrehoz egy burkolót a pTabWnd objektumhoz. A burkoló leválaszthatóvá teszi a pTabWnd objektumot. Alapértelmezés szerint a burkoló a CDockablePaneAdapter osztály egy példánya. Ha az alapértelmezett burkoló által kínált funkciók nem elfogadhatók, használja a CMFCBaseTabCtrl::SetDockingBarWrapperRTC metódust egy másik burkoló megadásához.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Paraméterek

[in] bUseTabIndexes

Megjegyzések

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Paraméterek

[in] bAutoDestroy

Megjegyzések

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Paraméterek

[in] rectEdit

Megjegyzések

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Megjegyzések

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Megjegyzések

CMFCBaseTabCtrl::CreateWrapper

Burkolót hoz létre egy olyan keretablakhoz, amely a CWnd osztályból származik, de nem a CDockablePane osztályból származik.

virtual CWnd* CreateWrapper(
    CWnd* pWndToWrap,
    LPCTSTR lpszTabLabel,
    BOOL bDetachable);

Paraméterek

pWndToWrap
[in] A becsomagolt keretablakra mutató mutató.

lpszTabLabel
[in] Az ablak címkéjét tartalmazó sztring.

bDetachable
[in] Logikai paraméter, amely azt jelzi, hogy az ablak leválasztható-e.

Visszaadott érték

Az osztályból CDockablePane származó burkolóra mutató mutató, ha CreateWrapper sikeresen létrehoz egy burkolóosztályt a pWndToWrap számára. Ha a metódus sikertelen, a pWndToWrap értéket adja vissza.

Megjegyzések

A többlapos ablak minden, a forrásból CWndszármazó objektumot rögzíthet. Ahhoz azonban, hogy egy CMFCBaseTabCtrl Class objektum rögzíthető legyen, a CMFCBaseTabCtrl rajta lévő összes objektumnak leválaszthatónak kell lennie. Ezért automatikusan körbefuttat minden olyan objektumot, CMFCBaseTabCtrl amelyből nem származik CDockablePane.

Alapértelmezés szerint a CMFCBaseTabCtrlCDockablePaneAdapter osztály példányai jönnek létre. A burkoló alapértelmezett osztályának módosításához hívja meg a CMFCBaseTabCtrl::SetDockingBarWrapperRTC parancsot.

Ha a pWndToWrap származik CDockablePane, ez a metódus nem hoz létre burkolót. Ehelyett sikertelen lesz, és a pWndToWrap értéket adja vissza.

CMFCBaseTabCtrl::D etachTab

A keretrendszer meghívja ezt a metódust, hogy leválasztson egy lapot a tabulátorvezérlőről.

virtual BOOL DetachTab(
    AFX_DOCK_METHOD dockMethod,
    int nTabNum = -1,
    BOOL bHide = FALSE);

Paraméterek

dockMethod
[in] A CBasePane osztály által megadott számba vehető adattípus. Ez az adattípus a lap leválasztásához használt metódust adja meg.

nTabNum
[in] A leválasztani kívánt lap nulla alapú indexe.

bHide
[in] Logikai paraméter, amely azt jelzi, hogy a keretrendszernek el kell-e rejtenie a leválasztott lapot.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ha az nTabNum által megadott lap nem leválasztható, ez a függvény meghiúsul, és HAMIS értéket ad vissza.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Paraméterek

[in] bLastActive

Megjegyzések

CMFCBaseTabCtrl::EnableAutoColor

Azt határozza meg, hogy a keretrendszer az automatikus háttérszíneket használja-e lap rajzolásakor.

void EnableAutoColor(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Logikai paraméter, amely meghatározza, hogy a keretrendszer automatikus színeket használ-e.

Megjegyzések

A tabulátor vezérlőelemek számos előre definiált színből álló tömböt alkotnak. Ha a keretrendszer automatikus színeket használ, a rendszer a következő színt rendeli hozzá a tömbhöz egy lapsorozat minden lapján.

Alapértelmezés szerint az automatikus színeket a tár által definiált színek határozzák meg. A CMFCBaseTabCtrl::SetAutoColors meghívásával egyéni színtömböt adhat meg.

CMFCBaseTabCtrl::EnableCustomToolTips

Egyéni elemleírások engedélyezése a tabulátor vezérlőelemhez.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Logikai érték, amely meghatározza, hogy egyéni elemleírásokat használjon-e.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

Ha az egyéni elemleírások engedélyezve vannak, a tabulátorvezérlő elküldi a AFX_WM_ON_GET_TAB_TOOLTIP üzenetet a főkeretbe. Ha támogatni szeretné az egyéni elemleírásokat az alkalmazásban, a fő keretablaknak kezelnie kell ezt a módszert, és meg kell adnia az egyéni elemleírás szövegét. Az egyéni elemleírások megadásáról további információt a CMFCTabToolTipInfo Struktúra című témakörben talál.

CMFCBaseTabCtrl::EnableInPlaceEdit

Lehetővé teszi a lapfeliratok felhasználó általi közvetlen szerkesztését.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Paraméterek

bEnable
[in] Logikai paraméter, amely meghatározza, hogy engedélyezi-e a tabulátorcímkék közvetlen szerkesztését.

Megjegyzések

Alapértelmezés szerint a lapcímkék közvetlen szerkesztése le van tiltva a tabulátorvezérlők esetében.

A tabulátor vezérlőelem lapjainak egy részhalmazához engedélyezheti a közvetlen szerkesztést. Ehhez felülbírálja a metódust CMFCBaseTabCtrl::StartRenameTab. StartRenameTab a tabulátorcímkék közvetlen szerkesztését támogató összes lap esetében nem nulla értéket kell visszaadnia.

Ebben a metódusban ez a CMFCBaseTabCtrl Classmódszer egy tiszta virtuális függvény, és nincs implementációja. Ha osztályt CMFCBaseTabCtrlszármaztat, implementálnia kell ezt a függvényt.

CMFCBaseTabCtrl::EnableTabDetach

Levehető lapok engedélyezése.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

bEnable
[in] Logikai érték, amely azt jelzi, hogy le szeretné-e választani a lapot.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

CMFCBaseTabCtrl::EnableTabSwap

Lehetővé teszi, hogy a felhasználó egérrel módosítsa a tabulátorsorrendet.

void EnableTabSwap(BOOL bEnable);

Paraméterek

bEnable
[in] Logikai érték, amely azt jelzi, hogy engedélyezi-e a lapcserélést.

Megjegyzések

Ha engedélyezve van a lapcserélés, a felhasználó húzással módosíthatja a lap relatív pozícióját a tabulátor vezérlőelemben.

CMFCBaseTabCtrl::EnsureVisible

Görgeti a lapokat, amíg a megadott lap meg nem jelenik.

virtual BOOL EnsureVisible(int iTab);

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ennek a módszernek nincs hatása, ha az iTab által jelzett lap már látható.

Alapértelmezés szerint ezt a metódust a rendszer nem támogatja CMFCBaseTabCtrl Class. Ezt a függvényt egy olyan egyéni osztályban kell implementálnia, amely abból CMFCBaseTabCtrl származik, hogy az egyéni tabulátor vezérlőelem támogatja a tabulátor görgetést. Ezt a metódust a CMFCTabCtrl osztály támogatja.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Megjegyzések

CMFCBaseTabCtrl::FindTargetWnd

A megadott pontot tartalmazó panelt azonosítja.

virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;

Paraméterek

Pt
[in] A CMFCBaseTabCtrl objektum ügyfél-terület koordinátáinak használatával definiált pont.

Visszaadott érték

A CWnd objektumra mutató mutató, ha sikeres; ellenkező esetben NULL.

Megjegyzések

Az osztályban ez a CMFCBaseTabCtrl metódus egy tiszta virtuális függvény: akkor kell implementálnia, ha osztályt származtat.CMFCBaseTabCtrl

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Paraméterek

[in] nNewTab

Megjegyzések

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Paraméterek

[in] nNewTab

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetActiveTab

Lekéri az aktuálisan aktív lap indexét.

virtual int GetActiveTab() const;

Visszaadott érték

Az aktív lap nulla alapú indexe; -1, ha nincs aktív lap.

CMFCBaseTabCtrl::GetActiveTabColor

Lekéri az aktuálisan aktív lap háttérszínét.

virtual COLORREF GetActiveTabColor() const;

Visszaadott érték

Az aktív lap háttérszínét meghatározó COLORREF érték.

Megjegyzések

Alapértelmezés szerint az aktív lap háttérszíne COLOR_WINDOW. Az aktív lap háttérszínét a CMFCBaseTabCtrl::SetActiveTabColor metódussal módosíthatja.

CMFCBaseTabCtrl::GetActiveTabTextColor

Lekéri az aktív lap szövegszínét.

virtual COLORREF GetActiveTabTextColor() const;

Visszaadott érték

Az aktív lap szövegszínét meghatározó COLORREF érték.

Megjegyzések

Alapértelmezés szerint az aktív lapok szövegszíne COLOR_WINDOWTEXT. A szöveg színét a CMFCBaseTabCtrl::SetActiveTabTextColor metódussal módosíthatja.

CMFCBaseTabCtrl::GetActiveWnd

Az aktuálisan aktív lapablakra mutató mutatót kér le.

virtual CWnd* GetActiveWnd() const;

Visszaadott érték

Egy ablakra mutató mutató.

CMFCBaseTabCtrl::GetAutoColors

Lekéri az automatikus színezéshez használt színtömböt.

const CArray<COLORREF,COLORREF>& GetAutoColors() const;

Visszaadott érték

A CMFCBaseTabCtrl objektum által az automatikus lapszínezéshez használt COLORREF értékek tömbjének hivatkozása.

Megjegyzések

A keretrendszer alapértelmezés szerint a kódtár által definiált színekre inicializálja a színtömböt. A CMFCBaseTabCtrl::SetAutoColors metódus meghívásával egyéni színtömböt adhat meg.

CMFCBaseTabCtrl::GetFirstVisibleTab

Az első látható lapra mutató mutatót kér le.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

virtual CWnd* GetFirstVisibleTab(
    int iStartFrom,
    int& iTabNum);

Paraméterek

iTabNum
[kifelé] Egész számra mutató hivatkozás. Ez a metódus az első látható lap nulla alapú indexét írja ebbe a paraméterbe.

iStartFrom
[in] Az első ellenőrizendő lap nulla alapú indexe.

Visszaadott érték

Az első látható lapra mutató mutató, ha sikeres; ellenkező esetben NULL.

Megjegyzések

Ha ez a módszer nem sikerül, az -1 értéket írja az iStartFromba.

Ha az iStartFrom nagyobb vagy egyenlő a tabulátor vezérlőelem lapjainak számával, GetFirstVisibleTab automatikusan meghiúsul.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetHighlightedTab

Lekéri az aktuálisan kiemelt lap indexét.

int GetHighlightedTab() const;

Visszaadott érték

A kiemelt lap nulla alapú indexe.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Paraméterek

[in] iTabNum

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetLocation

Lekéri a tabulátor vezérlőelem lapterületének helyét.

Location GetLocation() const;

Visszaadott érték

A lapterület helye.

Megjegyzések

A lapterület lehetséges helyértékei LOCATION_BOTTOM és LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetTabArea

Lekéri a tabulátor vezérlőelem lapterületének méretét és pozícióját.

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

Paraméterek

rectTabAreaTop
[in] Egy objektumra mutató CRect hivatkozás. GetTabArea ezzel az objektummal tárolja a felső lapterület méretét és pozícióját.

rectTabAreaBottom
[in] Egy objektumra mutató CRect hivatkozás. GetTabArea ezzel az objektummal tárolja az alsó lapterület méretét és pozícióját.

Megjegyzések

A visszatérés után GetTabArea a paraméterek tartalmazzák CRect a lapterület méretét és pozícióját a tabulátorvezérlő ügyfélkoordinátáiban. Ha nincs lapterület a tabulátor vezérlőelem tetején vagy alján, rectTabAreaTop vagy rectTabAreaBottom üres.

Ebben a metódusban ez a CMFCBaseTabCtrl Classmódszer egy tiszta virtuális függvény, és nincs implementációja. Ha egy osztályt CMFCBaseTabCtrlszármaztat, implementálnia kell ezt a függvényt.

CMFCBaseTabCtrl::GetTabBkColor

Lekéri a megadott lap háttérszínét.

virtual COLORREF GetTabBkColor(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

EGY COLORREF érték, amely a megadott lap háttérszínét jelzi; -1, ha az iTab tartományon kívül esik.

CMFCBaseTabCtrl::GetTabBorderSize

A tabulátor vezérlőelem tabulátorszegélyeinek méretét kéri le.

virtual int GetTabBorderSize() const;

Visszaadott érték

A lapszegély mérete képpontban.

Megjegyzések

A tabulátorszegély alapértelmezett mérete három képpont. Ezt a szegélyméretet a CMFCBaseTabCtrl::SetTabBorderSize metódussal módosíthatja.

CMFCBaseTabCtrl::GetTabByID

Lekéri egy lap indexét egy lapazonosító alapján.

virtual int GetTabByID(int id) const;

Paraméterek

azonosító
[in] Egy lapazonosító.

Visszaadott érték

A tabulátor nulla alapú indexe, ha megtalálható; -1, ha a lapazonosító nem található.

Megjegyzések

A tabulátorazonosítók automatikusan lesznek hozzárendelve, amikor tabulátorokat adnak hozzá egy tabulátor vezérlőelemhez.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetTabFromHwnd

Lekéri a megadott HWND objektumot tartalmazó lap indexét.

virtual int GetTabFromHwnd(HWND hwnd) const;

Paraméterek

hwnd
[in] Egy ablak fogópontja.

Visszaadott érték

A lap nulla alapú indexe, ha sikeres; -1, ha a lap nem tartalmaz hwnd értéket.

CMFCBaseTabCtrl::GetTabFromPoint

Lekéri a megadott pontot tartalmazó lapot.

virtual int GetTabFromPoint(CPoint& pt) const;

Paraméterek

Pt
[in] A tabulátor vezérlőelem ügyfélkoordinátáinak egy pontja.

Visszaadott érték

A pt-t tartalmazó lap indexe; -1, ha nincs lap a pt.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Paraméterek

[in] iTab

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetTabHicon

A megadott laphoz társított HICON-t adja vissza.

virtual HICON GetTabHicon(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

A tabulátorcímkéhez társított HICON, ha sikeres; NULL érték, ha nincs HICON, vagy ha a metódus sikertelen.

CMFCBaseTabCtrl::GetTabIcon

Lekéri a megadott laphoz társított ikont.

virtual UINT GetTabIcon(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

A megadott lap ikonazonosítója, ha sikeres; -1, ha az index érvénytelen.

Megjegyzések

A CMFCBaseTabCtrl objektum a belső CImageList objektumban tárolja az ikonokat.

CMFCBaseTabCtrl::GetTabID

Lekéri a tabulátorindex által megadott lap azonosítóját.

int GetTabID(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

A lap azonosítója vagy -1, ha az iTab tartományon kívül esik.

CMFCBaseTabCtrl::GetTabLabel

Lekéri egy tabulátorcímke szövegét.

virtual BOOL GetTabLabel(
    int iTab,
    CString& strLabel) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

strLabel
[kifelé] Egy objektumra mutató CString hivatkozás. Ez a metódus ebben a paraméterben tárolja a lap címkéjét.

Visszaadott érték

IGAZ, ha sikeres; HAMIS egyéb esetben.

Megjegyzések

Ez a módszer meghiúsul, ha az index iTab érvénytelen.

Egy lap címkéjét a CMFCBaseTabCtrl::AddTab parancsmaggal hozhatja létre. A címke létrehozás után a CMFCBaseTabCtrl::SetTabLabel metódussal is módosítható.

CMFCBaseTabCtrl::GetTabRect

A megadott lap méretét és pozícióját kéri le.

virtual BOOL GetTabRect(
    int iTab,
    CRect& rect) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

téglalap
[kifelé] Egy objektumra mutató CRect hivatkozás. Ez a metódus ebben a paraméterben tárolja a lap méretét és pozícióját.

Visszaadott érték

IGAZ, ha sikeres; HAMIS, ha a tabulátorindex érvénytelen.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetTabsNum

Lekéri a tabulátor vezérlőelem lapjainak számát.

virtual int GetTabsNum() const;

Visszaadott érték

A tabulátor vezérlőelem lapjainak száma.

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Paraméterek

[in] rect

Megjegyzések

CMFCBaseTabCtrl::GetTabTextColor

A megadott lap szövegszínét kéri le.

virtual COLORREF GetTabTextColor(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

COLORREF paraméter, amely a megadott lap szövegszínét jelzi; -1, ha az iTab tartományon kívül esik.

CMFCBaseTabCtrl::GetTabWnd

A megadott lapon található ablaktáblára mutató mutatót adja vissza.

virtual CWnd* GetTabWnd(int iTab) const;

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

Visszaadott érték

Az iTab által megadott lapon található CWnd objektumra mutató mutató. NULL érték, ha az iTab érvénytelen.

Megjegyzések

A visszaadott objektum az, amelyet az alkalmazás a CMFCBaseTabCtrl::AddTab vagy CMFCBaseTabCtrl::InsertTab meghívásakor adott hozzá.

Ha egy lapon található objektum burkolóval rendelkezik, ez a metódus visszaadja az objektum burkolóját. A burkolókkal kapcsolatos további információkért lásd: CMFCBaseTabCtrl::CreateWrapper. Ha a burkoló nélkül szeretne elérni egy mutatót a közvetlen objektumhoz, használja a CMFCBaseTabCtrl::GetTabWndNoWrapper metódust.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Egy lap vezérlőelemre mutató mutatót ad vissza, még akkor is, ha a vezérlő burkolóval rendelkezik.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

Visszaadott érték

A megadott lapon található CWnd objektumra mutató mutató; NULL érték, ha az iTab érvénytelen.

Megjegyzések

Ez a metódus a CWnd vagy CMFCBaseTabCtrl::InsertTab metódussal lekéri a hozzáadott objektumra mutató közvetlen mutatót. GetTabWndNoWrapper akkor is lekéri a mutatót a hozzáadotthoz CWnd, ha a keretrendszer burkolót adott hozzá az objektumhoz. A burkolókkal és a CMFCBaseTabCtrl osztálysal kapcsolatos további információkért lásd: CMFCBaseTabCtrl::CreateWrapper.

Használja a CMFCBaseTabCtrl::GetTabWnd metódust , ha nem szeretné figyelmen kívül hagyni a burkolóosztályt.

CMFCBaseTabCtrl::GetToolTipCtrl

Az elemleírásra mutató hivatkozás lekérése.

CToolTipCtrl& GetToolTipCtrl() const;

Visszaadott érték

Hivatkozás az elemleírás-vezérlőre.

CMFCBaseTabCtrl::GetVisibleTabsNum

Lekéri az aktuálisan látható lapok számát.

virtual int GetVisibleTabsNum() const;

Visszaadott érték

A látható lapok száma.

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Paraméterek

[in] iTab

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::HideSingleTab

Beállítja a tabulátor vezérlőelem lapfüleinek elrejtésére szolgáló beállítást, ha egy látható lap van.

virtual void HideSingleTab(BOOL bHide = TRUE);

Paraméterek

bHide
[in] Logikai érték, amely meghatározza, hogy engedélyezve legyen-e egy lap elrejtése.

Megjegyzések

Ha az alkalmazás úgy van konfigurálva, hogy elrejtse az egyes lapokat, a keretrendszer automatikusan megjeleníti a lapfüleket, amikor egy második lapot ad hozzá a lapvezérlőhöz.

CMFCBaseTabCtrl::InsertTab

Tabulátor beszúrása a tabulátor vezérlőelembe.

Virtual void InsertTab(
    CWnd* pNewWnd,
    LPCTSTR lpszTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void InsertTab(
    CWnd* pNewWnd,
    UINT uiResTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Paraméterek

pNewWnd
[in] Mutató arra az ablakra, amelyet ez a metódus új lapként ad hozzá.

lpszTabLabel
[in] Az új lap címkéjét tartalmazó sztring.

nInsertAt
[in] Az új lap nulla alapú indexe.

uiImageId
[in] Képazonosító a képlistából. A tabulátor vezérlőelem ezt a képet használja az új lap ikonjaként.

bDetachable
[in] Logikai paraméter, amely meghatározza, hogy az új lap leválasztható-e.

uiResTabLabel
[in] A címke erőforrás-azonosítója.

Megjegyzések

Ha a pNewWnd által jelzett objektum nem a CDockablePane osztályból származik, és ha a bDetachable paraméter IGAZ, a keretrendszer létrehoz egy speciális burkolót az új laphoz. Alapértelmezés szerint a burkoló a CDockablePaneAdapter osztály egy példánya. A CMFCBaseTabCtrl::SetDockingBarWrapperRTC metódussal hozzon létre egy másik burkolóosztályt. Minden egyéni burkolóosztályt a rendszerből CDockablePaneAdapterkell származtatnia.

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Paraméterek

[in] iTab

Megjegyzések

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsAutoColor

Meghatározza, hogy a tabulátor vezérlőelem automatikus színezés módban van-e.

BOOL IsAutoColor() const;

Visszaadott érték

IGAZ, ha a tabulátor vezérlőelem automatikus színezés módban van; HAMIS egyéb esetben.

Megjegyzések

Az automatikus színezési módot a CMFCBaseTabCtrl::EnableAutoColor metódussal engedélyezheti vagy letilthatja.

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsFlatFrame

Azt jelzi, hogy a tabulátor vezérlőelem kerete sima vagy 3D stílusban jelenik-e meg.

virtual BOOL IsFlatFrame() const;

Visszaadott érték

IGAZ, ha a tabulátor vezérlőelem kerete sima stílusban jelenik meg; HAMIS, ha a keret 3D stílusban jelenik meg.

Megjegyzések

A CMFCTabCtrl::SetFlatFrame használatával módosíthatja a tabulátor vezérlőelem keretének stílusát.

Az Outlook-stílust használó tabulátorvezérlők nem jeleníthetők meg lapos keretekkel. Ez magában foglalja a CMFCOutlookBarTabCtrl osztályt és az osztályból származtatott összes osztályt.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsHideSingleTab

Meghatározza, hogy a tabulátor vezérlőelem elrejti-e a lapfeliratot, ha csak egy lap van.

virtual BOOL IsHideSingleTab() const;

Visszaadott érték

IGAZ, ha a tabulátor vezérlőelem elrejti a tabulátorcímkét, ha az egy lapfülkel rendelkezik; egyéb esetben HAMIS.

Megjegyzések

Használja a CMFCBaseTabCtrl::HideSingleTab metódust a lapcímke elrejtéséhez, ha csak egy lap van.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Paraméterek

[in] hIcon

[in] iIcon

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsInPlaceEdit

Azt jelzi, hogy a tabulátorvezérlő úgy van-e konfigurálva, hogy a felhasználó dinamikusan módosíthassa a tabulátorfeliratokat.

virtual BOOL IsInPlaceEdit() const;

Visszaadott érték

Nonzero, ha a helyszíni szerkesztés engedélyezve van; egyéb esetben 0.

Megjegyzések

A helyben végzett szerkesztés engedélyezéséhez vagy letiltásához hívja meg a CMFCBaseTabCtrl::EnableInPlaceEdit metódust.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsOneNoteStyle

Meghatározza, hogy a lapok megjelennek-e a Microsoft OneNote stílusában.

virtual BOOL IsOneNoteStyle() const;

Visszaadott érték

IGAZ, ha a lapok a Microsoft OneNote stílusában jelennek meg; egyéb esetben HAMIS.

Megjegyzések

Hívja meg a CMDIFrameWndEx::EnableMDITabs metódust a Microsoft OneNote stílus engedélyezéséhez. Ezt a stílust a CMFCTabCtrl osztály példányosításakor is engedélyezheti: egyszerűen adja át a stílus STYLE_3D_ONENOTE a CMFCTabCtrl::Létrehozás metódusnak.

Alapértelmezés szerint a Microsoft OneNote stílusa nem támogatott az adott osztályból CMFCBaseTabCtrl Classszármazó egyéni osztályban. Az osztály azonban támogatja CMFCTabCtrl .

CMFCBaseTabCtrl::IsPtInTabArea

Meghatározza, hogy egy pont a tabulátor területén belül van-e.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Paraméterek

pont
[in] A tesztelendő pont.

Visszaadott érték

Nonzero, ha a pont a tabulátor területén van; 0 egyéb esetben.

Megjegyzések

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::IsTabDetachable

Meghatározza, hogy egy lap leválasztható-e.

virtual BOOL IsTabDetachable(int iTab) const;

Paraméterek

iTab
[in] Az ellenőrizni kívánt lap nulla alapú indexe.

Visszaadott érték

IGAZ, ha a lap levehető; HAMIS egyéb esetben.

Megjegyzések

A tabulátor leválasztásához használja a CMFCBaseTabCtrl::EnableTabDetach metódust.

CMFCBaseTabCtrl::IsTabIconOnly

Meghatározza, hogy egy tabulátorcímke csak ikonokat és szöveget tartalmaz-e.

virtual BOOL IsTabIconOnly(int iTab) const;

Paraméterek

iTab
[in] A lap nulla alapú indexe.

Visszaadott érték

IGAZ, ha a tabulátorcímkének csak ikonjai vannak; HAMIS egyéb esetben.

Megjegyzések

Ha csak ikonok megjelenítésére szeretné beállítani az alkalmazás lapjait, hívja meg a CMFCBaseTabCtrl::SetTabIconOnly metódust.

CMFCBaseTabCtrl::IsTabSwapEnabled

Meghatározza, hogy a tabulátor vezérlőelem lehetővé teszi-e a felhasználó számára a tabulátorpozíciók módosítását az egérrel.

BOOL IsTabSwapEnabled() const;

Visszaadott érték

Nem, ha a felhasználó megváltoztathatja a tabulátorpozíciót; egyéb esetben 0.

Megjegyzések

A felhasználók alapértelmezés szerint nem módosíthatják a tabulátorok sorrendjét egy tabulátor vezérlőelemben. A funkció engedélyezéséhez használja a CMFCBaseTabCtrl::EnableTabSwap metódust .

CMFCBaseTabCtrl::IsTabVisible

Azt jelzi, hogy a megadott lap látható-e.

virtual BOOL IsTabVisible(int iTab) const;

Paraméterek

iTab
[in] Az ellenőrizni kívánt lap nulla alapú indexe.

Visszaadott érték

Nonzero, ha a megadott lap látható; egyéb esetben 0.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick meghatározza, hogy a tabulátorok fókuszban vannak-e, amikor a felhasználó a jobb egérgombbal kattint egy tabulátorcímkére.

BOOL m_bActivateTabOnRightClick;

Megjegyzések

Az adattag alapértelmezett értéke HAMIS.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow meghatározza, hogy a keretrendszer automatikusan megsemmisíti-e a lapok objektumait a lapok eltávolításakor.

BOOL m_bAutoDestroyWindow;

Megjegyzések

Alapértelmezés szerint ez a tag HAMIS.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Paraméterek

[in] nSource

[in] nDest

Megjegyzések

CMFCBaseTabCtrl::OnChangeTabs

A keretrendszer akkor hívja meg ezt a metódust, ha egy lapon lévő lapok száma megváltozik.

virtual void OnChangeTabs();

Megjegyzések

Alapértelmezés szerint ez a metódus nem tesz semmit. Ezt a metódust felülbírálva egyéni kódot hajthat végre, amikor megváltozik a tabulátorfülek száma.

CMFCBaseTabCtrl::OnDrop

virtual BOOL OnDrop(
    COleDataObject*,
    DROPEFFECT,
    CPoint);

Paraméterek

[in] COleDataObject*

[in] DROPEFFECT

[in] CPoint

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::OnDragOver

virtual DROPEFFECT OnDragOver(
    COleDataObject*,
    DWORD,
    CPoint);

Paraméterek

[in] COleDataObject*

[in] DWORD

[in] CPoint

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Megjegyzések

CMFCBaseTabCtrl::OnDragEnter

virtual DROPEFFECT OnDragEnter(
    COleDataObject*,
    DWORD,
    CPoint);

Paraméterek

[in] COleDataObject*

[in] DWORD

[in] CPoint

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Paraméterek

[in] Int

[in] CString>

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Paraméterek

[in] pMsg

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::RecalcLayout

Újraszámítja a tabulátorvezérlő belső elrendezését.

virtual void RecalcLayout() = 0;

Megjegyzések

Ebben a CMFCBaseTabCtrl Classmetódusban ez a módszer egy tiszta virtuális függvény. Ha egy osztályt CMFCBaseTabCtrlszármaztat, implementálnia kell ezt a függvényt.

CMFCBaseTabCtrl::RemoveAllTabs

Eltávolítja az összes lapot a tabulátor vezérlőelemből.

virtual void RemoveAllTabs();

Megjegyzések

Ha a CMFCBaseTabCtrl::m_bAutoDestroyWindow igaz, a keretrendszer törli az eltávolított lapokhoz csatolt összes CWnd objektumot.

CMFCBaseTabCtrl::RemoveTab

Eltávolít egy lapot a tabulátor vezérlőelemből.

virtual BOOL RemoveTab(
    int iTab,
    BOOL bRecalcLayout = TRUE);

Paraméterek

iTab
[in] Egy lap nulla alapú indexe.

bRecalcLayout
[in] Logikai paraméter, amely meghatározza, hogy újra kell-e számolni a lap elrendezését.

Visszaadott érték

IGAZ, ha a metódus sikeresen eltávolítja a lapot; egyéb esetben HAMIS.

Megjegyzések

Ha a CMFCBaseTabCtrl::m_bAutoDestroyWindow igaz, RemoveTab a megadott laphoz társított CWnd objektumot megsemmisíti.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::ResetImageList

Alaphelyzetbe állítja a CMFCBaseTabCtrl osztály egy példányának képlistáját.

void ResetImageList();

CMFCBaseTabCtrl::Szerializálás

virtual void Serialize(CArchive& ar);

Paraméterek

[in] Ar

Megjegyzések

CMFCBaseTabCtrl::SetActiveTab

Aktiválja a megadott lapot.

virtual BOOL SetActiveTab(int iTab) = 0;

Paraméterek

iTab
[in] Egy lap nulla alapú indexe. SetActiveTab aktívvá teszi az indexet tartalmazó lapot.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

Ebben a CMFCBaseTabCtrl Classmetódusban ez a módszer egy tiszta virtuális függvény. Ha egy osztályt CMFCBaseTabCtrlszármaztat, implementálnia kell ezt a függvényt.

CMFCBaseTabCtrl::SetActiveTabColor

Beállítja az aktív lap háttérszínét.

virtual void SetActiveTabColor(COLORREF clr);

Paraméterek

Clr
[in] Megadja az új háttérszínt.

Megjegyzések

A keretrendszer az aktív lapok alapértelmezett háttérszínét a GetSysColor metódusból szerzi be .

CMFCBaseTabCtrl::SetActiveTabTextColor

Az aktív lapok szövegszínét állítja be.

virtual void SetActiveTabTextColor(COLORREF clr);

Paraméterek

Clr
[in] Az új szövegszínt meghatározó COLORREF paraméter.

Megjegyzések

Alapértelmezés szerint a keretrendszer beolvasja a szöveg színét a GetSysColor-ból. Az alapértelmezett szín felülbírálása a SetActiveTabTextColor metódussal.

CMFCBaseTabCtrl::SetAutoColors

A keretrendszer által automatikus szín módban használt tabulátor vezérlőelem színeit állítja be.

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

Paraméterek

arColors
[in] RGB-színek tömbje.

Megjegyzések

Ha egyéni színtömböt ad meg, a rendszer figyelmen kívül hagyja az alapértelmezett színtömböt. Ha az arColors paraméter üres, a keretrendszer visszaáll az alapértelmezett színtömbre.

Az automatikus színezés engedélyezéséhez használja a CMFCBaseTabCtrl::EnableAutoColor metódust .

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Beállítja a CDockablePane osztályból nem származtatott objektumokhoz használt burkolóosztályt.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Paraméterek

pRTC
[in] Az új burkolóosztály futtatókörnyezeti osztályának adatai.

Megjegyzések

Lapfüleket adhat hozzá egy lapvezérlőhöz a CMFCBaseTabCtrl::AddTab és CMFCBaseTabCtrl::InsertTab metódusokkal. Lap hozzáadásakor a lapon lévő összes vezérlőnek rögzíthetőnek kell lennie. Minden olyan objektumot, amelyből CDockablePane nem származik, burkolni kell. AddTab és InsertTab hozzon létre egy burkolót ezekhez az objektumokhoz. Az alapértelmezett burkolóosztály a CDockablePaneAdapter osztály. Ezzel a módszerrel SetDockingBarWrapperRTC módosíthatja a burkolóosztályként használt osztályt. A megadott burkolóosztálynak a következőből CDockablePaneAdapterkell származnia: .

CMFCBaseTabCtrl::SetDrawNoPrefix

Engedélyezi és letiltja az előtagkarakterek feldolgozását a tabulátorcímkékben.

void SetDrawNoPrefix(
    BOOL bNoPrefix,
    BOOL bRedraw = TRUE);

Paraméterek

bNoPrefix
[in] IGAZ, ha előtag karaktereket szeretne feldolgozni; egyéb esetben HAMIS.

bRedraw
[in] IGAZ, ha újra szeretné átrajzolni a lapozott ablakot; egyéb esetben HAMIS.

Megjegyzések

Az előtag karakter egy mnemonikus karakter, amelyet egy ampersand (>) előz meg.

CMFCBaseTabCtrl::SetImageList

Beállítja a tabulátor vezérlőelem ikonképlistáját.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Paraméterek

uiID
[in] Egy bitkép erőforrás-azonosítója. SetImageList betölti a képlistát ebből az erőforrásból.

cx
[in] Az egyes képek szélessége képpontban.

clrTransp
[in] COLORREF paraméter, amely a kép áttetsző színét jelzi.

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

Visszaadott érték

Nonzero, ha a módszer sikeres volt; 0 egyéb esetben.

Megjegyzések

Az ikon képlistájában szereplő képek a lap címkéi mellett jelennek meg. Egy ikon megjelenítéséhez meg kell adnia annak indexét, amikor meghívja a CMFCBaseTabCtrl::AddTab parancsot.

SetImageList sikertelen lesz, ha a tabulátor vezérlőelem lapos stílussal lett létrehozva. Az is sikertelen lesz, ha a keretrendszer nem tudja betölteni a uiID által jelzett képet.

Ez a módszer újraszámítja a lap magasságát a kép és a szöveg méretének megfelelően.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Paraméterek

[in] hely

Megjegyzések

CMFCBaseTabCtrl::SetTabBkColor

Beállítja a megadott lap háttérszínét.

virtual BOOL SetTabBkColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Paraméterek

iTab
[in] A lap nulla alapú indexe.

szín
[in] A beállítani kívánt szín.

Visszaadott érték

IGAZ, ha sikeres; HAMIS egyéb esetben.

CMFCBaseTabCtrl::SetTabBorderSize

Új szegélyméretet állít be a tabulátorvezérlőhöz.

virtual void SetTabBorderSize(
    int nTabBorderSize,
    BOOL bRepaint = TRUE);

Paraméterek

nTabBorderSize
[in] Az új szegélyméret képpontban.

bRepaint
[in] Logikai paraméter, amely azt jelzi, hogy a keretrendszer újraírja-e a vezérlőt.

CMFCBaseTabCtrl::SetTabHicon

Tabulátorcímke ikonjának beállítása.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Paraméterek

iTab
[in] Egy lap nulla alapú indexe. Ez a metódus módosítja a lap ikont.

hIcon
[in] Egy ikon fogópontja.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

CMFCBaseTabCtrl::SetTabIcon

Egy lap ikonjának beállítása.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Paraméterek

iTab
[in] A frissíteni kívánt lap nulla alapú indexe.

uiIcon
[in] Az új ikon ikonazonosítója. Ez az azonosító a belső CImageList objektumra hivatkozik.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

CMFCBaseTabCtrl::SetTabIconOnly

Lehetővé teszi, hogy csak egy ikon (és szövegfelirat) jelenjen meg egy adott lapon.

virtual BOOL SetTabIconOnly(
    int iTab,
    BOOL bIconOnly = TRUE,
    BOOL bShowTooltipAlways = FALSE);

Paraméterek

iTab
[in] A módosítani kívánt lap nulla alapú indexe.

bIconOnly
[in] Logikai paraméter, amely meghatározza, hogy csak ikonok jelenjenek-e meg.

bShowTooltipAlways
[in] Logikai paraméter, amely meghatározza, hogy a keretrendszer csak ikonokat megjelenítő tabulátorcímkéhez tartozó elemleírásokat jelenít-e meg.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

Alapértelmezés szerint egy tabulátor vezérlőelem megjeleníti az egyes lapok ikont és szövegfeliratát.

CMFCBaseTabCtrl::SetTabLabel

Tabulátorfelirat szövegének beállítása.

virtual BOOL SetTabLabel(
    int iTab,
    const CString& strLabel);

Paraméterek

iTab
[in] A frissíteni kívánt lap nulla alapú indexe.

strLabel
[in] Hivatkozás a tabulátorcímke új szövegét tartalmazó sztringre.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Megjegyzések

CMFCBaseTabCtrl::SetTabsOrder

Rendezi a lapokat a megadott sorrendben.

BOOL SetTabsOrder(const CArray<int,int>& arOrder);

Paraméterek

arOrder
[in] Az új lapsorrendet meghatározó nulla alapú indexek tömbje.

Visszaadott érték

IGAZ, ha sikeres; MÁSKÜLÖNBEN SIKERTELEN.

Megjegyzések

Az arOrder tömb méretének meg kell egyezőnek lennie a tabulátor vezérlőelem lapjainak számával.

CMFCBaseTabCtrl::SetTabTextColor

Beállítja egy adott lap szövegszínét.

virtual BOOL SetTabTextColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Paraméterek

iTab
[in] A lap nulla alapú indexe.

szín
[in] EGY COLORREF paraméter, amely az új szövegszínt jelzi.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

CMFCBaseTabCtrl::ShowTab

Megjeleníti vagy elrejti a megadott lapot.

virtual BOOL ShowTab(
    int iTab,
    BOOL bShow = TRUE,
    BOOL bRecalcLayout = TRUE,
    BOOL bActivate = FALSE);

Paraméterek

iTab
[in] A megjelenő vagy elrejtett lap ShowTab indexe.

bShow
[in] Logikai paraméter, amely jelzi, hogy meg szeretné-e jeleníteni a lapot.

bRecalcLayout
[in] Logikai paraméter, amely azt jelzi, hogy azonnal újra kell-e számolni az ablakelrendezést.

bAktiválás
[in] Logikai paraméter, amely azt jelzi, hogy az iTab által megadott lapot kell-e kijelölni.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A bActivate paraméter csak akkor érvényes, ha a bShow ÉRTÉKE IGAZ. Ha a bActivate igaz, és sikeres ShowTab , ShowTab akkor a AFX_WM_CHANGE_ACTIVE_TAB üzenetet küldi el a lapablak szülőjének.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Paraméterek

[in] iTab

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Paraméterek

[in] nFisrtTabID

[in] nSecondTabID

Megjegyzések

Lásd még

hierarchiadiagram
osztályok
CMFCTabCtrl osztály
CMFCOutlookBarTabCtrl osztály

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-11-07

Megosztás:

CMFCBaseTabCtrl osztály

Szemantika

Tagok

Nyilvános metódusok

Védett metódusok

Adattagok

Megjegyzések

Testreszabási tippek

Öröklési hierarchia

Követelmények

CMFCBaseTabCtrl::AddIcon

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::AddTab

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::ApplyRestoredTabInfo

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::AutoDestroyWindow

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::CalcRectEdit

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::CleanUp

Megjegyzések

CMFCBaseTabCtrl::ClearImageList

Megjegyzések

CMFCBaseTabCtrl::CreateWrapper

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::D etachTab

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::EnableActivateLastActive

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::EnableAutoColor

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::EnableCustomToolTips

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::EnableInPlaceEdit

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::EnableTabDetach

Paraméterek

Visszaadott érték

CMFCBaseTabCtrl::EnableTabSwap

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::EnsureVisible

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::EnterDragMode

Megjegyzések

CMFCBaseTabCtrl::FindTargetWnd

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::FireChangeActiveTab

Paraméterek

Megjegyzések

CMFCBaseTabCtrl::FireChangingActiveTab

Paraméterek

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetActiveTab

Visszaadott érték

CMFCBaseTabCtrl::GetActiveTabColor

Visszaadott érték

Megjegyzések

CMFCBaseTabCtrl::GetActiveTabTextColor