CMFCBaseTabCtrl – třída

Článek
04/01/2024

Implementuje základní funkce pro okna s kartami. Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCBaseTabCtrl : public CWnd

Členové

Veřejné metody

Název	Popis
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Přidá novou kartu do okna s kartami.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::D etachTab	Odpojte kartu z okna s kartami.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Povolí nebo zakáže automatické barvení tabulátoru.
CMFCBaseTabCtrl::EnableCustomTool Tipy	Povolí nebo zakáže vlastní popisy karet.
CMFCBaseTabCtrl::EnableInPlaceEdit	Povolí nebo zakáže přímé úpravy popisků karet.
CMFCBaseTabCtrl::EnableTabDetach	Povolí odpojitelné karty.
CMFCBaseTabCtrl::EnableTabSwap	Povolí nebo zakáže, jestli uživatel může změnit pořadí ovládacích prvků pomocí myši.
CMFCBaseTabCtrl::EnsureVisible	Posune karty, dokud se zadaná karta nezobrazí. Tato metoda nemá žádný vliv, pokud je zadaná karta již viditelná.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Vrátí podokno, které obsahuje zadaný bod.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Vrátí index aktivní karty.
CMFCBaseTabCtrl::GetActiveTabColor	Vrátí barvu pozadí aktivní karty.
CMFCBaseTabCtrl::GetActiveTabTextColor	Vrátí barvu textu aktivní karty.
CMFCBaseTabCtrl::GetActiveWnd	Vrátí ukazatel na aktivní stránku ovládacího prvku tab.
CMFCBaseTabCtrl::GetAutoColors	Vrátí odkaz na pole barev, které se používají pro automatické barvení.
CMFCBaseTabCtrl::GetFirstVisibleTab	Vrátí ukazatel na první viditelnou kartu.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Vrátí index aktuálně zvýrazněné karty.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Vrátí proměnnou datového typu LOCATION, která označuje umístění oblasti tabulátoru vzhledem k ovládacímu prvku tab. Například nahoře nebo dole.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Vrátí velikost a umístění oblasti tabulátoru v okně s kartami. Pozice oblasti tabulátoru je definována pomocí souřadnic.
CMFCBaseTabCtrl::GetTabBkColor	Vrátí barvu pozadí zadané karty.
CMFCBaseTabCtrl::GetTabBorderSize	Vrátí velikost ohraničení tabulátoru v ovládacím prvku tabulátoru.
CMFCBaseTabCtrl::GetTabByID	Vrátí index karty, která je identifikována zadaným ID.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Vrátí index karty, která obsahuje zadaný objekt HWND.
CMFCBaseTabCtrl::GetTabFromPoint	Vrátí kartu, která obsahuje zadaný bod.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Vrátí ikonu přidruženou k zadané kartě.
CMFCBaseTabCtrl::GetTabID	Vrátí ID karty pomocí indexu karty.
CMFCBaseTabCtrl::GetTabIcon	Vrátí ID ikony pro zadanou kartu.
CMFCBaseTabCtrl::GetTabLabel	Vrátí text zadané karty.
CMFCBaseTabCtrl::GetTabRect	Načte velikost a umístění zadané karty.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Vrátí barvu textu zadané karty.
CMFCBaseTabCtrl::GetTabWnd	Vrátí ukazatel na podokno, které se nachází na zadané stránce karty.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Vrátí přímý ukazatel na ovládací prvek, který se nachází na zadané stránce karty, i když má ovládací prvek obálku.
CMFCBaseTabCtrl::GetTabsNum	Vrátí počet karet obsažených v ovládacím prvku tab.
CMFCBaseTabCtrl::GetToolTipCtrl	Vrátí odkaz na ovládací prvek popisu přidruženého k objektu `CMFCBaseTabCtrl` .
CMFCBaseTabCtrl::GetVisibleTabsNum	Vrátí počet viditelných karet.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Nastaví možnost, která skryje kartu okna, ale jenom v případě, že se v okně s kartami zobrazí jenom jedna viditelná karta.
CMFCBaseTabCtrl::InsertTab	Vloží novou kartu.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Vrátí hodnotu, která určuje, jestli je okno s kartami v automatickém barevném režimu.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Vrátí hodnotu, která určuje, jestli je rámeček pro oblast tabulátoru plochý nebo 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Vrátí hodnotu, která určuje, jestli je ovládací prvek tab nakonfigurován pro skrytí karty, ale pouze v případě, že okno s kartami má jenom jednu viditelnou kartu.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Určuje, jestli mohou uživatelé změnit popisek na kartě.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Určuje, jestli okno s kartami zobrazuje karty ve stylu Microsoft OneNotu.
CMFCBaseTabCtrl::IsPtInTabArea	Zkontroluje, jestli v oblasti tabulátoru existuje zadaný bod.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Určuje, jestli je karta odpojená.
CMFCBaseTabCtrl::IsTabiconOnly	Určuje, jestli karty zobrazují ikony, ale ne popisky.
CMFCBaseTabCtrl::IsTabSwapEnabled	Určuje, zda uživatel může měnit pozice tabulátoru přetažením tabulátoru.
CMFCBaseTabCtrl::IsTabVisible	Určuje, zda je zadaná karta viditelná.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Volá se rozhraním, když se změní počet karet.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::P reTranslateMessage	Třída CWinApp k překladu oken zprávy před jejich odesláním do Funkce TranslateMessage a DispatchMessage Windows. (Přepsání CWnd::P reTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Přepočítá vnitřní rozložení okna s kartami.
CMFCBaseTabCtrl::RemoveAllTabs	Odebere všechny karty z okna s kartami.
CMFCBaseTabCtrl::RemoveTab	Odebere kartu z okna s kartami.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Obnoví seznam obrázků připojený k okně s kartami.
CMFCBaseTabCtrl::Serialize	Čte nebo zapisuje tento objekt z archivu nebo do archivu. (Přepsání CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Aktivuje kartu.
CMFCBaseTabCtrl::SetActiveTabColor	Nastaví barvu pozadí pro aktuálně aktivní kartu.
CMFCBaseTabCtrl::SetActiveTabTextColor	Nastaví barvu textu pro aktivní karty.
CMFCBaseTabCtrl::SetAutoColors	Nastaví barvy ovládacího prvku karty použité v automatickém režimu barev.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Nastaví obálku třídy, která se používá pro všechny objekty, které nejsou odvozeny z CDockablePane Třídy.
CMFCBaseTabCtrl::SetDrawNoPrefix	Povolí a zakáže zpracování znaků předpony při vykreslení popisků tabulátoru.
CMFCBaseTabCtrl::SetImageList	Nastaví seznam obrázků ikon.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Nastaví barvu pozadí pro zadanou kartu.
CMFCBaseTabCtrl::SetTabBorderSize	Nastaví novou velikost ohraničení tabulátoru.
CMFCBaseTabCtrl::SetTabHicon	Nastaví ikonu karty.
CMFCBaseTabCtrl::SetTabIcon	Nastaví ID ikony karty.
CMFCBaseTabCtrl::SetTabIconOnly	Povolí a zakáže režim pouze ikony pro zadanou kartu.
CMFCBaseTabCtrl::SetTabLabel	Nastaví popisek karty, který se rovná zadané řetězcové hodnotě.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Nastaví barvu textu pro zadanou kartu.
CMFCBaseTabCtrl::SetTabsOrder	Uspořádá karty v zadaném pořadí.
CMFCBaseTabCtrl::ShowTab	Zobrazí nebo skryje zadanou kartu.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Chráněné metody

Název	Popis
CMFCBaseTabCtrl::CreateWrapper	Vytvoří obálku pro objekt odvozený z CWnd , který není odvozen z `CDockablePane`. Chcete-li ukotvit `CMFCBaseTabCtrl` objekt, musí mít každý vložený ovládací prvek buď dokovací obálku, nebo musí být odvozen z `CDockablePane`. Třídu obálky nastavíte pomocí `SetDockingBayWrapperRTC`.

Datové členy

Název	Popis
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Určuje, zda jsou karty vybrány pomocí levého kliknutí myší nebo kliknutí pravým tlačítkem myši.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Určuje, zda jsou podokna obsažená na kartách automaticky zničena.

Poznámky

Třída CMFCBaseTabCtrl je abstraktní třída. Proto nelze vytvořit instanci. Chcete-li vytvořit okno s kartami, je nutné odvodit třídu z CMFCBaseTabCtrl. Knihovna MFC obsahuje některé odvozené příklady tříd, z nichž dva jsou CMFCTabCtrl – třída a CMFCOutlookBarTabCtrl – třída.

Počínaje sadou Visual Studio 2015 tato třída podporuje microsoft Active Accessibility.

Tipy přizpůsobení

Následující tipy se týkají CMFCBaseTabCtrl Class tříd, které z něj dědí:

Pokud povolíte odpojitelné karty, neuchovávejte ukazatele na okna s kartami. Tyto odpojené karty je možné vytvářet a rušit dynamicky. Proto se ukazatele můžou stát neplatnými.
Ovládací prvek tabulátoru můžete nakonfigurovat tak, aby uživatelé mohli dynamicky přesouvat karty na ovládacím prvku karty pomocí myši. Tato funkce je integrovaná do CMFCBaseTabCtrl třídy. Chcete-li ji povolit, zavolejte CMFCBaseTabCtrl::EnableTabSwap.
Ve výchozím nastavení se karty dají odpojit, když je přidáte do ovládacího prvku karty. Karty, které nelze odpojit, můžete přidat také pomocí CMFCBaseTabCtrl::AddTab. Pokud nastavíte parametr bDetachable na FALSE, karta nebude odpojena. Můžete také změnit, zda karty jsou odpojeny voláním metody CMFCBaseTabCtrl::EnableTabDetach.
Objekty odvozené z třídy CWnd lze umístit na dockable ovládací panel nebo dockable tab. Aby bylo možné ukotvit celý ovládací prvek, musíte CWnd objekt ukotvit. K tomuto účelu mfc používá třídu obálky. Tato třída obálky je CDockablePaneAdapter – třída. Všechny CWnd objekty přidané do dokovatelného ovládacího panelu nebo dokovatelné karty budou zabaleny uvnitř objektu CDockablePaneAdapter . Automatické zabalení můžete zakázat nastavením parametru m_bEnableWrapping objektu CMFCBaseTablCtrl na FALSE. Můžete také změnit třídu, kterou bude vaše aplikace používat jako obálku pomocí metody CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Hierarchie dědičnosti

Požadavky

Hlavička: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Přidá ikonu do seznamu ikon v chráněném CMap m_mapAddedIcons členu.

void AddIcon(
    HICON hIcon,
    int iIcon);

Parametry

hIcon
[v] Popisovač ikony, která se má přidat.

iIcon
[v] Index ikony v chráněném CImageList m_Images členu založený na nule.

Poznámky

CMFCBaseTabCtrl::AddTab

Přidá novou kartu do ovládacího prvku karta.

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

Parametry

pTabWnd
[v] Ukazatel na okno, které tato metoda představuje jako novou kartu.

lpszTabLabel
[v] Řetězec, který obsahuje popisek nové karty.

uiImageId
[v] ID obrázku ze seznamu obrázků. Ovládací prvek Karta používá tento obrázek jako ikonu nové karty.

uiResTabLabel
[v] ID prostředku pro popisek.

bDetachable
[v] Logický parametr, který určuje, jestli je nová karta odpojená.

Poznámky

Pokud pTabWnd odkazuje na objekt, který není odvozen z CDockablePane Třídy a pokud bDetachable je TRUE, architektura automaticky vytvoří obálku pro pTabWnd objektu. Obálka oddělí objekt pTabWnd . Ve výchozím nastavení je obálka instance CDockablePaneAdapter Třída. Pokud jsou funkce nabízené výchozí obálkou nepřijatelné, použijte CMFCBaseTabCtrl::SetDockingBarWrapperRTC metoda k určení jiné obálky.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parametry

[v] bUseTabIndexes

Poznámky

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Parametry

[v] bAutoDestroy

Poznámky

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Parametry

[v] rectEdit

Poznámky

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Poznámky

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Poznámky

CMFCBaseTabCtrl::CreateWrapper

Vytvoří obálku pro okno rámce, které je odvozeno z třídy CWnd , ale není odvozeno z CDockablePane třídy.

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

Parametry

pWndToWrap
[v] Ukazatel na okno rámečku, které je zabalené.

lpszTabLabel
[v] Řetězec, který obsahuje popisek okna.

bDetachable
[v] Logický parametr, který označuje, jestli je okno odpojené.

Návratová hodnota

Ukazatel na obálku CDockablePane odvozenou z třídy, pokud CreateWrapper úspěšně vytvoří obálku třídy pro pWndToWrap. Pokud metoda selže, vrátí pWndToWrap.

Poznámky

Okno s kartami může ukotvit jakýkoli objekt odvozený z CWnd. Aby CMFCBaseTabCtrl Class však byl objekt ukotvený, musí být každý objekt na daném objektu CMFCBaseTabCtrl odpojený. CMFCBaseTabCtrl Proto automaticky zabalí všechny objekty, které nejsou odvozeny z CDockablePane.

Ve výchozím nastavení vytvoří CMFCBaseTabCtrl instance CDockablePaneAdapter Třídy. Chcete-li změnit výchozí třídu obálky, zavolejte CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Pokud pWndToWrap je odvozen z CDockablePane, tato metoda nevytvoří obálku. Místo toho selžou a vrátí pWndToWrap.

CMFCBaseTabCtrl::D etachTab

Architektura volá tuto metodu pro odpojení karty od ovládacího prvku tab.

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

Parametry

dockMethod
[v] Výčtový datový typ poskytovaný třídou CBasePane. Tento datový typ určuje metodu použitou k odpojení karty.

nTabNum
[v] Index karty založený na nule, který se má odpojit.

bHide
[v] Logický parametr, který označuje, jestli má architektura skrýt odpojenou kartu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Pokud je karta zadaná funkcí nTabNum nedetachovatelná, tato funkce selže a vrátí hodnotu NEPRAVDA.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Parametry

[v] bLastActive

Poznámky

CMFCBaseTabCtrl::EnableAutoColor

Určuje, zda architektura používá automatické barvy pozadí při kreslení karty.

void EnableAutoColor(BOOL bEnable = TRUE);

Parametry

bEnable
[v] Logický parametr, který určuje, jestli architektura používá automatické barvy.

Poznámky

Ovládací prvek tab má pole několika předdefinovaných barev. Když architektura používá automatické barvy, každé tabulátoru v řadě karet je přiřazena další barva z tohoto pole.

Ve výchozím nastavení jsou automatické barvy určeny barvami definovanými knihovnou. Vlastní pole barev můžete zadat voláním CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::EnableCustomTool Tipy

Povolí vlastní popisy ovládacích prvků tabulátoru.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Parametry

bEnable
[v] Logická hodnota, která určuje, jestli se mají používat vlastní popisy.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

Pokud jsou povoleny vlastní popisy tlačítek, ovládací prvek tabulátoru odešle AFX_WM_ON_GET_TAB_TOOLTIP zprávu do hlavního rámce. Pokud chcete podporovat vlastní popisy v aplikaci, hlavní okno rámce musí tuto metodu zpracovat a zadat vlastní text popisu. Další informace o poskytování vlastního textu popisu naleznete v tématu CMFCTabToolTipInfo – struktura.

CMFCBaseTabCtrl::EnableInPlaceEdit

Povolí přímé úpravy popisků karet uživatelem.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Parametry

bEnable
[v] Logický parametr, který určuje, jestli chcete povolit přímé úpravy popisků karet.

Poznámky

Ve výchozím nastavení je u ovládacích prvků karet zakázána přímá úprava popisků karet.

Přímé úpravy můžete povolit pro podmnožinu karet v ovládacím prvku karta. Chcete-li to provést, přepište metodu CMFCBaseTabCtrl::StartRenameTab. StartRenameTab by měla vrátit nenulovou hodnotu pro všechny karty, které podporují přímé úpravy popisků karet.

CMFCBaseTabCtrl ClassV této metodě je čistá virtuální funkce a nemá žádnou implementaci. Pokud odvozujete třídu z CMFCBaseTabCtrl, je nutné implementovat tuto funkci.

CMFCBaseTabCtrl::EnableTabDetach

Povolí odpojitelné karty.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Parametry

iTab
[v] Index karty založený na nule.

bEnable
[v] Logická hodnota označující, jestli se má tabulátor odpojit.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

CMFCBaseTabCtrl::EnableTabSwap

Umožňuje uživateli změnit pořadí ovládacích prvků pomocí myši.

void EnableTabSwap(BOOL bEnable);

Parametry

bEnable
[v] Logická hodnota označující, jestli se má povolit prohození tabulátoru.

Poznámky

Po povolení prohození tabulátoru může uživatel přetáhnout kartu a změnit jeho relativní pozici v ovládacím prvku karta.

CMFCBaseTabCtrl::EnsureVisible

Posune karty, dokud se zadaná karta nezobrazí.

virtual BOOL EnsureVisible(int iTab);

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato metoda nemá žádný vliv, pokud je již zobrazena karta označená tabulátorem iTab .

Ve výchozím nastavení tato metoda není podporována CMFCBaseTabCtrl Class. Tuto funkci byste měli implementovat ve vlastní třídě odvozené z CMFCBaseTabCtrl toho, jestli tento ovládací prvek vlastní karty podporuje posouvání karet. Tato metoda je podporována CMFCTabCtrl Třída.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Poznámky

CMFCBaseTabCtrl::FindTargetWnd

Identifikuje podokno, které obsahuje zadaný bod.

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

Parametry

Pt
[v] Bod, který je definován pomocí souřadnic klientské oblasti CMFCBaseTabCtrl objektu.

Návratová hodnota

Ukazatel na objekt CWnd v případě úspěchu; jinak NULL.

Poznámky

CMFCBaseTabCtrl V této třídě je tato metoda čistě virtuální funkce: je nutné ji implementovat, pokud odvozujete třídu z CMFCBaseTabCtrl.

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Parametry

[v] nNewTab

Poznámky

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Parametry

[v] nNewTab

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetActiveTab

Načte index aktuálně aktivní karty.

virtual int GetActiveTab() const;

Návratová hodnota

Index aktivní karty založený na nule; -1, pokud není aktivní karta.

CMFCBaseTabCtrl::GetActiveTabColor

Načte barvu pozadí aktuálně aktivní karty.

virtual COLORREF GetActiveTabColor() const;

Návratová hodnota

Hodnota COLORREF, která určuje barvu pozadí aktivní karty.

Poznámky

Ve výchozím nastavení je barva pozadí aktivní karty COLOR_WINDOW. Barvu pozadí aktivní karty můžete změnit pomocí metody CMFCBaseTabCtrl::SetActiveTabColor.

CMFCBaseTabCtrl::GetActiveTabTextColor

Načte barvu textu pro aktivní kartu.

virtual COLORREF GetActiveTabTextColor() const;

Návratová hodnota

Hodnota COLORREF, která určuje barvu textu aktivní karty.

Poznámky

Ve výchozím nastavení je barva textu aktivních karet COLOR_WINDOWTEXT. Barvu textu můžete změnit pomocí metody CMFCBaseTabCtrl::SetActiveTabTextColor.

CMFCBaseTabCtrl::GetActiveWnd

Načte ukazatel na aktuálně aktivní okno karty.

virtual CWnd* GetActiveWnd() const;

Návratová hodnota

Ukazatel na okno.

CMFCBaseTabCtrl::GetAutoColors

Načte pole barev používaných pro automatické barvení.

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

Návratová hodnota

Odkaz na pole COLORREF hodnot, které CMFCBaseTabCtrl objekt používá pro automatické barvení tabulátoru.

Poznámky

Ve výchozím nastavení architektura inicializuje pole barev na barvy definované knihovnou. Vlastní pole barev můžete zadat voláním metody CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::GetFirstVisibleTab

Načte ukazatel na první viditelnou kartu.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

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

Parametry

iTabNum
[ven] Odkaz na celé číslo. Tato metoda zapíše do tohoto parametru index založený na nule první viditelné karty.

iStartFrom
[v] Index založený na nule první karty, který chcete zkontrolovat.

Návratová hodnota

Ukazatel na první viditelnou kartu v případě úspěchu; jinak NULL.

Poznámky

Pokud tato metoda selže, zapíše hodnotu -1 do iStartFrom.

Pokud je hodnota iStartFrom větší nebo rovna počtu karet v ovládacím prvku karta, GetFirstVisibleTab automaticky selže.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetHighlightedTab

Načte index aktuálně zvýrazněné karty.

int GetHighlightedTab() const;

Návratová hodnota

Index založený na nule zvýrazněné karty.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Parametry

[v] iTabNum

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetLocation

Načte umístění části oblasti karty ovládacího prvku Tab.

Location GetLocation() const;

Návratová hodnota

Umístění oblasti karty.

Poznámky

Možné hodnoty umístění oblasti karet jsou LOCATION_BOTTOM a LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetTabArea

Načte velikost a umístění oblasti tabulátoru ovládacího prvku tab.

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

Parametry

rectTabAreaTop
[v] Odkaz na CRect objekt. GetTabArea používá tento objekt k uložení velikosti a umístění horní oblasti karty.

rectTabAreaBottom
[v] Odkaz na CRect objekt. GetTabArea používá tento objekt k uložení velikosti a umístění oblasti dolní karty.

Poznámky

Po GetTabArea vrácení CRect parametry obsahují velikost a umístění oblasti tabulátoru v souřadnicích klienta ovládacího prvku tab. Pokud není v horní nebo dolní části ovládacího prvku rectTabAreaTop karta žádná oblast tabulátoru nebo rectTabAreaBottom je prázdná.

CMFCBaseTabCtrl ClassV této metodě je čistá virtuální funkce a nemá žádnou implementaci. Pokud odvozujete třídu z CMFCBaseTabCtrl, musíte tuto funkci implementovat.

CMFCBaseTabCtrl::GetTabBkColor

Načte barvu pozadí zadané karty.

virtual COLORREF GetTabBkColor(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

Hodnota COLORREF, která označuje barvu pozadí zadané karty; -1, pokud je tabulka iTab mimo rozsah.

CMFCBaseTabCtrl::GetTabBorderSize

Načte velikost ohraničení tabulátoru v ovládacím prvku karta.

virtual int GetTabBorderSize() const;

Návratová hodnota

Velikost ohraničení tabulátoru v pixelech

Poznámky

Výchozí velikost ohraničení tabulátoru je tři pixely. Tuto velikost ohraničení můžete změnit pomocí metody CMFCBaseTabCtrl::SetTabBorderSize.

CMFCBaseTabCtrl::GetTabByID

Načte index karty na základě ID karty.

virtual int GetTabByID(int id) const;

Parametry

id
[v] ID karty.

Návratová hodnota

Nulový index karty, pokud je nalezen; -1, pokud se ID karty nenašlo.

Poznámky

ID karet se přidají automaticky, když se karty přidají do ovládacího prvku karty.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetTabFromHwnd

Načte index karty obsahující zadaný objekt HWND.

virtual int GetTabFromHwnd(HWND hwnd) const;

Parametry

Hwnd
[v] Popisovač okna.

Návratová hodnota

Nulový index karty v případě úspěchu; -1, pokud žádná karta neobsahuje hwnd.

CMFCBaseTabCtrl::GetTabFromPoint

Načte kartu, která obsahuje zadaný bod.

virtual int GetTabFromPoint(CPoint& pt) const;

Parametry

Pt
[v] Bod v souřadnicích klienta ovládacího prvku tab.

Návratová hodnota

Index karty, která obsahuje bod; -1, pokud žádná karta neobsahuje pt.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Parametry

[v] iTab

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetTabHicon

Vrátí HICON přidruženou k zadané kartě.

virtual HICON GetTabHicon(int iTab) const;

Parametry

iTab
[v] Index založený na nule pro kartu.

Návratová hodnota

HICON přidružený k popisku karty v případě úspěchu; NULL pokud neexistuje žádný HICON nebo pokud metoda selže.

CMFCBaseTabCtrl::GetTabIcon

Načte ikonu přidruženou k zadané kartě.

virtual UINT GetTabIcon(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

ID ikony pro zadanou kartu v případě úspěchu; -1, pokud je index neplatný.

Poznámky

CMFCBaseTabCtrl objekt ukládá ikony v interní CImageList objektu.

CMFCBaseTabCtrl::GetTabID

Načte ID karty určené indexem karty.

int GetTabID(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

ID karty nebo -1, pokud je tabulka iTab mimo rozsah.

CMFCBaseTabCtrl::GetTabLabel

Načte text popisku karty.

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

Parametry

iTab
[v] Index karty založený na nule.

strLabel
[ven] Odkaz na CString objekt. Tato metoda ukládá popisek karty v tomto parametru.

Návratová hodnota

TRUE v případě úspěchu; JINAK NEPRAVDA.

Poznámky

Tato metoda selže, pokud index iTab je neplatný.

Popisek karty nastavíte při vytváření karty pomocí CMFCBaseTabCtrl::AddTab. Popisek můžete po vytvoření také změnit pomocí metody CMFCBaseTabCtrl::SetTabLabel.

CMFCBaseTabCtrl::GetTabRect

Načte velikost a umístění zadané karty.

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

Parametry

iTab
[v] Index karty založený na nule.

Rect
[ven] Odkaz na CRect objekt. Tato metoda ukládá velikost a umístění tabulátoru v tomto parametru.

Návratová hodnota

TRUE v případě úspěchu; NEPRAVDA, pokud je index karty neplatný.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetTabsNum

Načte počet karet v ovládacím prvku karta.

virtual int GetTabsNum() const;

Návratová hodnota

Počet karet v ovládacím prvku karta

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Parametry

[v] Rect

Poznámky

CMFCBaseTabCtrl::GetTabTextColor

Načte barvu textu pro zadanou kartu.

virtual COLORREF GetTabTextColor(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

Parametr COLORREF, který označuje barvu textu zadané karty; -1, pokud je tabulka iTab mimo rozsah.

CMFCBaseTabCtrl::GetTabWnd

Vrátí ukazatel na podokno, které se nachází na zadané kartě.

virtual CWnd* GetTabWnd(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

Ukazatel na objekt CWnd, který se nachází na kartě, která určuje iTab. NULL, pokud je hodnota iTab neplatná.

Poznámky

Vrácený objekt je objekt, který aplikace přidala, když se nazývá CMFCBaseTabCtrl::AddTab nebo CMFCBaseTabCtrl::InsertTab.

Pokud objekt na kartě má obálku, tato metoda vrátí obálku objektu. Další informace o obálkách naleznete v tématu CMFCBaseTabCtrl::CreateWrapper. Pokud chcete získat přístup k ukazateli na přímý objekt bez obálky, použijte metodu CMFCBaseTabCtrl::GetTabWndNoWrapper.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Vrátí ukazatel na ovládací prvek, který se nachází na kartě, i když má ovládací prvek obálku.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

Ukazatel na objekt CWnd , který se nachází na zadané kartě; NULL, pokud je hodnota iTab neplatná.

Poznámky

Tato metoda načte přímý ukazatel na CWnd objekt, který jste přidali pomocí metody CMFCBaseTabCtrl::AddTab nebo CMFCBaseTabCtrl::InsertTab. GetTabWndNoWrapper načte ukazatel na přidaný CWndobjekt, i když architektura přidala obálku objektu. Další informace o obálkách a CMFCBaseTabCtrl třídy naleznete v tématu CMFCBaseTabCtrl::CreateWrapper.

Použijte metodu CMFCBaseTabCtrl::GetTabWnd , pokud nechcete ignorovat obálku třídy.

CMFCBaseTabCtrl::GetToolTipCtrl

Načte odkaz na kontorl popisku.

CToolTipCtrl& GetToolTipCtrl() const;

Návratová hodnota

Odkaz na ovládací prvek popisku

CMFCBaseTabCtrl::GetVisibleTabsNum

Načte počet aktuálně viditelných karet.

virtual int GetVisibleTabsNum() const;

Návratová hodnota

Počet viditelných karet

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Parametry

[v] iTab

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::HideSingleTab

Nastaví možnost skrytí karet pro ovládací prvek karta, pokud je k dispozici jedna viditelná karta.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parametry

bHide
[v] Logická hodnota, která určuje, jestli se mají povolit skrytí jednotlivých karet.

Poznámky

Pokud je aplikace nakonfigurovaná tak, aby skryla jednotlivé karty, architektura automaticky zobrazí karty při přidání druhé karty do ovládacího prvku karta.

CMFCBaseTabCtrl::InsertTab

Vloží kartu do ovládacího prvku karta.

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

Parametry

pNewWnd
[v] Ukazatel na okno, které tato metoda přidá jako novou kartu.

lpszTabLabel
[v] Řetězec, který obsahuje popisek nové karty.

nInsertAt
[v] Index založený na nule nové karty.

uiImageId
[v] ID obrázku ze seznamu obrázků. Ovládací prvek Karta používá tento obrázek jako ikonu nové karty.

bDetachable
[v] Logický parametr, který určuje, jestli je nová karta odpojená.

uiResTabLabel
[v] ID prostředku pro popisek.

Poznámky

Pokud objekt označený pNewWnd není odvozen z CDockablePane Třídy a pokud bDetachable parametr je TRUE, framework vytvoří speciální obálku pro novou kartu. Ve výchozím nastavení je obálka instance CDockablePaneAdapter Třída. K vytvoření jiné třídy obálky použijte CMFCBaseTabCtrl::SetDockingBarWrapperRTC metoda. Každá vlastní třída obálky musí být odvozena z CDockablePaneAdapter.

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Parametry

[v] iTab

Poznámky

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsAutoColor

Určuje, zda je ovládací prvek tab v režimu automatického barevného barvy.

BOOL IsAutoColor() const;

Návratová hodnota

TRUE, pokud je ovládací prvek karta v režimu automatického barevného ovládání; JINAK NEPRAVDA.

Poznámky

Režim automatického barvy můžete povolit nebo zakázat pomocí metody CMFCBaseTabCtrl::EnableAutoColor .

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsFlatFrame

Určuje, zda je rámeček ovládacího prvku tab vykreslený v plochém stylu nebo ve 3D stylu.

virtual BOOL IsFlatFrame() const;

Návratová hodnota

TRUE, pokud je rámeček ovládacího prvku tab vykreslen v plochém stylu; NEPRAVDA, pokud je rámeček vykreslený ve 3D stylu.

Poznámky

Pomocí CMFCTabCtrl::SetFlatFrame můžete změnit styl rámce ovládacího prvku tab.

Ovládací prvky tabulátoru, které používají styl aplikace Outlook, nelze vykreslit pomocí plochých snímků. To zahrnuje CMFCOutlookBarTabCtrl Třída a všechny třídy odvozené z této třídy.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsHideSingleTab

Určuje, zda ovládací prvek tab skryje popisek karty, pokud existuje pouze jedna karta.

virtual BOOL IsHideSingleTab() const;

Návratová hodnota

TRUE Pokud ovládací prvek tab skryje popisek karty, pokud má jednu kartu; jinak NEPRAVDA.

Poznámky

Použijte metodu CMFCBaseTabCtrl::HideSingleTab k povolení skrytí popisku karty, pokud je pouze jedna karta.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Parametry

[v] hIcon

[v] iIcon

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsInPlaceEdit

Určuje, jestli je ovládací prvek karty nakonfigurovaný tak, aby umožňoval uživateli dynamicky upravovat popisky karet.

virtual BOOL IsInPlaceEdit() const;

Návratová hodnota

Nenulové, pokud je povolená místní úprava; jinak 0.

Poznámky

Místní úpravy můžete povolit nebo zakázat voláním metody CMFCBaseTabCtrl::EnableInPlaceEdit.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsOneNoteStyle

Určuje, jestli se karty zobrazují ve stylu Microsoft OneNotu.

virtual BOOL IsOneNoteStyle() const;

Návratová hodnota

TRUE, pokud se karty zobrazují ve stylu Microsoft OneNotu; jinak NEPRAVDA.

Poznámky

Volání metody CMDIFrameWndEx::EnableMDITabs pro povolení stylu Aplikace Microsoft OneNote. Tento styl můžete také povolit při vytvoření instance TŘÍDY CMFCTabCtrl: jednoduše předejte styl STYLE_3D_ONENOTE metodě CMFCTabCtrl::Create.

Ve výchozím nastavení není styl Microsoft OneNotu podporován ve vlastní třídě odvozené z CMFCBaseTabCtrl Class. Podporuje se však ve CMFCTabCtrl třídě.

CMFCBaseTabCtrl::IsPtInTabArea

Určuje, zda je bod uvnitř oblasti tabulátoru.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Parametry

Bod
[v] Bod k otestování.

Návratová hodnota

Nenulové, pokud je bod v oblasti tabulátoru; 0 jinak.

Poznámky

CMFCBaseTabCtrl ClassV této metodě je čistá virtuální funkce a nemá žádnou implementaci. Pokud odvozujete třídu z CMFCBaseTabCtrl, musíte tuto funkci implementovat.

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::IsTabDetachable

Určuje, zda je karta odpojená.

virtual BOOL IsTabDetachable(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule, který chcete zkontrolovat.

Návratová hodnota

TRUE, pokud je karta odpojena; JINAK NEPRAVDA.

Poznámky

K odpojení tabulátoru použijte metodu CMFCBaseTabCtrl::EnableTabDetach.

CMFCBaseTabCtrl::IsTabiconOnly

Určuje, zda popisek karty obsahuje pouze ikony a žádný text.

virtual BOOL IsTabIconOnly(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule.

Návratová hodnota

TRUE, pokud popisek karty má pouze ikony; JINAK NEPRAVDA.

Poznámky

Chcete-li nastavit karty v aplikaci tak, aby zobrazovaly pouze ikony, zavolejte metodu CMFCBaseTabCtrl::SetTabIconOnly.

CMFCBaseTabCtrl::IsTabSwapEnabled

Určuje, zda ovládací prvek tab umožňuje uživateli změnit pozice tabulátoru pomocí myši.

BOOL IsTabSwapEnabled() const;

Návratová hodnota

Nenulové, pokud mohou být pozice tabulátoru změněny uživatelem; jinak 0.

Poznámky

Ve výchozím nastavení nemůžou uživatelé měnit pořadí karet v ovládacím prvku karta. K povolení této funkce použijte metodu CMFCBaseTabCtrl::EnableTabSwap .

CMFCBaseTabCtrl::IsTabVisible

Určuje, zda je zadaná karta viditelná.

virtual BOOL IsTabVisible(int iTab) const;

Parametry

iTab
[v] Index karty založený na nule, který chcete zkontrolovat.

Návratová hodnota

Nenulové, pokud je zadaná karta viditelná; jinak 0.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick určuje, zda jsou karty fokus, když uživatel klikne na popisek karty pomocí pravého tlačítka myši.

BOOL m_bActivateTabOnRightClick;

Poznámky

Výchozí hodnota tohoto datového členu je FALSE.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow určuje, zda architektura automaticky zničí objekty na kartách při odebrání karet.

BOOL m_bAutoDestroyWindow;

Poznámky

Ve výchozím nastavení má tento člen hodnotu FALSE.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Parametry

[v] nZdroj

[v] nDest

Poznámky

CMFCBaseTabCtrl::OnChangeTabs

Architektura volá tuto metodu, když se změní počet karet na ovládacím prvku karty.

virtual void OnChangeTabs();

Poznámky

Ve výchozím nastavení tato metoda nedělá nic. Tuto metodu přepište tak, aby se při změně počtu karet na ovládacím prvku karta spustil vlastní kód.

CMFCBaseTabCtrl::OnDrop

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

Parametry

[v] COleDataObject*

[v] DROPEFFECT

[v] CPoint

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::OnDragOver

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

Parametry

[v] COleDataObject*

[v] DWORD

[v] CPoint

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Poznámky

CMFCBaseTabCtrl::OnDragEnter

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

Parametry

[v] COleDataObject*

[v] DWORD

[v] CPoint

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Parametry

[v] Int

[v] CString&

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

[v] pMsg

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::RecalcLayout

Přepočítá vnitřní rozložení ovládacího prvku tab.

virtual void RecalcLayout() = 0;

Poznámky

CMFCBaseTabCtrl ClassV této metodě je čistě virtuální funkce. Pokud odvozujete třídu z CMFCBaseTabCtrl, musíte tuto funkci implementovat.

CMFCBaseTabCtrl::RemoveAllTabs

Odebere všechny karty z ovládacího prvku karta.

virtual void RemoveAllTabs();

Poznámky

Pokud CMFCBaseTabCtrl::m_bAutoDestroyWindow je PRAVDA, rozhraní odstraní všechny CWnd objekty připojené k odebranými kartami.

CMFCBaseTabCtrl::RemoveTab

Odebere kartu z ovládacího prvku karta.

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

Parametry

iTab
[v] Index karty založený na nule.

bRecalcLayout
[v] Logický parametr, který určuje, jestli se má přepočítat rozložení karty.

Návratová hodnota

TRUE Pokud metoda odebere kartu úspěšně; jinak NEPRAVDA.

Poznámky

Pokud CMFCBaseTabCtrl::m_bAutoDestroyWindow je PRAVDA, RemoveTab zničí CWnd objekt přidružený k zadané kartě.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::ResetImageList

Obnoví seznam obrázků pro instanci CMFCBaseTabCtrl Třídy.

void ResetImageList();

CMFCBaseTabCtrl::Serialize

virtual void Serialize(CArchive& ar);

Parametry

[v] ar

Poznámky

CMFCBaseTabCtrl::SetActiveTab

Aktivuje zadanou kartu.

virtual BOOL SetActiveTab(int iTab) = 0;

Parametry

iTab
[v] Index karty založený na nule. SetActiveTab nastaví kartu s tímto indexem jako aktivní.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

CMFCBaseTabCtrl ClassV této metodě je čistě virtuální funkce. Pokud odvozujete třídu z CMFCBaseTabCtrl, musíte tuto funkci implementovat.

CMFCBaseTabCtrl::SetActiveTabColor

Nastaví barvu pozadí aktivní karty.

virtual void SetActiveTabColor(COLORREF clr);

Parametry

Clr
[v] Určuje novou barvu pozadí.

Poznámky

Rozhraní získá výchozí barvu pozadí pro aktivní karty z GetSysColormetoda.

CMFCBaseTabCtrl::SetActiveTabTextColor

Nastaví barvu textu pro aktivní karty.

virtual void SetActiveTabTextColor(COLORREF clr);

Parametry

Clr
[v] Parametr COLORREF , který určuje novou barvu textu.

Poznámky

Ve výchozím nastavení rozhraní získá barvu textu z GetSysColor. Přepsat tuto výchozí barvu pomocí SetActiveTabTextColor metody.

CMFCBaseTabCtrl::SetAutoColors

Nastaví barvy ovládacího prvku karty, který architektura používá v automatickém barevném režimu.

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

Parametry

arColors
[v] Pole barev RGB.

Poznámky

Pokud zadáte vlastní pole barev, bude výchozí pole barev ignorováno. Pokud je parametr arColors prázdný, architektura se vrátí k výchozímu poli barev.

Chcete-li povolit režim automatického barvy, použijte CMFCBaseTabCtrl::EnableAutoColor metoda.

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Nastaví obálku třídy, která se používá pro všechny objekty, které nejsou odvozeny z CDockablePane Třídy.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Parametry

pRTC
[v] Informace o třídě modulu runtime pro novou třídu obálky.

Poznámky

Pomocí metod CMFCBaseTabCtrl::AddTabCtrl ::CmFCBaseTabCtrl::InsertTab přidáte karty do ovládacího prvku tabulátoru. Když přidáte kartu, musí být každý ovládací prvek na této kartě ukotvený. Všechny objekty, které nejsou odvozeny od CDockablePane , musí být zabaleny. AddTab a InsertTab vytvořte obálku pro tyto objekty. Výchozí třída obálky je CDockablePaneAdapter Třída. Metoda SetDockingBarWrapperRTC umožňuje změnit třídu, která se používá jako třída obálky. Třída obálky, kterou zadáte, musí být odvozena z CDockablePaneAdapter.

CMFCBaseTabCtrl::SetDrawNoPrefix

Povolí a zakáže zpracování znaků předpony v popiscích karet.

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

Parametry

bNoPrefix
[v] TRUE, pokud chcete zpracovat předpony znaků; jinak NEPRAVDA.

bRedraw
[v] TRUE, pokud chcete překreslit okno s kartami; jinak NEPRAVDA.

Poznámky

Znak předpony je měmónský znak, kterému předchází ampersand (&).

CMFCBaseTabCtrl::SetImageList

Nastaví seznam obrázků ikon pro ovládací prvek karta.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parametry

UIID
[v] ID rastrového prostředku. SetImageList načte seznam imagí z tohoto prostředku.

Cx
[v] Šířka každého obrázku v pixelech.

clrTransp
[v] Parametr COLORREF , který označuje průhlednou barvu obrázku.

hImageList
[v] Popisovač seznamu předem načtených imagí.

Návratová hodnota

Nenulové, pokud byla metoda úspěšná; 0 jinak.

Poznámky

Obrázky ze seznamu obrázků ikon se zobrazují spolu s popisky karty. Chcete-li zobrazit ikonu, je nutné zadat jeho index při volání CMFCBaseTabCtrl::AddTab.

SetImageList pokud byl ovládací prvek tab vytvořen s plochým stylem, selže. Pokud architektura nemůže načíst obrázek označený identifikátorem uiID, dojde také k selhání.

Tato metoda přepočítá výšku tabulátoru podle velikosti obrázku a textu.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Parametry

[v] Umístění

Poznámky

CMFCBaseTabCtrl::SetTabBkColor

Nastaví barvu pozadí pro zadanou kartu.

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

Parametry

iTab
[v] Index karty založený na nule.

Barev
[v] Barva, která se má nastavit.

Návratová hodnota

TRUE v případě úspěchu; JINAK NEPRAVDA.

CMFCBaseTabCtrl::SetTabBorderSize

Nastaví novou velikost ohraničení pro ovládací prvek tabulátoru.

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

Parametry

nTabBorderSize
[v] Nová velikost ohraničení v pixelech.

bRepaint
[v] Logický parametr, který označuje, zda architektura překresluje ovládací prvek.

CMFCBaseTabCtrl::SetTabHicon

Nastaví ikonu popisku karty.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Parametry

iTab
[v] Index karty založený na nule. Tato metoda změní ikonu pro tuto kartu.

hIcon
[v] Úchyt ikony.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

CMFCBaseTabCtrl::SetTabIcon

Nastaví ikonu karty.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Parametry

iTab
[v] Index karty založený na nule, který chcete aktualizovat.

uiIcon
[v] ID ikony pro novou ikonu. Toto ID odkazuje na interní objekt CImageList .

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

CMFCBaseTabCtrl::SetTabIconOnly

Umožňuje zobrazit jenom ikonu (bez textového popisku) na konkrétní kartě.

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

Parametry

iTab
[v] Index karty založený na nule, který chcete změnit.

bIconOnly
[v] Logický parametr, který určuje, zda se mají zobrazit pouze ikony.

bShowTooltipAlways
[v] Logický parametr, který určuje, jestli architektura zobrazuje popisky karet, které zobrazují jenom ikony.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

Ve výchozím nastavení ovládací prvek karty zobrazí ikonu a textový popisek pro každou kartu.

CMFCBaseTabCtrl::SetTabLabel

Nastaví text popisku karty.

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

Parametry

iTab
[v] Index karty založený na nule, který chcete aktualizovat.

strLabel
[v] Odkaz na řetězec, který obsahuje nový text popisku karty.

Návratová hodnota

Nenulové, pokud je úspěšné; 0 jinak.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Poznámky

CMFCBaseTabCtrl::SetTabsOrder

Uspořádá karty v zadaném pořadí.

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

Parametry

ArOrder
[v] Pole indexů založených na nule, které definují nové pořadí ovládacích prvků.

Návratová hodnota

TRUE v případě úspěchu; V opačném případě selžou.

Poznámky

Velikost pole arOrder musí být rovna počtu karet v ovládacím prvku tab.

CMFCBaseTabCtrl::SetTabTextColor

Nastaví barvu textu pro konkrétní kartu.

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

Parametry

iTab
[v] Index karty založený na nule.

Barev
[v] Parametr COLORREF , který označuje novou barvu textu.

Návratová hodnota

Nenulové, pokud je úspěšné; 0 jinak.

CMFCBaseTabCtrl::ShowTab

Zobrazí nebo skryje zadanou kartu.

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

Parametry

iTab
[v] Index karty, která ShowTab se zobrazí nebo skryje.

BShow
[v] Logický parametr, který označuje, jestli se má karta zobrazit.

bRecalcLayout
[v] Logický parametr, který označuje, jestli se má rozložení okna okamžitě přepočítat.

bActivate
[v] Logický parametr, který označuje, zda má být vybrána karta určená parametrem iTab.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Parametr bActivate platí pouze v případě, že bShow je TRUE. Pokud je funkce bActivate true a pokud ShowTab je úspěšná, ShowTab odešle zprávu AFX_WM_CHANGE_ACTIVE_TAB nadřazené sadě okna karty.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Parametry

[v] iTab

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Parametry

[v] nFisrtTabID

[v] nSecondTabID

Poznámky

Viz také

Graf hierarchie
Třídy
CMFCTabCtrl – třída
CMFCOutlookBarTabCtrl – třída

Sdílet prostřednictvím

CMFCBaseTabCtrl – třída

Syntaxe

Členové

Veřejné metody

Chráněné metody

Datové členy

Poznámky

Tipy přizpůsobení

Hierarchie dědičnosti

Požadavky

CMFCBaseTabCtrl::AddIcon

Parametry

Poznámky

CMFCBaseTabCtrl::AddTab

Parametry

Poznámky

CMFCBaseTabCtrl::ApplyRestoredTabInfo

Parametry

Poznámky

CMFCBaseTabCtrl::AutoDestroyWindow

Parametry

Poznámky

CMFCBaseTabCtrl::CalcRectEdit

Parametry

Poznámky

CMFCBaseTabCtrl::CleanUp

Poznámky

CMFCBaseTabCtrl::ClearImageList

Poznámky

CMFCBaseTabCtrl::CreateWrapper

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::D etachTab

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::EnableActivateLastActive

Parametry

Poznámky

CMFCBaseTabCtrl::EnableAutoColor

Parametry

Poznámky

CMFCBaseTabCtrl::EnableCustomTool Tipy

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::EnableInPlaceEdit

Parametry

Poznámky

CMFCBaseTabCtrl::EnableTabDetach

Parametry

Návratová hodnota

CMFCBaseTabCtrl::EnableTabSwap

Parametry

Poznámky

CMFCBaseTabCtrl::EnsureVisible

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::EnterDragMode

Poznámky

CMFCBaseTabCtrl::FindTargetWnd

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::FireChangeActiveTab

Parametry

Poznámky

CMFCBaseTabCtrl::FireChangingActiveTab

Parametry

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetActiveTab

Návratová hodnota

CMFCBaseTabCtrl::GetActiveTabColor

Návratová hodnota

Poznámky

CMFCBaseTabCtrl::GetActiveTabTextColor