CBaseTabbedPane – třída

Rozšiřuje funkce třídy CDockablePane na podporu vytváření oken s kartami.

Syntaxe

class CBaseTabbedPane : public CDockablePane

Členové

Veřejné konstruktory

Název	Popis
CBaseTabbedPane::CBaseTabbedPane	Výchozí konstruktor.

Veřejné metody

Název	Popis
CBaseTabbedPane::AddTab	Přidá novou kartu do podokna s kartami.
CBaseTabbedPane::AllowDestroyEmptyTabbedPane	Určuje, jestli je možné zničit prázdné podokno s kartami.
CBaseTabbedPane::ApplyRestoredTabInfo	Použije nastavení karty, které se načtou z registru, do podokna s kartami.
CBaseTabbedPane::CanFloat	Určuje, zda může podokno plovákovat. (Přepsání CBasePane::CanFloat.)
CBaseTabbedPane::CanSetCaptionTextToTabName	Určuje, zda má titulek podokna s kartami zobrazovat stejný text jako aktivní karta.
CBaseTabbedPane::ConvertToTabbedDocument	(Přepsání CDockablePane::ConvertToTabbedDocument.)
CBaseTabbedPane::D etachPane	Převede jedno nebo více dokovatelných podoken na dokumenty s kartami MDI.
CBaseTabbedPane::EnableSetCaptionTextToTabName	Povolí nebo zakáže možnost podokna s kartami synchronizovat text titulku s textem popisku na aktivní kartě.
CBaseTabbedPane::FillDefaultTabsOrderArray	Obnoví pořadí vnitřních ovládacích prvků do výchozího stavu.
CBaseTabbedPane::FindBarByTabNumber	Vrátí podokno, které se nachází na kartě, když je karta identifikována indexem karet založeným na nule.
CBaseTabbedPane::FindPaneByID	Vrátí podokno, které je identifikováno ID podokna.
CBaseTabbedPane::FloatTab	Plovoucí podokno, ale pouze v případě, že se podokno aktuálně nachází na odpojené kartě.
CBaseTabbedPane::GetDefaultTabsOrder	Vrátí výchozí pořadí karet v podokně.
CBaseTabbedPane::GetFirstVisibleTab	Načte ukazatel na první zobrazenou kartu.
CBaseTabbedPane::GetMinSize	Načte minimální povolenou velikost podokna. (Přepsání CPane::GetMinSize.)
CBaseTabbedPane::GetPaneIcon	Vrátí popisovač ikony podokna. (Přepsání CBasePane::GetPaneIcon.)
CBaseTabbedPane::GetPaneList	Vrátí seznam podoken obsažených v podokně s kartami.
CBaseTabbedPane::GetTabArea	Vrátí ohraničující obdélníky pro oblasti horní a dolní karty.
CBaseTabbedPane::GetTabsNum	Vrátí počet karet v okně karty.
CBaseTabbedPane::GetUnderlyingWindow	Získá podkladové (zabalené) okno karty.
CBaseTabbedPane::GetVisibleTabsNum	Vrátí počet zobrazených karet.
CBaseTabbedPane::HasAutoHideMode	Určuje, zda lze podokno s kartami přepnout do režimu automatického skrytí.
CBaseTabbedPane::IsHideSingleTab	Určuje, jestli je podokno s kartami skryté, pokud se zobrazí jenom jedna karta.
CBaseTabbedPane::LoadSiblingPaneIDs	Používá se interně během serializace.
CBaseTabbedPane::RecalcLayout	Přepočítá informace o rozložení pro podokno. (Přepsání CPane::RecalcLayout.)
CBaseTabbedPane::RemovePane	Odebere podokno z podokna s kartami.
CBaseTabbedPane::SaveSiblingBarIDs	Používá se interně během serializace.
CBaseTabbedPane::Serialize	(Přepsání CDockablePane::Serialize.)
CBaseTabbedPane::SerializeTabWindow	Používá se interně během serializace.
CBaseTabbedPane::SetAutoDestroy	Určuje, jestli se řídicí panel s kartami automaticky zničí.
CBaseTabbedPane::SetAutoHideMode	Přepíná dokovací podokno mezi zobrazeným a automatickým skrytím režimu. (Přepsání CDockablePane::SetAutoHideMode.)
CBaseTabbedPane::ShowTab	Zobrazí nebo skryje kartu.

Poznámky

Tato třída je abstraktní třída a nelze vytvořit instanci. Implementuje služby, které jsou společné pro všechny druhy podoken s kartami.

Knihovna v současné době obsahuje dvě odvozené třídy podokna s kartami: CTabbedPane – třída a CMFCOutlookBar – třída.

Objekt CBaseTabbedPane zalamuje ukazatel na OBJEKT CMFCBaseTabCtrl Třída . CMFCBaseTabCtrl – třída se pak stane podřízeným oknem podokna s kartami.

Další informace o vytváření podoken na záložkách naleznete v tématu CDockablePane – třída, CTabbedPane – třída a CMFCOutlookBar – třída.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CBasePane

Podokno CPane

CDockablePane

CBaseTabbedPane

Požadavky

Hlavička: afxBaseTabbedPane.h

CBaseTabbedPane::AddTab

Přidá novou kartu do podokna s kartami.

virtual BOOL AddTab(
    CWnd* pNewBar,
    BOOL bVisible = TRUE,
    BOOL bSetActive = TRUE,
    BOOL bDetachable = TRUE);

Parametry

pNewBar
[in, out] Ukazatel na podokno, které chcete přidat. Tento ukazatel může být po volání této metody neplatný. Další informace najdete v části Poznámky.

bVisible
[v] TRUE, aby byla karta viditelná; jinak NEPRAVDA.

bSetActive
[v] TRUE, aby karta aktivní karta; jinak NEPRAVDA.

bDetachable
[v] TRUE, aby byla tabulátor odpojena; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud se podokno úspěšně přidalo jako karta a nebylo zničeno v procesu. NEPRAVDA, pokud je přidané podokno objekt typu CBaseTabbedPane. Další informace najdete v části Poznámky.

Poznámky

Voláním této metody přidáte podokno jako novou kartu v podokně s kartami. Pokud pNewBar odkazuje na objekt typu CBaseTabbedPane, všechny jeho karty se zkopírují do podokna s kartami a pNewBar je zničen. Proto se pNewBar stane neplatným ukazatelem a neměl by být použit.

CBaseTabbedPane::AllowDestroyEmptyTabbedPane

Určuje, jestli je možné zničit prázdné podokno s kartami.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Návratová hodnota

TRUE, pokud je možné zničit prázdné podokno s kartami; jinak NEPRAVDA. Výchozí implementace vždy vrátí hodnotu TRUE.

Poznámky

Pokud není možné zničit prázdné podokno s kartami, architektura místo toho podokno skryje.

CBaseTabbedPane::ApplyRestoredTabInfo

Načte nastavení karty z registru a použije je v podokně s kartami.

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parametry

bUseTabIndexes
[v] Tento parametr se používá interně v rámci.

Poznámky

Tato metoda je volána rozhraním při opětovném načtení informací o stavu ukotvení z registru. Metoda získá informace o pořadí ovládacích prvků a názvech karet pro podokno s kartami.

CBaseTabbedPane::CanFloat

Určuje, jestli může podokno s kartami plout.

virtual BOOL CanFloat() const;

Návratová hodnota

TRUE, pokud podokno může plout; jinak NEPRAVDA.

CBaseTabbedPane::CanSetCaptionTextToTabName

Určuje, zda má titulek podokna s kartami zobrazovat stejný text jako aktivní karta.

virtual BOOL CanSetCaptionTextToTabName() const;

Návratová hodnota

TRUE, pokud je text titulku v podokně s kartami nastaven na text aktivní karty; jinak NEPRAVDA.

Poznámky

Metoda se používá k určení, zda text zobrazený v titulku podokna karet duplikuje popisek aktivní karty. Tuto funkci můžete povolit nebo zakázat voláním CBaseTabbedPane::EnableSetCaptionTextToTabName.

CBaseTabbedPane::ConvertToTabbedDocument

Převede jedno nebo více dokovatelných podoken na dokumenty s kartami MDI.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parametry

bActiveTabOnly
[v] Při převodu podokna s kartami zadejte hodnotu TRUE, která převede pouze aktivní kartu. Pokud chcete převést všechny karty v podokně, zadejte HODNOTU FALSE.

CBaseTabbedPane::D etachPane

Odpojte podokno z podokna s kartami.

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

Parametry

pBar
[v] Ukazatel na podokno, které chcete odpojit.

bHide
[v] Logický parametr, který určuje, jestli architektura skryje podokno po odpojení.

Návratová hodnota

TRUE, pokud architektura úspěšně odpojí podokno; NEPRAVDA, pokud je pBar NULL nebo odkazuje na podokno, které není v podokně s kartami.

Poznámky

Pokud je to možné, architektura plovoucí podokno odpojí. Další informace naleznete v tématu CBasePane::CanFloat.

CBaseTabbedPane::EnableSetCaptionTextToTabName

Povolí nebo zakáže možnost podokna s kartami synchronizovat text titulku s textem popisku na aktivní kartě.

virtual void EnableSetCaptionTextToTabName(BOOL bEnable);

Parametry

bEnable
[v] TRUE pro synchronizaci titulku podokna s kartami s aktivním popiskem karty; jinak NEPRAVDA.

CBaseTabbedPane::FillDefaultTabsOrderArray

Obnoví pořadí vnitřních ovládacích prvků do výchozího stavu.

void FillDefaultTabsOrderArray();

Poznámky

Tato metoda se volá, když architektura obnoví panel Outlooku do počátečního stavu.

CBaseTabbedPane::FindPaneByID

Vrátí podokno identifikované ID podokna.

virtual CWnd* FindPaneByID(UINT uBarID);

Parametry

uBarID
[v] Určuje ID podokna, které se má najít.

Návratová hodnota

Ukazatel na podokno, pokud byl nalezen; v opačném případě null.

Poznámky

Tato metoda porovná všechny karty v podokně a vrátí ho s ID určeným parametrem uBarID .

CBaseTabbedPane::FindBarByTabNumber

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

virtual CWnd* FindBarByTabNumber(
    int nTabNum,
    BOOL bGetWrappedBar = FALSE);

Parametry

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

bGetWrappedBar
[v] TRUE pro vrácení podkladového (zabaleného) okna podokna místo samotného podokna; jinak NEPRAVDA. To platí jenom pro podokna odvozená z CDockablePaneAdapter.

Návratová hodnota

Pokud se podokno najde, vrátí se platný ukazatel na podokno, které hledáte. v opačném případě null.

Poznámky

Voláním této metody načtěte podokno umístěné na kartě určené parametrem nTabNum .

CBaseTabbedPane::FloatTab

Plovoucí podokno, ale pouze v případě, že se podokno aktuálně nachází na odpojené kartě.

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

Parametry

pBar
[in, out] Ukazatel na podokno, které má být plovoucí.

nTabID
[v] Určuje index založený na nule tabulátoru, který má být plovoucí.

dockMethod
[v] Určuje metodu, která se má použít k vytvoření plovoucího podokna. Další informace najdete v části Poznámky.

bHide
[v] TRUE pro skrytí podokna před plovoucí desetinnou čárkou; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud je podokno plovoucí; jinak NEPRAVDA.

Poznámky

Voláním této metody se zobrazí plovoucí podokno, které se aktuálně nachází na odpojené kartě.

Pokud chcete podokno odpojit programově, zadejte DM_SHOW parametr dockMethod . Pokud chcete podokno s plovoucím plovoucím objektem umístit do stejné pozice, zadejte DM_DBL_CLICK jako parametr dockMethod .

CBaseTabbedPane::GetDefaultTabsOrder

Vrátí výchozí pořadí karet v podokně.

const CArray<int,int>& GetDefaultTabsOrder();

Návratová hodnota

Objekt CArray , který určuje výchozí pořadí karet v podokně.

Poznámky

Architektura volá tuto metodu, když je panel Outlooku resetována do počátečního stavu.

CBaseTabbedPane::GetFirstVisibleTab

Načte ukazatel na první zobrazenou kartu.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

Parametry

iTabNum
[v] Odkaz na celé číslo. Tato metoda zapíše do tohoto parametru nulový index první zobrazené karty, nebo -1, pokud se nenajde žádná zobrazená karta.

Návratová hodnota

V případě úspěchu ukazatel na první zobrazenou kartu; v opačném případě null.

CBaseTabbedPane::GetMinSize

Načte minimální povolenou velikost podokna.

virtual void GetMinSize(CSize& size) const;

Parametry

velikost
[ven] Objekt CSize , který je vyplněný minimální povolenou velikostí.

Poznámky

Pokud je aktivní konzistentní zpracování minimálních velikostí podokna ( CPane::m_bHandleMinSize), je velikost vyplněna minimální povolenou velikostí aktivní karty. V opačném případě se velikost vyplní návratovou hodnotou CPane::GetMinSize.

CBaseTabbedPane::GetPaneIcon

Načte minimální povolenou velikost podokna.

virtual void GetMinSize(CSize& size) const;

Parametry

velikost
[ven] Objekt CSize , který je vyplněný minimální povolenou velikostí.

Poznámky

Pokud je aktivní konzistentní zpracování minimálních velikostí podokna ( CPane::m_bHandleMinSize), je velikost vyplněna minimální povolenou velikostí aktivní karty. V opačném případě se velikost vyplní návratovou hodnotou CPane::GetMinSize.

CBaseTabbedPane::GetPaneList

Vrátí seznam podoken obsažených v podokně s kartami.

virtual void GetPaneList(
    CObList& lst,
    CRuntimeClass* pRTCFilter = NULL);

Parametry

Lst
[ven] Je CObList vyplněná podokny, která jsou obsažena v podokně s kartami.

pRTCFilter
[v] Pokud není null, vrácený seznam obsahuje pouze podokna, která jsou ze zadané třídy modulu runtime.

CBaseTabbedPane::GetTabArea

Vrátí ohraničující obdélníky pro oblasti horní a dolní karty.

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

Parametry

rectTabAreaTop
[ven] Přijme souřadnice obrazovky horní oblasti tabulátoru.

rectTabAreaBottom
[ven] Přijme souřadnice obrazovky dolní oblasti tabulátoru.

Poznámky

Voláním této metody určíte ohraničující obdélníky v souřadnicích obrazovky pro horní a dolní oblasti tabulátoru.

CBaseTabbedPane::GetTabsNum

Vrátí počet karet v okně karty.

virtual int GetTabsNum() const;

Návratová hodnota

Počet karet v podokně s kartami

CBaseTabbedPane::GetUnderlyingWindow

Získá podkladové (zabalené) okno karty.

virtual CMFCBaseTabCtrl* GetUnderlyingWindow();

Návratová hodnota

Ukazatel na podkladové okno karty

CBaseTabbedPane::GetVisibleTabsNum

Vrátí počet viditelných karet.

virtual int GetVisibleTabsNum() const;

Návratová hodnota

Počet viditelných karet, které budou větší nebo rovny nule.

Poznámky

Voláním této metody určíte počet viditelných karet v podokně s kartami.

CBaseTabbedPane::HasAutoHideMode

Určuje, zda lze podokno s kartami přepnout do režimu automatického skrytí.

virtual BOOL HasAutoHideMode() const;

Návratová hodnota

TRUE, pokud je možné podokno přepnout do režimu automatického skrytí; jinak NEPRAVDA.

Poznámky

Pokud je režim automatického skrytí zakázaný, nezobrazí se v titulku podokna s kartami žádné tlačítko připnutí.

CBaseTabbedPane::IsHideSingleTab

Určuje, jestli je podokno s kartami skryté, pokud se zobrazí jenom jedna karta.

virtual BOOL IsHideSingleTab() const;

Návratová hodnota

TRUE Pokud okno karty není zobrazeno, pokud je pouze jedna viditelná karta; jinak NEPRAVDA.

Poznámky

Pokud se podokno nezobrazí, protože je otevřená jenom jedna karta, můžete tuto metodu volat, abyste zjistili, jestli podokno s kartami funguje správně.

CBaseTabbedPane::RemovePane

Odebere podokno z podokna s kartami.

virtual BOOL RemovePane(CWnd* pBar);

Parametry

pBar
[in, out] Ukazatel na podokno, které chcete odebrat z podokna s kartami.

Návratová hodnota

TRUE, pokud se podokno úspěšně odebralo z podokna s kartami a pokud je podokno s kartami stále platné. NEPRAVDA, pokud bylo z podokna s kartami odebráno poslední podokno a podokno s kartami se chystá zničit. Pokud je vrácená hodnota NEPRAVDA, nepoužívejte už podokno s kartami.

Poznámky

Voláním této metody odeberete podokno určené parametrem pBar z podokna s kartami.

CBaseTabbedPane::SetAutoDestroy

Určuje, jestli se řídicí panel s kartami automaticky zničí.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parametry

bAutoDestroy
[v] TRUE Pokud se podokno s kartami vytvořilo dynamicky a vy neovládáte jeho životnost; jinak NEPRAVDA.

Poznámky

Pokud vytváříte podokno s kartami dynamicky a pokud neřídíte jeho životnost, nastavte režim automatického zničení na hodnotu TRUE. Pokud je režim automatického zničení TRUE, rozhraní automaticky zničí podokno s kartami.

CBaseTabbedPane::ShowTab

Zobrazí nebo skryje kartu.

virtual BOOL ShowTab(
    CWnd* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametry

pBar
[v] Ukazatel na podokno, které chcete zobrazit nebo skrýt.

BShow
[v] TRUE pro zobrazení podokna; NEPRAVDA pro skrytí podokna.

bDelay
[v] PRAVDA pro zpoždění úpravy rozložení tabulátoru; jinak NEPRAVDA.

bActivate
[v] TRUE, aby karta aktivní karta; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud byla karta zobrazena nebo skryta úspěšně; jinak NEPRAVDA.

Poznámky

Při volání této metody se v závislosti na hodnotě parametru bShow zobrazí nebo skryje podokno. Pokud skryjete kartu a je to poslední viditelná karta v podkladovém okně karty, podokno s kartami je skryté. Pokud zobrazíte kartu, když se dříve nezobrazovaly žádné karty, zobrazí se podokno s kartami.

CBaseTabbedPane::RecalcLayout

Přepočítá informace o rozložení pro podokno.

virtual void RecalcLayout();

Poznámky

Pokud je podokno plovoucí, tato metoda upozorní architekturu, aby změnila velikost podokna na aktuální velikost minirámeček.

Pokud je podokno ukotveno, tato metoda nedělá nic.

CBaseTabbedPane::SetAutoHideMode

Nastaví režim automatického skrytí pro odpojená podokna v podokně s kartami.

virtual CMFCAutoHideToolBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideToolBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

Parametry

bMode
[v] TRUE pro povolení režimu automatického skrytí; FALSE pro povolení normálního dokovacího režimu.

dwAlignment
[v] Určuje zarovnání podokna automatického skrytí, které se má vytvořit. Seznam možných hodnot najdete v tématu CPane::MoveByAlignment.

pCurrAutoHideBar
[in, out] Ukazatel na aktuální panel nástrojů automatického skrytí Může mít hodnotu NULL.

bUseTimer
[v] Určuje, jestli se má použít efekt automatického skrytí, když uživatel přepne podokno do režimu automatického skrytí, nebo chcete podokno okamžitě skrýt.

Návratová hodnota

Ukazatel na panel nástrojů automatického skrytí, který se vytvoří při přepnutí do režimu automatického skrytí, nebo null, pokud není vytvořen žádný panel nástrojů.

Poznámky

Architektura volá tuto metodu, když uživatel zvolí tlačítko připnout, aby se podokno s kartami přepnulo do režimu automatického skrytí nebo do běžného režimu ukotvení.

Režim automatického skrytí je nastavený pro každé odpojené podokno v podokně s kartami. Podokna, která nejsou odpojitelná, se ignorují. Další informace naleznete v tématu CMFCBaseTabCtrl::EnableTabDetach.

Voláním této metody přepnete podokno s kartami do režimu automatického skrytí prostřednictvím kódu programu. Podokno musí být ukotveno do okna hlavního rámce ( CDockablePane::GetDefaultPaneDivider musí vrátit platný ukazatel na CPaneDivider).

Viz také

Graf hierarchie
Třídy
CDockablePane – třída