CBaseTabbedPane osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Kibővíti a CDockablePane osztály funkcióit, hogy támogassa a többlapos ablakok létrehozását.

Szemantika

class CBaseTabbedPane : public CDockablePane

Tagok

Nyilvános konstruktorok

Név	Description
CBaseTabbedPane::CBaseTabbedPane	Alapértelmezett konstruktor.

Nyilvános metódusok

Név	Description
CBaseTabbedPane::AddTab	Új lapot ad hozzá egy lapfüles panelhez.
CBaseTabbedPane::AllowDestroyEmptyTabbedPane	Megadja, hogy egy üres lapozott panel megsemmisíthető-e.
CBaseTabbedPane::ApplyRestoredTabInfo	A beállításjegyzékből betöltött lapbeállításokat alkalmazza egy többlapos panelre.
CBaseTabbedPane::CanFloat	Meghatározza, hogy a panel lebeghet-e. (Felülbírálja a CBasePane::CanFloat.)
CBaseTabbedPane::CanSetCaptionTextToTabName	Meghatározza, hogy a füles panel felirata ugyanazt a szöveget jelenítse-e meg, mint az aktív lap.
CBaseTabbedPane::ConvertToTabbedDocument	(A CDockablePane felülbírálása::ConvertToTabbedDocument.)
CBaseTabbedPane::D etachPane	Egy vagy több dokkolható ablaktáblát MDI-lapozott dokumentumokká alakít át.
CBaseTabbedPane::EnableSetCaptionTextToTabName	Engedélyezi vagy letiltja a többlapos panel azon képességét, hogy szinkronizálja a feliratszöveget az aktív lapon lévő címkeszöveggel.
CBaseTabbedPane::FillDefaultTabsOrderArray	Visszaállítja a belső lapsorrendet alapértelmezett állapotra.
CBaseTabbedPane::FindBarByTabNumber	Olyan panelt ad vissza, amely akkor található egy lapon, ha a lapot nulla alapú lapindex azonosítja.
CBaseTabbedPane::FindPaneByID	Egy panelt ad vissza, amelyet a panel azonosítója azonosít.
CBaseTabbedPane::FloatTab	Az ablaktábla lebegtetése, de csak akkor, ha az ablaktábla jelenleg leválasztható lapon található.
CBaseTabbedPane::GetDefaultTabsOrder	A panelen lévő lapok alapértelmezett sorrendjét adja vissza.
CBaseTabbedPane::GetFirstVisibleTab	Az első megjelenített lapra mutató mutatót kér le.
CBaseTabbedPane::GetMinSize	Lekéri az ablaktábla minimálisan megengedett méretét. (Felülbírálja a CPane::GetMinSize.)
CBaseTabbedPane::GetPaneIcon	Egy fogópontot ad vissza a panel ikonjához. (A CBasePane felülbírálása::GetPaneIcon.)
CBaseTabbedPane::GetPaneList	A lapozott ablaktáblában található ablaktáblák listáját adja vissza.
CBaseTabbedPane::GetTabArea	A felső és az alsó lapterület határoló téglalapjait adja vissza.
CBaseTabbedPane::GetTabsNum	A tabulátorablakban lévő lapok számát adja vissza.
CBaseTabbedPane::GetUnderlyingWindow	Lekéri a mögöttes (burkolt) lapablakot.
CBaseTabbedPane::GetVisibleTabsNum	A megjelenített lapok számát adja vissza.
CBaseTabbedPane::HasAutoHideMode	Meghatározza, hogy a lapozott panel átváltható-e automatikus elrejtő módra.
CBaseTabbedPane::IsHideSingleTab	Meghatározza, hogy a lapfül rejtett-e, ha csak egy lap jelenik meg.
CBaseTabbedPane::LoadSiblingPaneIDs	Belsőleg a szerializálás során használják.
CBaseTabbedPane::RecalcLayout	Újraszámítja a panel elrendezési adatait. (Felülbírálja a CPane::RecalcLayout.)
CBaseTabbedPane::RemovePane	Eltávolít egy panelt a lapozott panelről.
CBaseTabbedPane::SaveSiblingBarIDs	Belsőleg a szerializálás során használják.
CBaseTabbedPane::Serialize	(Felülbírálja a CDockablePane::Serialize.)
CBaseTabbedPane::SerializeTabWindow	Belsőleg a szerializálás során használják.
CBaseTabbedPane::SetAutoDestroy	Meghatározza, hogy a lapozott vezérlősáv automatikusan megsemmisül-e.
CBaseTabbedPane::SetAutoHideMode	A dokkoló panel váltása a megjelenített és az automatikus elrejtési mód között. (A CDockablePane felülbírálása::SetAutoHideMode.)
CBaseTabbedPane::ShowTab	Egy lap megjelenítése vagy elrejtése.

Megjegyzések

Ez az osztály egy absztrakt osztály, és nem hozható létre példányosítva. Implementálja azokat a szolgáltatásokat, amelyek minden típusú többlapos panelen gyakoriak.

A kódtár jelenleg két származtatott lapozott panelosztályt tartalmaz: a CTabbedPane osztályt és a CMFCOutlookBar osztályt.

Egy CBaseTabbedPane objektum egy CMFCBaseTabCtrl osztályobjektumra tördeli a mutatót . A CMFCBaseTabCtrl osztály ezután a lapozott panel gyermekablakává válik.

A lapozott panelek létrehozásáról további információt a CDockablePane Osztály, a CTabbedPane osztály és a CMFCOutlookBar osztály című témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CBaseTabbedPane

Requirements

Fejléc: afxBaseTabbedPane.h

CBaseTabbedPane::AddTab

Új lapot ad hozzá egy lapfüles panelhez.

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

Paraméterek

pNewBar
[be, ki] A hozzáadni kívánt ablaktábla mutatója. A metódus meghívása után ez a mutató érvénytelenné válhat. További információkért lásd a Megjegyzések szakaszt.

bVisible
[in] IGAZ, hogy láthatóvá tegye a lapot; egyéb esetben HAMIS.

bSetActive
[in] IGAZ, hogy a lap legyen aktív lap; egyéb esetben HAMIS.

bDetachable
[in] IGAZ, hogy levehető legyen a lap; egyéb esetben HAMIS.

Visszaadott érték

IGAZ, ha a panel sikeresen lett hozzáadva lapként, és a folyamat során nem semmisült meg. HAMIS, ha a hozzáadott ablaktábla egy típusú CBaseTabbedPaneobjektum. További információkért lásd a Megjegyzések szakaszt.

Megjegyzések

Hívja meg ezt a metódust, ha új lapként szeretne hozzáadni egy panelt egy lapfüles panelhez. Ha a pNewBar egy típusú CBaseTabbedPaneobjektumra mutat, az összes lapja a lapfülekre lesz másolva, majd a pNewBar el lesz pusztítva. Így a pNewBar érvénytelen mutatóvá válik, ezért nem használható.

CBaseTabbedPane::AllowDestroyEmptyTabbedPane

Megadja, hogy egy üres lapozott panel megsemmisíthető-e.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Visszaadott érték

IGAZ, ha egy üres lapozott ablaktábla megsemmisíthető; egyéb esetben HAMIS. Az alapértelmezett implementáció mindig IGAZ értéket ad vissza.

Megjegyzések

Ha egy üres lapozott ablaktábla nem pusztulhat el, a keretrendszer ehelyett elrejti a panelt.

CBaseTabbedPane::ApplyRestoredTabInfo

Betölti a lapbeállításokat a beállításjegyzékből, és alkalmazza őket egy többlapos panelre.

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Paraméterek

bUseTabIndexes
[in] Ezt a paramétert a keretrendszer belsőleg használja.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor újra betölti az állapotinformációkat a beállításjegyzékből. A metódus a lapsorrendről és a lapnevekről szerez be információkat a lapfülek paneljéről.

CBaseTabbedPane::CanFloat

Megadja, hogy a lapozott panel lebeghet-e.

virtual BOOL CanFloat() const;

Visszaadott érték

IGAZ, ha az ablaktábla lebeghet; egyéb esetben HAMIS.

CBaseTabbedPane::CanSetCaptionTextToTabName

Meghatározza, hogy a füles panel felirata ugyanazt a szöveget jelenítse-e meg, mint az aktív lap.

virtual BOOL CanSetCaptionTextToTabName() const;

Visszaadott érték

IGAZ, ha a lapfül feliratszövege az aktív lap szövegére van állítva; egyéb esetben HAMIS.

Megjegyzések

Ez a módszer annak meghatározására szolgál, hogy a lapfül feliratán megjelenő szöveg duplikálja-e az aktív lap címkéjét. Ezt a funkciót a CBaseTabbedPane::EnableSetCaptionTextToTabName meghívásával engedélyezheti vagy letilthatja.

CBaseTabbedPane::ConvertToTabbedDocument

Egy vagy több dokkolható ablaktáblát MDI-lapozott dokumentumokká alakít át.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Paraméterek

bActiveTabOnly
[in] Ha többlapos panelt konvertál, adja meg a TRUE értéket, hogy csak az aktív lapot konvertálja. Adja meg a HAMIS értéket a panel összes lapjának konvertálásához.

CBaseTabbedPane::D etachPane

Leválasztja a panelt a lapozott panelről.

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

Paraméterek

pBar
[in] A leválasztandó panelre mutató egérmutató.

bHide
[in] Logikai paraméter, amely meghatározza, hogy a keretrendszer elrejti-e a panelt a leválasztása után.

Visszaadott érték

IGAZ, ha a keretrendszer sikeresen leválasztja a panelt; HAMIS, ha a pBar null értékű, vagy olyan ablaktáblára hivatkozik, amely nem a lapozott panelen található.

Megjegyzések

Ha lehetséges, a keretrendszer lebegteti a leválasztott panelt. További információ: CBasePane::CanFloat.

CBaseTabbedPane::EnableSetCaptionTextToTabName

Engedélyezi vagy letiltja a többlapos panel azon képességét, hogy szinkronizálja a feliratszöveget az aktív lapon lévő címkeszöveggel.

virtual void EnableSetCaptionTextToTabName(BOOL bEnable);

Paraméterek

bEnable
[in] IGAZ, ha szinkronizálja a lapfül feliratát az aktív tabulátorfelirattal; egyéb esetben HAMIS.

CBaseTabbedPane::FillDefaultTabsOrderArray

Visszaállítja a belső lapsorrendet alapértelmezett állapotra.

void FillDefaultTabsOrderArray();

Megjegyzések

Ezt a metódust akkor hívjuk meg, ha a keretrendszer visszaállít egy Outlook-sávot egy kezdeti állapotba.

CBaseTabbedPane::FindPaneByID

A panelazonosító által azonosított panelt ad vissza.

virtual CWnd* FindPaneByID(UINT uBarID);

Paraméterek

uBarID
[in] Megadja a keresendő panel azonosítóját.

Visszaadott érték

Mutató a panelre, ha megtalálta; ellenkező esetben NULL.

Megjegyzések

Ez a módszer összehasonlítja a panel összes lapját, és az uBarID paraméter által megadott azonosítót adja vissza.

CBaseTabbedPane::FindBarByTabNumber

Egy lapon található panelt ad vissza.

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

Paraméterek

nTabNum
[in] A lekérni kívánt lap nulla alapú indexét adja meg.

bGetWrappedBar
[in] IGAZ, ha az ablaktábla mögöttes (burkolt) ablakát adja vissza magának a panelnek a helyett; egyéb esetben HAMIS. Ez csak a CDockablePaneAdapterből származó ablaktáblákra vonatkozik.

Visszaadott érték

Ha a panel megtalálható, a rendszer a keresett ablaktábla érvényes mutatóját adja vissza; ellenkező esetben NULL.

Megjegyzések

Hívja meg ezt a metódust az nTabNum paraméter által megadott lapon található panel lekéréséhez.

CBaseTabbedPane::FloatTab

Az ablaktábla lebegtetése, de csak akkor, ha az ablaktábla jelenleg leválasztható lapon található.

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

Paraméterek

pBar
[be, ki] Az úszó ablaktábla mutatója.

nTabID
[in] A lap lebegőpontos indexét adja meg.

dockMethod
[in] Megadja az ablaktábla lebegtetéséhez használni kívánt módszert. További információkért lásd a Megjegyzések szakaszt.

bHide
[in] IGAZ, hogy elrejtse a panelt a lebegő előtt; egyéb esetben HAMIS.

Visszaadott érték

IGAZ, ha az ablaktábla lebegett; egyéb esetben HAMIS.

Megjegyzések

Ennek a metódusnak a meghívásával lebegtethet egy jelenleg leválasztható lapon található panelt.

Ha programozott módon szeretne leválasztani egy panelt, adja meg a dockMethod paraméter DM_SHOW. Ha a panelt ugyanabban a pozícióban szeretné lebegtetni, ahol korábban lebegett, adja meg a dockMethod paraméterként DM_DBL_CLICK.

CBaseTabbedPane::GetDefaultTabsOrder

A panelen lévő lapok alapértelmezett sorrendjét adja vissza.

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

Visszaadott érték

A CArray panel lapjainak alapértelmezett sorrendjét meghatározó objektum.

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor egy Outlook-sáv kezdeti állapotba kerül.

CBaseTabbedPane::GetFirstVisibleTab

Az első megjelenített lapra mutató mutatót kér le.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

Paraméterek

iTabNum
[in] Egész számra mutató hivatkozás. Ez a metódus az első megjelenített lap nulla alapú indexét írja erre a paraméterre, vagy -1, ha nem található megjelenített lap.

Visszaadott érték

Ha sikeres, az első megjelenített lapra mutató mutató; ellenkező esetben NULL.

CBaseTabbedPane::GetMinSize

Lekéri az ablaktábla minimálisan megengedett méretét.

virtual void GetMinSize(CSize& size) const;

Paraméterek

méret
[kifelé] Olyan CSize objektum, amely a minimálisan megengedett mérettel van kitöltve.

Megjegyzések

Ha a minimális panelméretek konzisztens kezelése aktív ( CPane::m_bHandleMinSize), a méret az aktív lap minimális megengedett méretével van kitöltve. Ellenkező esetben a méret a CPane::GetMinSize visszatérési értékével van kitöltve.

CBaseTabbedPane::GetPaneIcon

Lekéri az ablaktábla minimálisan megengedett méretét.

virtual void GetMinSize(CSize& size) const;

Paraméterek

méret
[kifelé] Olyan CSize objektum, amely a minimálisan megengedett mérettel van kitöltve.

Megjegyzések

Ha a minimális panelméretek konzisztens kezelése aktív ( CPane::m_bHandleMinSize), a méret az aktív lap minimális megengedett méretével van kitöltve. Ellenkező esetben a méret a CPane::GetMinSize visszatérési értékével van kitöltve.

CBaseTabbedPane::GetPaneList

A lapozott ablaktáblában található ablaktáblák listáját adja vissza.

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

Paraméterek

Lst
[kifelé] A CObList lapozott panelen található panelekkel kitöltött panel.

pRTCFilter
[in] Ha nem NULL, a visszaadott lista csak a megadott futtatókörnyezeti osztályhoz tartozó paneleket tartalmazza.

CBaseTabbedPane::GetTabArea

A felső és az alsó lapterület határoló téglalapjait adja vissza.

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

Paraméterek

rectTabAreaTop
[kifelé] Fogadja a felső lapterület képernyőkoordinátáit.

rectTabAreaBottom
[kifelé] Fogadja az alsó lapterület képernyőkoordinátáit.

Megjegyzések

Ennek a metódusnak a meghívásával meghatározhatja a felső és az alsó lapterület határoló téglalapjait képernyőkoordinátákban.

CBaseTabbedPane::GetTabsNum

A tabulátorablakban lévő lapok számát adja vissza.

virtual int GetTabsNum() const;

Visszaadott érték

A lapfülek száma a többlapos panelen.

CBaseTabbedPane::GetUnderlyingWindow

Lekéri a mögöttes (burkolt) lapablakot.

virtual CMFCBaseTabCtrl* GetUnderlyingWindow();

Visszaadott érték

Mutató a mögöttes lap ablakához.

CBaseTabbedPane::GetVisibleTabsNum

A látható lapok számát adja vissza.

virtual int GetVisibleTabsNum() const;

Visszaadott érték

A látható lapok száma, amelyek nullánál nagyobbak vagy egyenlőek lesznek.

Megjegyzések

Hívja meg ezt a metódust a lapfülek látható lapjainak számának meghatározásához.

CBaseTabbedPane::HasAutoHideMode

Meghatározza, hogy a lapozott panel átváltható-e automatikus felfedés módra.

virtual BOOL HasAutoHideMode() const;

Visszaadott érték

IGAZ, ha a panel automatikus felfedés módra váltható; egyéb esetben HAMIS.

Megjegyzések

Ha az automatikus megjelenítési mód le van tiltva, a lapozott panel feliratán nem jelenik meg pin gomb.

CBaseTabbedPane::IsHideSingleTab

Meghatározza, hogy a lapfül rejtett-e, ha csak egy lap jelenik meg.

virtual BOOL IsHideSingleTab() const;

Visszaadott érték

IGAZ, ha a tabulátorablak nem jelenik meg, ha csak egy látható lap van; egyéb esetben HAMIS.

Megjegyzések

Ha a panel nem jelenik meg, mert csak egy lap van megnyitva, meghívhatja ezt a metódust annak megállapításához, hogy a lapozott ablaktábla megfelelően működik-e.

CBaseTabbedPane::RemovePane

Eltávolít egy panelt a lapozott panelről.

virtual BOOL RemovePane(CWnd* pBar);

Paraméterek

pBar
[be, ki] Az ablaktábla mutatója a lapozott panelről való eltávolításhoz.

Visszaadott érték

IGAZ, ha az ablaktábla sikeresen el lett távolítva a többlapos panelről, és ha a lapozott ablaktábla továbbra is érvényes. HAMIS, ha az utolsó panel el lett távolítva a lapozott panelről, és a lapozott ablaktábla hamarosan megsemmisül. Ha a visszatérési érték HAMIS, ne használja többé a többlapos panelt.

Megjegyzések

Hívja meg ezt a metódust, hogy távolítsa el a pBar paraméter által megadott panelt a lapozott panelről.

CBaseTabbedPane::SetAutoDestroy

Meghatározza, hogy a lapozott vezérlősáv automatikusan megsemmisül-e.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Paraméterek

bAutoDestroy
[in] IGAZ, ha a lapozott panel dinamikusan lett létrehozva, és nem szabályozza annak élettartamát; egyéb esetben HAMIS.

Megjegyzések

Ha dinamikusan hoz létre egy lapozott panelt, és nem szabályozza annak élettartamát, állítsa az automatikus megsemmisítés módot TRUE értékre. Ha az automatikus megsemmisítés mód IGAZ, a keretrendszer automatikusan megsemmisíti a lapozott panelt.

CBaseTabbedPane::ShowTab

Egy lap megjelenítése vagy elrejtése.

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

Paraméterek

pBar
[in] A megjelenítendő vagy elrejtendő ablaktábla mutatója.

bShow
[in] IGAZ a panel megjelenítéséhez; HAMIS a panel elrejtéséhez.

bDelay
[in] IGAZ a lapelrendezés beállításának késleltetéséhez; egyéb esetben HAMIS.

bAktiválás
[in] IGAZ, hogy a lap legyen aktív lap; egyéb esetben HAMIS.

Visszaadott érték

IGAZ, ha a lap megjelenítése vagy elrejtése sikeres volt; egyéb esetben HAMIS.

Megjegyzések

A metódus meghívásakor a bShow paraméter értékétől függően megjelenik vagy rejtett ablaktábla. Ha elrejt egy lapot, és ez az utolsó látható lap az alapul szolgáló lapablakban, a lapfüles ablaktábla el van rejtve. Ha olyan lapot jelenít meg, amely korábban nem volt látható, megjelenik a füles ablaktábla.

CBaseTabbedPane::RecalcLayout

Újraszámítja a panel elrendezési adatait.

virtual void RecalcLayout();

Megjegyzések

Ha az ablaktábla lebegő, ez a metódus értesíti a keretrendszert, hogy átméretezi az ablaktáblát a minikeret aktuális méretére.

Ha a panel rögzítve van, ez a metódus nem tesz semmit.

CBaseTabbedPane::SetAutoHideMode

Beállítja a levehető ablaktáblák automatikus elrejtő módját a lapozott panelen.

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

Paraméterek

bMode
[in] IGAZ az automatikus elrejtés engedélyezéséhez; HAMIS a normál rögzítési mód engedélyezéséhez.

dwAlignment
[in] A létrehozandó automatikus elrejtési panel igazítását adja meg. A lehetséges értékek listáját a CPane::MoveByAlignment című témakörben találja.

pCurrAutoHideBar
[be, ki] Mutató az aktuális automatikus elrejtő eszköztárra. Null érték is lehet.

bUseTimer
[in] Megadja, hogy az automatikus elrejtő effektust használja-e, amikor a felhasználó automatikus elrejtő módra vált, vagy azonnal elrejti az ablaktáblát.

Visszaadott érték

Az automatikus elrejtés módra váltáskor létrehozott automatikus elrejtő eszköztárra mutató mutató, vagy null értékű, ha nem jön létre eszköztár.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha egy felhasználó a gombostűgombot választja, hogy a lapozott panelt automatikus elrejtési módra vagy normál rögzítési módra váltsa.

Az automatikus elrejtés mód be van állítva a többlapos panel minden leválasztható ablaktáblájához. A nem leválasztható panelek figyelmen kívül lesznek hagyva. További információ: CMFCBaseTabCtrl::EnableTabDetach.

Hívja meg ezt a metódust, ha egy lapozott panelt programozott módon automatikusan elrejtő üzemmódra szeretne váltani. A panelt a fő keretablakhoz kell rögzíteni ( CDockablePane::GetDefaultPaneDividernek érvényes mutatót kell visszaadnia a CPaneDividerhez).

Lásd még

hierarchiadiagram
osztályok
CDockablePane osztály