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
| Jméno | popis |
|---|---|
CBaseTabbedPane::CBaseTabbedPane |
Výchozí konstruktor. |
Veřejné metody
| Jméno | 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á popis pro podokno 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 popis text 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
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.
Vrácená 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;
Vrácená 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;
Vrácená hodnota
TRUE, pokud podokno může plout; jinak NEPRAVDA.
CBaseTabbedPane::CanSetCaptionTextToTabName
Určuje, zda má popis pro podokno s kartami zobrazovat stejný text jako aktivní karta.
virtual BOOL CanSetCaptionTextToTabName() const;
Vrácená hodnota
TRUE, pokud je text popis podokna s kartami nastavený na text aktivní karty; jinak NEPRAVDA.
Poznámky
Metoda se používá k určení, zda text zobrazený v podokně s kartami popis 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í.
Vrácená 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 popis text s textem popisku na aktivní kartě.
virtual void EnableSetCaptionTextToTabName(BOOL bEnable);
Parametry
bEnable
[v] PRAVDA, pokud chcete synchronizovat podokno s kartami popis s aktivní kartou popis; 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.
Vrácená 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.
Vrácená 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.
Vrácená 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();
Vrácená 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.
Vrácená 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;
Vrácená hodnota
Počet karet v podokně s kartami
CBaseTabbedPane::GetUnderlyingWindow
Získá podkladové (zabalené) okno karty.
virtual CMFCBaseTabCtrl* GetUnderlyingWindow();
Vrácená hodnota
Ukazatel na podkladové okno karty
CBaseTabbedPane::GetVisibleTabsNum
Vrátí počet viditelných karet.
virtual int GetVisibleTabsNum() const;
Vrácená 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;
Vrácená 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ý, v podokně s kartami popis se nezobrazí žá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;
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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é
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro