Sdílet prostřednictvím

CMFCTabCtrl Třída

  • Článek

Třída CMFCTabCtrl poskytuje funkce pro ovládací prvek karta. Ovládací prvek tab zobrazuje dokovatelné okno s plochými nebo trojrozměrnými kartami v horní nebo dolní části. Karty můžou zobrazovat text a obrázek a můžou změnit barvu, když jsou aktivní.

Syntaxe

class CMFCTabCtrl : public CMFCBaseTabCtrl

Členové

Veřejné konstruktory

Název Popis
CMFCTabCtrl::CMFCTabCtrl Výchozí konstruktor.
CMFCTabCtrl::~CMFCTabCtrl Destruktor.

Veřejné metody

Název Popis
CMFCTabCtrl::ActivateMDITab Zobrazí zadanou kartu aktuálního ovládacího prvku tab a nastaví fokus na dané kartě.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Určuje, zda má architektura změnit velikost klientské oblasti všech oken ovládacích prvků karet, když se změní prvek uživatelského rozhraní ovládacího prvku karty.
CMFCTabCtrl::CalcRectEdit Odfoukne velikost zadané oblasti tabulátoru. (Přepsání CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create Vytvoří ovládací prvek tab a připojí ho k objektu CMFCTabCtrl .
CMFCTabCtrl::CreateObject Používá se architekturou k vytvoření dynamické instance tohoto typu třídy.
CMFCTabCtrl::EnableActiveTabCloseButton Zobrazí nebo skryje tlačítko Zavřít ( X) na aktivní kartě.
CMFCTabCtrl::EnableInPlaceEdit Povolí nebo zakáže upravitelné popisky karet. (Přepsání CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Nahradí dvě tlačítka, která se posunou karty oken tlačítkem, které otevře nabídku oken s kartami.
CMFCTabCtrl::EnsureVisible Zajistí, aby byla karta viditelná.
CMFCTabCtrl::GetDocumentIcon Načte symbol přidružený k kartě v místní nabídce oken s kartami.
CMFCTabCtrl::GetFirstVisibleTabNum Načte index první karty, která je viditelná v ovládacím prvku aktuální karty.
CMFCTabCtrl::GetResizeMode Načte hodnotu, která určuje, jak lze změnit velikost ovládacího prvku aktuální karty.
CMFCTabCtrl::GetScrollBar Načte ukazatel na objekt posuvníku přidružený k ovládacímu prvku tab.
CMFCTabCtrl::GetTabArea Načte ohraničující obdélník oblasti popisku tabulátoru v horní nebo dolní části ovládacího prvku tab. (Přepsání CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Načte kartu, která obsahuje zadaný bod. (Přepsání CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Načte maximální šířku karty.
CMFCTabCtrl::GetTabsHeight Načte výšku oblasti karty aktuálního ovládacího prvku tab.
CMFCTabCtrl::GetTabsRect Načte obdélník, který ohraničuje oblast tabulátoru aktuálního ovládacího prvku tab. (Přepsání CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Používá se architekturou k získání ukazatele na CRuntimeClass objekt, který je přidružen k tomuto typu třídy.
CMFCTabCtrl::GetWndArea Načte hranici klientské oblasti aktuálního ovládacího prvku tab.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Skryje vodorovný posuvník aktivního okna ( pokud existuje).
CMFCTabCtrl::HideInactiveWindow Určuje, zda má architektura zobrazovat neaktivní okna ovládacích prvků tabulátoru.
CMFCTabCtrl::HideNoTabs Povolí nebo zakáže kreslení oblasti tabulátoru, pokud nejsou žádné viditelné karty.
CMFCTabCtrl::HideSingleTab Povolí nebo zakáže kreslení tabulátoru, pokud je k dispozici jedno okno s kartami. (Přepsání CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Určuje, jestli je aktuální karta ovládacího prvku karta aktivní ve skupině karet rozhraní více dokumentů.
CMFCTabCtrl::IsActiveTabBoldFont Určuje, zda je text aktivní karty zobrazen pomocí tučného písma.
CMFCTabCtrl::IsActiveTabCloseButton Určuje, zda je tlačítko Zavřít ( X) zobrazeno na aktivní kartě nebo v pravém horním rohu oblasti karty.
CMFCTabCtrl::IsDrawFrame Určuje, jestli okno s kartami nakreslí obdélník rámečku kolem vložených podoken.
CMFCTabCtrl::IsFlatFrame Určuje, jestli je rámeček kolem oblasti tabulátoru plochý nebo 3D.
CMFCTabCtrl::IsFlatTab Určuje, zda je vzhled karet v aktuálním ovládacím prvku tabulátoru plochý nebo ne.
CMFCTabCtrl::IsLeftRightRounded Určuje, jestli je vzhled levé a pravé strany karty v ovládacím prvku aktuální karty zaokrouhlený.
CMFCTabCtrl::IsMDITabGroup Určuje, zda je aktuální ovládací prvek tabulátoru obsažen v klientské oblasti okna rozhraní s více dokumenty.
CMFCTabCtrl::IsOneNoteStyle Určuje, jestli je aktuální ovládací prvek karty zobrazen ve stylu Microsoft OneNotu.
CMFCTabCtrl::IsPtInTabArea Určuje, zda je bod uvnitř oblasti tabulátoru. (Přepsání CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Určuje, zda má ovládací prvek aktuální karty posuvník, který může posunout jeho karty jako skupinu.
CMFCTabCtrl::IsTabDocumentsMenu Určuje, jestli ovládací prvek karty zobrazuje tlačítka pro posouvání nebo tlačítko, které zobrazuje nabídku oken s kartami.
CMFCTabCtrl::IsVS2005Style Označuje, zda jsou karty zobrazeny ve stylu sady Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Určuje vzhled karet v ovládacím prvku aktuální karty.
CMFCTabCtrl::MoveTab Přesune kartu na jinou pozici tabulátoru. (Přepsání CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Volá se rozhraním při prvním přetažení kurzoru do ovládacího okna ovládacích prvků karty.
CMFCTabCtrl::OnDragOver Volá se rozhraním během operace přetažení, když se myš přesune přes cílové okno. (Přepsání CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Zobrazí místní nabídku oken s kartami, počká, dokud uživatel nevybere kartu a vybranou kartu nastaví jako aktivní.
CMFCTabCtrl::PreTranslateMessage Přeloží zprávy oken před odesláním TranslateMessage do funkcí systému Windows a DispatchMessage Windows. (Přepsání CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Přepočítá vnitřní rozložení ovládacího prvku tab. (Přepsání CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Nastaví aktuální kartu ovládacího prvku karta jako aktivní kartu ve skupině karet rozhraní více dokumentů.
CMFCTabCtrl::SetActiveTab Aktivuje kartu. (Přepsání CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Povolí nebo zakáže použití tučného písma na aktivních kartách.
CMFCTabCtrl::SetDrawFrame Povolí nebo zakáže kreslení obdélníku rámečku kolem vloženého pruhu.
CMFCTabCtrl::SetFlatFrame Určuje, jestli se má kolem oblasti tabulátoru nakreslit plochý nebo 3D rámec.
CMFCTabCtrl::SetImageList Určuje seznam obrázků. (Přepsání CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Určuje, jak lze změnit velikost aktuálního ovládacího prvku tabulátoru a pak ovládací prvek znovu zobrazit.
CMFCTabCtrl::SetTabMaxWidth Určuje maximální šířku tabulátoru v okně s kartami.
CMFCTabCtrl::StopResize Ukončí aktuální operaci změny velikosti na ovládacím prvku karta.
CMFCTabCtrl::SwapTabs Prohodí dvojici karet. (Přepsání CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Nakreslí vodorovný posuvník na ovládací prvek tabulátoru, který zobrazuje ploché tabulátory.

Datové členy

Název Popis
CMFCTabCtrl::m_bEnableActivate Zabrání aktivnímu zobrazení ztrátě fokusu při vložení a povolení nové karty.

Poznámky

Třída CMFCTabCtrl podporuje:

  • Styly ovládacích prvků tabulátoru, které obsahují 3D, ploché a ploché se sdíleným vodorovným posuvníkem.

  • Karty umístěné v horní nebo dolní části okna

  • Karty, které zobrazují text, obrázky nebo text a obrázky

  • Karty, které změní barvu, když je karta aktivní.

  • Změna velikosti ohraničení pro upravitelné karty

  • Odpojitelná okna s kartami

Třídu CMFCTabCtrl lze použít s dialogovým oknem, ale je určena pro aplikace, které používají dokovací ovládací panely, jako je Microsoft Excel a Visual Studio. Další informace naleznete v tématu CDockablePane Třída.

Pomocí následujícího postupu přidejte dokovací ovládací prvek karty pro změnu velikosti v aplikaci:

  1. Vytvořte instanci CTabbedPane třídy.

  2. Zavolejte CDockablePane::Create.

  3. Použijte CBaseTabbedPane::AddTab nebo CMFCBaseTabCtrl::InsertTab přidejte nové karty.

  4. Volejte CBasePane::EnableDocking tak, aby aktuální ovládací prvek dokovací karty mohl ukotvit v okně hlavního rámce.

  5. Volání CFrameWndEx::DockPane pro ukotvení okna s kartami v hlavním rámečku

Příklad vytvoření okna s kartami jako řídicího panelu ukotvení najdete v tématu CTabbedPane Třída. Chcete-li použít CMFCTabCtrl jako ovládací prvek bez dokování, vytvořte CMFCTabCtrl objekt a pak zavolejte CMFCTabCtrl::Create.

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Příklad

Následující příklad ukazuje použití různých metod ve CMFCTabCtrl třídě ke konfiguraci objektu CMFCTabCtrl . Příklad vysvětluje, jak přidat kartu, zobrazit tlačítko Zavřít na aktivní kartě, povolit upravitelné popisky karet a zobrazit místní nabídku popisků oken s kartami. Tento příklad je součástí ukázky kolekce stavů.

CMFCTabCtrl m_wndTabs;

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

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

Požadavky

Záhlaví: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Zobrazí zadanou kartu aktuálního ovládacího prvku tab a nastaví fokus na dané kartě.

void ActivateMDITab(int nTab = -1);

Parametry

nTab
[v] Index karty založený na nule, který se má zobrazit, nebo -1 k určení aktuálně aktivní karty.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Další podrobnosti najdete ve zdrojovém kódu umístěném mfc ve složce instalace sady Visual Studio. Například %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Návratová hodnota

Vždy hodnota TRUE.

Poznámky

CMFCTabCtrl::AutoSizeWindow

Určuje, zda má architektura změnit velikost klientské oblasti všech oken ovládacích prvků karet, když se změní prvek uživatelského rozhraní ovládacího prvku karty.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parametry

bAutoSize
[v] TRUE automatické změny velikosti ovládacích oken ovládacích prvků karty; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::Create

Vytvoří ovládací prvek tab a připojí ho k objektu CMFCTabCtrl .

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

Parametry

style
[v] Styl ovládacího prvku karta. Další informace naleznete v tématu Poznámky.

rect
[v] Obdélník, který ohraničuje ovládací prvek tabulátoru.

pParentWnd
[v] Ukazatel na nadřazené okno. Nesmí být NULL.

nID
[v] ID ovládacího prvku karta.

location
[v] Umístění karet. Výchozí hodnota je LOCATION_BOTTOM. Další informace naleznete v tématu Poznámky.

bCloseBtn
[v] TRUE zobrazení tlačítka zavřít na kartě; v opačném případě . FALSE Výchozí hodnota je FALSE.

Návratová hodnota

V případě úspěchu nabývá hodnoty TRUE, v opačném případě hodnoty FALSE.

Poznámky

Následující tabulka popisuje hodnoty, které můžete zadat pro style parametr.

Styl Popis
STYLE_3D Vytvoří ovládací prvek tabulátoru s trojrozměrným vzhledem.
STYLE_FLAT Vytvoří ovládací prvek tabulátoru s plochými kartami.
STYLE_FLAT_SHARED_HORZ_SCROLL Vytvoří ovládací prvek tabulátoru s plochými kartami a posuvníkem, který se může posouvat, pokud je vystřihne nadřazené okno.
STYLE_3D_ONENOTE Vytvoří ovládací prvek tab ve stylu Microsoft OneNotu.
STYLE_3D_VS2005 Vytvoří ovládací prvek tab ve stylu sady Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Vytvoří ovládací prvek tabulátoru se zaoblenými kartami ve stylu sady Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Vytvoří ovládací prvek tabulátoru se zaoblenými kartami a tlačítky pro posouvání ve stylu sady Microsoft Visual Studio 2005.

Následující tabulka uvádí hodnoty, které můžete pro location parametr zadat.

Umístění Popis
LOCATION_BOTTOM Karty se nacházejí v dolní části ovládacího prvku tab.
LOCATION_TOP Karty se nacházejí v horní části ovládacího prvku karta.

Příklad

Následující příklad ukazuje, jak použít metodu Create CMFCTabCtrl ve třídě. Tento příklad je součástí ukázky kolekce stavů.

CMFCTabCtrl m_wndTabs;

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

CMFCTabCtrl::CalcRectEdit

Odfoukne velikost zadané oblasti tabulátoru.

virtual void CalcRectEdit(CRect& rectEdit);

Parametry

rectEdit
[v] Obdélník, který určuje oblast tabulátoru.

Poznámky

Tato metoda se volá při změně popisku karty. Tato metoda odfoukne levou a pravou stranu zadaného obdélníku o jednu polovinu aktuální výšky tabulátoru a odfoukne horní a dolní o jednu jednotku.

CMFCTabCtrl::EnableActiveTabCloseButton

Zobrazí nebo skryje tlačítko Zavřít ( X) na aktivní kartě.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parametry

bEnable
[v] TRUE pro zobrazení tlačítka Zavřít na aktivní kartě. FALSE Pokud chcete zobrazit tlačítko Zavřít v pravém horním rohu oblasti karty. Výchozí hodnota je TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Povolí nebo zakáže upravitelné popisky karet.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametry

bEnable
[v] TRUE povolit upravitelné popisky karet; FALSE zakázat upravitelné popisky karet.

Poznámky

CMFCTabCtrl::EnableTabDocumentsMenu

Přepíná mezi uživatelským rozhraním, které používá dvě tlačítka k posouvání karet oken a rozhraní, které zobrazuje místní nabídku oken s kartami.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parametry

bEnable
[v] TRUE zobrazení místní nabídky popisků oken s kartami; FALSE pro zobrazení tlačítek vpřed a vzad. Výchozí hodnota je TRUE.

Poznámky

Když uživatel klikne na popisek karty, architektura zobrazí odpovídající okno s kartami. Pokud je popisek karty viditelný, otevře se okno s kartami beze změny jeho pozice. Pokud uživatel vybere dokument z místní nabídky a odpovídající okno s kartami je mimo obrazovku, okno s kartami se stane první kartou.

CMFCTabCtrl::EnsureVisible

Zajistí, aby byla karta viditelná.

virtual BOOL EnsureVisible(int iTab);

Parametry

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

Návratová hodnota

TRUE pokud je úspěšný; FALSE pokud je index parametru iTab neplatný.

Poznámky

Pomocí této metody můžete zaručit, že je zadaná karta viditelná. Ovládací prvek tab se v případě potřeby posune.

CMFCTabCtrl::GetDocumentIcon

Načte obrázek přidružený k kartě v místní nabídce oken s kartami.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parametry

nCmdID
[v] ID příkazu karty v místní nabídce oken s kartami.

Návratová hodnota

Úchyt rastrového obrázku.

CMFCTabCtrl::GetFirstVisibleTabNum

Načte index první karty, která je viditelná v ovládacím prvku aktuální karty.

virtual int GetFirstVisibleTabNum() const;

Návratová hodnota

Nulový index karty v ovládacím prvku karta.

Poznámky

Tuto metodu použijte pouze v případě, že je ovládací prvek tab zobrazen ve stylu Microsoft OneNotu. Použijte metodu CMFCTabCtrl::IsOneNoteStyle k určení stylu.

CMFCTabCtrl::GetResizeMode

Načte hodnotu, která určuje, jak lze změnit velikost ovládacího prvku aktuální karty.

ResizeMode GetResizeMode() const;

Návratová hodnota

Jedna z hodnot výčtu CMFCTabCtrl::ResizeMode , která určuje, jak lze změnit velikost ovládacího prvku tab. Seznam možných hodnot naleznete v části Poznámky metody CMFCTabCtrl::SetResizeMode .

CMFCTabCtrl::GetScrollBar

Načte ukazatel na objekt posuvníku přidružený k ovládacímu prvku tab.

CScrollBar* GetScrollBar();

Návratová hodnota

Ukazatel na objekt posuvníku nebo NULL pokud ovládací prvek tab nebyl vytvořen pomocí STYLE_FLAT_SHARED_HORZ_SCROLL stylu.

Poznámky

Tuto metodu použijte pro přístup k vloženým posuvníkům ovládacího prvku tab. Objekt posuvníku se vytvoří pouze v případech, kdy má STYLE_FLAT_SHARED_HORZ_SCROLL ovládací prvek tab styl.

CMFCTabCtrl::GetTabArea

Načte ohraničující obdélník oblasti popisku tabulátoru v horní nebo dolní části ovládacího prvku tab.

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

Parametry

rectTabAreaTop
[ven] Když tato metoda vrátí, tento odkaz obsahuje obdélník, který ohraničuje oblast popisku horní karty. Obdélník je v souřadnicích klienta. Tento odkaz je prázdný, pokud v horní části ovládacího prvku tab neexistuje žádná oblast popisku tabulátoru.

rectTabAreaBottom
[ven] Když tato metoda vrátí, tento odkaz obsahuje obdélník, který ohraničuje oblast popisku dolní karty. Obdélník je v souřadnicích klienta. Tento odkaz je prázdný, pokud v dolní části ovládacího prvku tab neexistuje žádná oblast popisku tabulátoru.

Poznámky

Tuto metodu použijte k určení velikosti a umístění oblasti karty v okně s kartami.

CMFCTabCtrl::GetTabMaxWidth

Načte maximální šířku karty.

int GetTabMaxWidth() const;

Návratová hodnota

Maximální šířka tabulátoru v pixelech Pokud je návratová hodnota 0, šířka tabulátoru je neomezená.

Poznámky

K nastavení maximální šířky tabulátoru použijte CMFCTabCtrl::SetTabMaxWidth metoda.

CMFCTabCtrl::GetTabsHeight

Načte výšku oblasti karty aktuálního ovládacího prvku tab.

virtual int GetTabsHeight() const;

Návratová hodnota

Výška oblasti tabulátoru, pokud je nějaká karta viditelná, nebo nula, pokud není žádná karta viditelná.

CMFCTabCtrl::GetTabsRect

Načte obdélník, který ohraničuje oblast tabulátoru aktuálního ovládacího prvku tab.

virtual void GetTabsRect(CRect& rect) const;

Parametry

rect
[ven] Když tato metoda vrátí, rect parametr obsahuje obdélník, který ohraničuje oblast tabulátoru.

CMFCTabCtrl::GetWndArea

Načte hranici klientské oblasti aktuálního ovládacího prvku tab.

void GetWndArea(CRect& rect) const;

Parametry

rect
[in, out] Pokud tato metoda vrátí, tento parametr obsahuje obdélník, který ohraničuje aktuální ovládací prvek tabulátoru.

Poznámky

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Skryje vodorovný posuvník (pokud existuje) v aktivním okně.

void HideActiveWindowHorzScrollBar();

Poznámky

Tuto metodu použijte, pokud chcete zabránit blikajícímu ovládacímu prvku tab, když uživatel přepne mezi stránkami ovládacího prvku tab.

CMFCTabCtrl::HideInactiveWindow

Určuje, jestli architektura zobrazuje neaktivní okna ovládacích prvků tabulátoru.

void HideInactiveWindow(BOOL bHide = TRUE);

Parametry

bHide
[v] TRUE nezobrazuje neaktivní okno; FALSE pro zobrazení neaktivního okna. Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::HideNoTabs

Povolí nebo zakáže kreslení oblasti karty, pokud nejsou žádné viditelné karty.

void HideNoTabs(BOOL bHide=TRUE);

Parametry

bHide
[v] TRUE povolení kreslení oblasti tabulátoru; FALSE chcete-li zakázat kreslení. Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::HideSingleTab

Povolí nebo zakáže kreslení tabulátoru, pokud je k dispozici jedno okno s kartami.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parametry

bHide
[v] TRUE pokud nechcete kreslit kartu pro jedno okno s kartami; FALSE a nakreslete jednu kartu. Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::IsActiveInMDITabGroup

Určuje, jestli je aktuální karta ovládacího prvku karta aktivní ve skupině karet rozhraní více dokumentů.

BOOL IsActiveInMDITabGroup() const;

Návratová hodnota

TRUEpokud aktuální karta ovládacího prvku karta je aktivní karta ve skupině karet MDI; v opačném případě . FALSE

Poznámky

Můžete uspořádat více oken dokumentů do svislých nebo vodorovných skupin karet a snadno prohazovat dokumenty z jedné skupiny karet do druhé.

CMFCTabCtrl::IsActiveTabBoldFont

Určuje, zda je text aktivní karty zobrazen pomocí tučného písma.

BOOL IsActiveTabBoldFont() const;

Návratová hodnota

TRUEpokud je aktivní karta zobrazena pomocí tučného písma; v opačném případě . FALSE

Poznámky

CMFCTabCtrl::SetActiveTabBoldFont Pomocí metody můžete změnit písmo aktivní karty.

CMFCTabCtrl::IsActiveTabCloseButton

Určuje, zda je tlačítko Zavřít ( X) zobrazeno na aktivní kartě nebo v pravém horním rohu oblasti karty.

virtual BOOL IsActiveTabCloseButton() const;

Návratová hodnota

TRUEpokud je tlačítko Zavřít zobrazeno na aktivní kartě; FALSE pokud je tlačítko Zavřít zobrazeno v pravém horním rohu oblasti karty.

Poznámky

CMFCTabCtrl::IsDrawFrame

Určuje, jestli okno s kartami nakreslí obdélník rámečku kolem vložených podoken.

BOOL IsDrawFrame() const;

Návratová hodnota

TRUEje-li nakreslen obdélník rámečku; v opačném případě . FALSE

Poznámky

Tuto metodu CMFCTabCtrl::SetDrawFrame použijte k povolení nebo zakázání kreslení obdélníku rámečku.

CMFCTabCtrl::IsFlatFrame

Určuje, jestli je rámeček kolem oblasti tabulátoru plochý nebo 3D.

BOOL IsFlatFrame() const;

Návratová hodnota

TRUE pokud je rámeček kolem oblasti tabulátoru plochý; FALSE pokud je rámec trojrozměrný.

Poznámky

CMFCTabCtrl::SetFlatFrame Pomocí metody můžete změnit způsob vykreslení rámu.

CMFCTabCtrl::IsFlatTab

Určuje, zda je vzhled karet v aktuálním ovládacím prvku tabulátoru plochý nebo ne.

virtual BOOL IsFlatTab() const;

Návratová hodnota

TRUEpokud je vzhled karet v aktuálním ovládacím prvku tabulátoru plochý; v opačném případě . FALSE

CMFCTabCtrl::IsLeftRightRounded

Určuje, jestli je vzhled levé a pravé strany karty v ovládacím prvku aktuální karty zaokrouhlený.

virtual BOOL IsLeftRightRounded() const;

Návratová hodnota

TRUEpokud jsou strany každé karty zaokrouhleny; v opačném případě . FALSE

CMFCTabCtrl::IsMDITabGroup

Určuje, zda je aktuální ovládací prvek tabulátoru obsažen v klientské oblasti okna rozhraní s více dokumenty.

virtual BOOL IsMDITabGroup() const;

Návratová hodnota

TRUEpokud je aktuální ovládací prvek karty v okně klientské oblasti MDI; v opačném případě . FALSE

CMFCTabCtrl::IsOneNoteStyle

Určuje, jestli je aktuální ovládací prvek karty zobrazen ve stylu Microsoft OneNotu.

virtual BOOL IsOneNoteStyle() const;

Návratová hodnota

TRUEpokud je ovládací prvek karta zobrazen ve stylu Microsoft OneNotu; v opačném případě . FALSE

CMFCTabCtrl::IsSharedScroll

Určuje, zda má ovládací prvek aktuální karty posuvník, který může posunout jeho karty jako skupinu.

BOOL IsSharedScroll() const;

Návratová hodnota

TRUEpokud ovládací prvek tab má sdílený posuvník; v opačném případě . FALSE

Poznámky

Tato metoda vrátíTRUE, pokud style je STYLE_FLAT_SHARED_HORZ_SCROLLparametr CMFCTabCtrl::Create metody .

CMFCTabCtrl::IsTabDocumentsMenu

Určuje, jestli ovládací prvek karty zobrazuje tlačítka pro posouvání nebo tlačítko, které zobrazuje nabídku oken s kartami.

BOOL IsTabDocumentsMenu() const;

Návratová hodnota

TRUE pokud jsou okna s kartami posunována pomocí místní nabídky popisků oken s kartami; FALSE pokud jsou okna s kartami posunutá pomocí tlačítek vpřed a vzad.

Poznámky

Metodu CMFCTabCtrl::EnableTabDocumentsMenu použijte k určení metody posouvání oken s kartami.

CMFCTabCtrl::IsVS2005Style

Označuje, zda jsou karty kresleny pomocí stylu sady Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Návratová hodnota

TRUEpokud jsou karty kresleny pomocí stylu sady Visual Studio 2005; v opačném případě . FALSE

Poznámky

style Pomocí parametru CMFCTabCtrl::Create metody určete, jak se karty vykreslují.

CMFCTabCtrl::m_bEnableActivate

Zabrání aktivnímu zobrazení ztrátě fokusu při vložení a povolení nové karty.

static BOOL m_bEnableActivate;

Poznámky

Fokus je obvykle pořízen novým oknem s kartami, když se karta vloží a aktivuje. Nastavte proměnnou člena CMFCTabCtrl::m_bEnableActivate tak, aby FALSE se zachoval původní fokus. Výchozí hodnota je TRUE.

CMFCTabCtrl::ModifyTabStyle

Určuje vzhled karet v ovládacím prvku aktuální karty.

BOOL ModifyTabStyle(Style style);

Parametry

style
[v] Jedna z hodnot výčtu, která určuje vzhled ovládacího prvku tab. Další informace najdete v tabulce v poznámkách.

Návratová hodnota

Vždy hodnota TRUE.

Poznámky

Hodnota parametru style může být jedním z následujících CMFCTabCtrl::Style výčtů.

Název Popis
STYLE_3D Zobrazí trojrozměrné obdélníkové ouška s kulatými rohy.
STYLE_3D_ONENOTE Zobrazí trojrozměrné ouška, které mají jednu svislou stranu a jednu nakláněnou stranu a mají zaoblené rohy.
STYLE_3D_ROUNDED Zobrazí trojrozměrné tabulátory se zkosenými stranami a zaoblenými rohy.
STYLE_3D_ROUNDED_SCROLL Zobrazí trojrozměrné tabulátory se zkosenými stranami a zaoblenými rohy. Pokud je více karet, než je možné zobrazit najednou, architektura zobrazí šipku rozevíracího seznamu a nabídku karet, které se mají aktivovat.
STYLE_3D_SCROLLED Zobrazí trojrozměrné obdélníkové ouška. Pokud je více karet, než je možné zobrazit najednou, architektura zobrazí šipku rozevíracího seznamu a nabídku karet, které se mají aktivovat.
STYLE_3D_VS2005 Zobrazí trojrozměrné zaoblené tabulátory, které mají jednu zkosenou stranu a jednu svislou stranu.
STYLE_FLAT Zobrazí dvojrozměrné tabulátory, které mají zkosené levé a pravé strany.
STYLE_FLAT_SHARED_HORZ_SCROLL Zobrazí dvojrozměrné karty. Pokud je na koncích oblasti karty více karet, než je možné zobrazit současně, architektura zobrazí šipky posouvání na koncích oblasti karty.

CMFCTabCtrl::OnDragEnter

Volá se rozhraním během operace přetažení, když kurzor poprvé přejde do okna aktuálního ovládacího prvku tab.

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

Parametry

pDataObject
[v] Odkazuje na datový objekt, který obsahuje data, která uživatel přetáhne.

dwKeyState
[v] Obsahuje stav modifikačních klíčů. Tento parametr je bitové kombinace "or" (|) následujících hodnot: MK_CONTROL, , MK_SHIFTMK_ALT, MK_LBUTTON, , MK_MBUTTONa MK_RBUTTON. Další informace naleznete v části Parametry zprávy o vstupu myši.

point
[v] Obsahuje aktuální umístění kurzoru v souřadnicích klienta.

Návratová hodnota

Vždy DROPEFFECT_NONE– to znamená, že cíl vyřazení nemůže přijmout data.

Poznámky

Tuto metodu použijte k podpoře operace přetažení myší. Tuto metodu přepište tak, aby implementovaly vlastní chování.

Ve výchozím nastavení tato metoda volá CMFCTabCtrl::OnDragOverpouze , což vždy vrací DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Volá se rozhraním během operace přetažení, když se myš přesune přes cílové okno.

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

Parametry

pDataObject
[v] Ukazatel myši na COleDataObject objekt, který je přetažen přes cíl přetažení.

dwKeyState
[v] Stav modifikačních kláves, což je bitové kombinace "or" (|) of MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONa MK_RBUTTON. Další informace naleznete v části "Parametry zprávy" o vstupu myši.

point
[v] Aktuální pozice myši.

Návratová hodnota

Vždy hodnota DROPEFFECT_NONE.

Poznámky

Tuto metodu přepište vlastní implementací. Další informace najdete v CView::OnDragOver metodě.

CMFCTabCtrl::OnShowTabDocumentsMenu

Zobrazí místní nabídku oken s kartami, počká, dokud uživatel nevybere kartu a vybranou kartu nastaví jako aktivní.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parametry

point
[v] Souřadnice místa, kde se má zobrazit místní nabídka

Poznámky

CMFCTabCtrl::SetActiveInMDITabGroup

Nastaví aktuální kartu ovládacího prvku karta jako aktivní kartu ve skupině karet rozhraní více dokumentů.

void SetActiveInMDITabGroup(BOOL bActive);

Parametry

bActive
[v] TRUE chcete-li nastavit aktuální kartu jako aktivní kartu; FALSE aby byla aktuální karta neaktivní.

Poznámky

Můžete uspořádat více oken dokumentů do svislých nebo vodorovných skupin karet a snadno prohazovat dokumenty z jedné skupiny karet do druhé.

CMFCTabCtrl::SetActiveTab

Aktivuje kartu.

virtual BOOL SetActiveTab(int iTab);

Parametry

iTab
[v] Určuje index založený na nule karty, který se má aktivovat.

Návratová hodnota

TRUE pokud byla zadaná karta aktivní; FALSE pokud je zadaná iTab hodnota parametru neplatná.

Poznámky

Tím se oznámení odešle AFX_WM_CHANGE_ACTIVE_TAB do nadřazeného okna a rámce nadřazeného ovládacího prvku tab.

Metoda SetActiveTab automaticky volá metodu CMFCTabCtrl::HideActiveWindowHorzScrollBar , aby zabránila blikající obrazovce.

CMFCTabCtrl::SetActiveTabBoldFont

Povolí nebo zakáže použití tučného písma na aktivních kartách.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parametry

bIsBold
[v] TRUE použít tučné písmo k zobrazení popisku aktivní karty; FALSE použít standardní písmo k zobrazení popisku. Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::SetDrawFrame

Určuje, zda je obdélník rámečku nakreslen kolem vloženého pruhu.

void SetDrawFrame(BOOL bDraw=TRUE);

Parametry

bDraw
[v] TRUE k zobrazení obdélníku rámečku kolem vloženého pruhu; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::SetFlatFrame

Určuje, jestli se má kolem oblasti tabulátoru nakreslit plochý nebo 3D rámec.

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

Parametry

bFlat
[v] TRUE nakreslení plochého (2D) rámečku kolem oblasti tabulátoru; FALSE a nakreslete trojrozměrný (3D) rámec. Výchozí hodnota je TRUE.

bRepaint
[v] TRUE k okamžitému překreslení okna; v opačném případě . FALSE Výchozí hodnota je TRUE.

Poznámky

CMFCTabCtrl::SetImageList

Určuje seznam obrázků.

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 obrázkového prostředku, který obsahuje seznam obrázků.

cx
[v] Šířka každého obrázku v pixelech. Výchozí hodnota je 15.

clrTransp
[v] Průhledná barva obrázku. Části obrázku, které jsou touto barvou, budou průhledné. Výchozí hodnota je barva purpurová, RGB(255 0 255).

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

Návratová hodnota

TRUE pokud je tato metoda úspěšná. FALSE pokud je ovládací prvek tab vytvořen pomocí plochého stylu nebo pokud první přetížení metody nemůže načíst rastrový obrázek, který je určen parametrem uiID .

Poznámky

Tato metoda slouží k nastavení seznamu obrázků pro ovládací prvek karta. Obrázky ze seznamu obrázků se zobrazí vedle popisku karty. Tato metoda přepočítá výšku tabulátoru tak, aby karta obsahovala obrázek i text.

CMFCBaseTabCtrl::AddTab K určení indexu obrázku, který se má zobrazit, použijte metodu zděděnou ovládacím prvku tab.

CMFCTabCtrl::SetResizeMode

Určuje, jak lze změnit velikost aktuálního ovládacího prvku tabulátoru a pak ovládací prvek znovu zobrazit.

void SetResizeMode(ResizeMode resizeMode);

Parametry

resizeMode
[v] Jedna z hodnot výčtu CMFCTabCtrl::ResizeMode , která určuje, jak lze změnit velikost ovládacího prvku tab. Seznam možných hodnot najdete v tabulce v poznámkách.

Poznámky

Parametr resizeMode může být jednou z následujících ResizeMode hodnot výčtu.

Název Popis
RESIZE_NO Ovládací prvek Tab nelze změnit.
RESIZE_VERT Ovládací prvek tabulátoru lze změnit svisle, ale ne vodorovně.
RESIZE_HORIZ Ovládací prvek tabulátoru lze změnit vodorovně, ale ne svisle.

CMFCTabCtrl::SetTabMaxWidth

Určuje maximální šířku tabulátoru v okně s kartami.

void SetTabMaxWidth(int nTabMaxWidth);

Parametry

nTabMaxWidth
[v] Maximální šířka tabulátoru v pixelech.

Poznámky

Pomocí této metody můžete omezit šířku každé karty v okně s kartami. Tato metoda je užitečná, pokud karty mají velmi dlouhé popisky. Konstruktor CMFCTabCtrl třídy inicializuje maximální šířku tabulátoru na 0, což ve skutečnosti znamená, že šířka není omezená.

CMFCTabCtrl::StopResize

Ukončí aktuální operaci změny velikosti na ovládacím prvku karta.

void StopResize(BOOL bCancel);

Parametry

bCancel
[v] TRUE opustit aktuální operaci změny velikosti; FALSE a dokončete aktuální operaci změny velikosti. V obou případech architektura přestane kreslit obdélník změny velikosti.

CMFCTabCtrl::SynchronizeScrollBar

Nakreslí vodorovný posuvník na ovládací prvek tabulátoru, který zobrazuje ploché tabulátory.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parametry

pScrollInfo
[ven] Ukazatel na SCROLLINFO strukturu nebo NULL. Pokud tato metoda vrátí, a pokud tento parametr není NULL, struktura obsahuje všechny parametry posuvníku. Výchozí hodnota je NULL.

Návratová hodnota

TRUEpokud tato metoda bude úspěšná; v opačném případě . FALSE

Poznámky

Tato metoda ovlivňuje pouze ovládací prvek tabulátoru, který zobrazuje ploché karty. Posuvník ovlivňuje všechny karty najednou.

Viz také

Graf hierarchie
Třídy
CDockablePane Třída
CMFCBaseTabCtrl Třída