Megosztás a következőn keresztül:

CDockablePane osztály

  • Cikk

Olyan panelt implementál, amely rögzíthető egy dokkolóhelyen, vagy egy többlapos panelen.

Szintaxis

class CDockablePane : public CPane

Tagok

Nyilvános konstruktorok

Név Leírás
CDockablePane::CDockablePane Létrehoz és inicializál egy CDockablePane objektumot.

Nyilvános metódusok

Név Leírás
CDockablePane::AttachToTabWnd Egy panelt csatol egy másik panelhez. Ez egy többlapos panelt hoz létre.
CDockablePane::CalcFixedLayout A panel téglalapjának méretét adja vissza.
CDockablePane::CanAcceptMiniFrame Meghatározza, hogy a megadott minikeret rögzíthető-e az ablaktáblához.
CDockablePane::CanAcceptPane Meghatározza, hogy egy másik ablaktábla rögzíthető-e az aktuális ablaktáblához.
CDockablePane::CanAutoHide Meghatározza, hogy a panel támogatja-e az automatikus elrejtés módját. (Felülbírálások CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached Meghatározza, hogy az aktuális panel rögzíthető-e egy másik ablaktáblához.
CDockablePane::ConvertToTabbedDocument Egy vagy több dokkolható ablaktáblát MDI-lapozott dokumentumokká alakít át.
CDockablePane::CopyState Egy rögzíthető ablaktábla állapotát másolja át.
CDockablePane::Create Létrehozza a Windows-vezérlőt, és csatolja a CDockablePane objektumhoz.
CDockablePane::CreateDefaultPaneDivider Létrehoz egy alapértelmezett elválasztót a panelhez, miközben egy keretablakhoz van rögzítve.
CDockablePane::CreateEx Létrehozza a Windows-vezérlőt, és csatolja a CDockablePane objektumhoz.
CDockablePane::CreateTabbedPane Többlapos panelt hoz létre az aktuális panelről.
CDockablePane::DockPaneContainer Tároló rögzítése az ablaktáblához.
CDockablePane::DockPaneStandard Tagolásos (standard) rögzítéssel rögzít egy panelt.
CDockablePane::DockToFrameWindow Belsőleg használva. Panel rögzítéséhez használja CPane::DockPane vagy CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos Rögzít egy panelt a tárolt legutóbbi rögzítési pozícióhoz.
CDockablePane::DockToWindow Egy dokkolópanel rögzítése egy másik dokkolópanelre.
CDockablePane::EnableAutohideAll Engedélyezi vagy letiltja az automatikus elrejtés módját ehhez a panelhez a tároló többi ablaktáblájával együtt.
CDockablePane::EnableGripper Megjeleníti vagy elrejti a feliratot (fogó).
CDockablePane::GetAHRestoredRect Az ablaktábla pozícióját adja meg, ha az automatikus elrejtés módban látható.
CDockablePane::GetAHSlideMode Lekéri az ablaktábla automatikus elrejtő üzemmódját.
CDockablePane::GetAutoHideButton Belsőleg használva.
CDockablePane::GetAutoHideToolBar Belsőleg használva.
CDockablePane::GetCaptionHeight Az aktuális felirat magasságát adja vissza.
CDockablePane::GetDefaultPaneDivider A panel tárolójának alapértelmezett ablaktábla-elválasztóját adja vissza.
CDockablePane::GetDockingStatus Meghatározza, hogy egy panel rögzíthető-e a megadott mutatóhely alapján.
CDockablePane::GetDragSensitivity Egy dokkolópanel húzási érzékenységét adja vissza.
CDockablePane::GetLastPercentInPaneContainer Lekéri a panel tárolójában elfoglalt terület százalékos arányát.
CDockablePane::GetTabArea Lekéri a panel lapterületét.
CDockablePane::GetTabbedPaneRTC Visszaadja a futtatókörnyezeti osztály adatait egy lapozott ablakról, amely akkor jön létre, amikor egy másik ablaktábla dokkol az aktuális ablaktáblához.
CDockablePane::HasAutoHideMode Megadja, hogy a dokkolópanel átváltható-e automatikus elrejtési módra.
CDockablePane::HitTest A panel adott helyét adja meg, ahol a felhasználó az egérre kattint.
CDockablePane::IsAccessibilityCompatible Belsőleg használva.
CDockablePane::IsAutohideAllEnabled Azt jelzi, hogy a dokkolópanel és a tároló összes többi ablaktáblája elhelyezhető-e automatikus elrejtési módban.
CDockablePane::IsAutoHideMode Meghatározza, hogy egy panel automatikusan elrejtett módban van-e.
CDockablePane::IsChangeState Belsőleg használva.
CDockablePane::IsDocked Meghatározza, hogy az aktuális panel rögzítve van-e.
CDockablePane::IsHideInAutoHideMode Az automatikus elrejtési módban lévő panel viselkedését határozza meg, ha az ShowPanemeghívásával jelenik meg (vagy rejtett).
CDockablePane::IsInFloatingMultiPaneFrameWnd Megadja, hogy az ablaktábla több ablaktáblás keretablakban van-e.
CDockablePane::IsResizable Megadja, hogy a panel átméretezhető-e.
CDockablePane::IsTabLocationBottom Megadja, hogy a lapok a panel tetején vagy alján találhatók-e.
CDockablePane::IsTracked Megadja, hogy a felhasználó húz-e egy panelt.
CDockablePane::IsVisible Meghatározza, hogy az aktuális panel látható-e.
CDockablePane::LoadState Belsőleg használva.
CDockablePane::OnAfterChangeParent A keretrendszer meghívta, amikor a panel szülője megváltozott. (Felülbírálások CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame A keretrendszer meghívja, amikor egy lebegő dokkolósáv dokkol egy keretablakban.
CDockablePane::OnBeforeChangeParent A keretrendszer hívja meg, amikor a panel szülője módosítani készül. (Felülbírálások CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat A keretrendszer meghívja, amikor egy panel lebegni készül. (Felülbírálások CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier A keretrendszer meghívja ezt a metódust, ha egy panelt nem használ.
CDockablePane::ReplacePane Lecseréli a panelt egy megadott panelre.
CDockablePane::RestoreDefaultPaneDivider A keretrendszer ezt a metódust panelként hívja meg, és deszerializálja az alapértelmezett panelelválasztó visszaállításához.
CDockablePane::SaveState Belsőleg használva.
CDockablePane::Serialize Szerializálja a panelt. (Felülbírálások CBasePane::Serialize.)
CDockablePane::SetAutoHideMode A dokkoló panel váltása a látható és az automatikus elrejtési mód között.
CDockablePane::SetAutoHideParents Beállítja az automatikus elrejtés gombot, és automatikusan elrejti az eszköztárat a panelen.
CDockablePane::SetDefaultPaneDivider Belsőleg használva.
CDockablePane::SetLastPercentInPaneContainer Beállítja, hogy egy panel hány százalékos helyet foglal el a tárolójában.
CDockablePane::SetResizeMode Belsőleg használva.
CDockablePane::SetRestoredDefaultPaneDivider Beállítja a visszaállított alapértelmezett panelelválasztót.
CDockablePane::SetTabbedPaneRTC Beállítja a futtatókörnyezeti osztály adatait egy többlapos ablakhoz, amely akkor jön létre, amikor két ablaktábla egymáshoz rögzít.
CDockablePane::ShowPane Megjeleníti vagy elrejti a panelt.
CDockablePane::Slide Egy olyan panelt jelenít meg vagy rejt el, amely csak akkor jelenik meg, ha az ablaktábla automatikus elrejtése módban van.
CDockablePane::ToggleAutoHide Automatikus elrejtés mód váltása. (Felülbírálások CPane::ToggleAutoHide .)
CDockablePane::UndockPane Az ablaktábla leválasztása a fő keretablakból vagy egy minikeret ablaktárolóból.
CDockablePane::UnSetAutoHideMode Belsőleg használva. Az automatikus elrejtés módjának beállításához használja a CDockablePane::SetAutoHideMode

Védett metódusok

Név Leírás
CDockablePane::CheckAutoHideCondition Meghatározza, hogy a dokkolópanel rejtett-e (automatikus elrejtési módban).
CDockablePane::CheckStopSlideCondition Meghatározza, hogy az automatikusan elrejtett dokkolópanel mikor állítsa le a csúszást.
CDockablePane::DrawCaption Megrajzolja a dokkolópanel feliratát (fogó).
CDockablePane::OnPressButtons Akkor hívjuk, ha a felhasználó a AFX_HTCLOSE és a AFX_HTMAXBUTTON gombtól eltérő feliratgombot lenyom.
CDockablePane::OnSlide A keretrendszer meghívta, hogy megjelenítse vagy elrejtse az automatikusan elrejtett diaeffektust.

Adattagok

Név Leírás
CDockablePane::m_bDisableAnimation Megadja, hogy a dokkolható panel animációjának automatikus elrejtése le van-e tiltva.
CDockablePane::m_bHideInAutoHideMode Meghatározza az ablaktábla viselkedését, amikor a panel automatikusan elrejtési módban van.
CDockablePane::m_nSlideSteps Az ablaktábla animációs sebességét adja meg, ha automatikus elrejtés módban jelenik meg vagy rejtve van.

Megjegyzések

CDockablePane a következő funkciókat valósítja meg:

  • Panel rögzítése egy fő keretablakhoz.

  • Ablaktábla automatikus elrejtés módba váltása.

  • Panel csatolása többlapos ablakhoz.

  • Ablaktábla lebegtetve egy minikeretablakban.

  • Ablaktábla rögzítése egy minikeretablakban lebegő másik ablaktáblára.

  • Panel átméretezése.

  • Állapot betöltése és mentése dokkolópanelen.

    Jegyzet

    Az állapotadatok a Windows-beállításjegyzékbe lesznek mentve.

  • Panel létrehozása felirattal vagy anélkül. A felirat tartalmazhat szövegfeliratot, és színátmenetes színnel is kitölthető.

  • Ablaktábla húzása a panel tartalmának megjelenítése közben

  • Húzza az ablaktáblát egy húzási téglalap megjelenítése közben.

Ha dokkolópanelt szeretne használni az alkalmazásban, származtathatja a panelosztályt a CDockablePane osztályból. Ágyazza be a származtatott objektumot a fő keretablak objektumába, vagy egy ablakobjektumba, amely a panel példányát vezérli. Ezután hívja meg a CDockablePane::Create metódust vagy a CDockablePane::CreateEx metódust, amikor feldolgozza a WM_CREATE üzenetet a fő keretablakban. Végül állítsa be a panelobjektumot CBasePane::EnableDocking, CBasePane::DockPanevagy CDockablePane::AttachToTabWndmeghívásával.

Testreszabási tippek

Az alábbi tippek CDockablePane objektumokra vonatkoznak:

  • Ha két nem többlapos, rögzíthető ablaktábla CDockablePane::AttachToTabWnd hív meg, a ppTabbedControlBar paraméter egy lapozott ablakra mutató mutatót ad vissza. Ezzel a paraméterrel továbbra is hozzáadhat lapokat a lapozott ablakhoz.

  • A CDockablePane::AttachToTabWnd által létrehozott lapozott paneltípust a CDockablePane paraméter pTabControlBarAttachTo objektuma határozza meg. Meghívhatja a CDockablePane::SetTabbedPaneRTC a CDockablePane által létrehozott lapozott ablaktábla típusának beállításához. Az alapértelmezett típust a dwTabbedStyleCDockablePane::Create határozza meg a CDockablePaneelső létrehozásakor. Ha dwTabbedStyleAFX_CBRS_OUTLOOK_TABS az alapértelmezett típus CMFCOutlookBar osztály; ha dwTabbedStyleAFX_CBRS_REGULAR_TABS az alapértelmezett típus CTabbedPane Osztály.

  • Ha az egyik dokkolható panelt egy másikhoz szeretné dokkolni, hívja meg a CDockablePane::DockToWindow metódust. A metódus meghívása előtt az eredeti panelt valahol rögzítve kell lennie.

  • A tagváltozó CDockablePane::m_bHideInAutoHideMode szabályozza, hogy a dokkolható panelek hogyan viselkednek automatikusan elrejtés módban, amikor meghívja CDockablePane::ShowPane. Ha ez a tagváltozó TRUEértékre van állítva, a rögzíthető ablaktáblák és az automatikus elrejtő gombjaik el lesznek rejtve. Ellenkező esetben be- és kicsúsznak.

  • Az automatikus elrejtés letiltásához állítsa a CDockablePane::m_bDisableAnimation tagváltozót TRUE.

Példa

Az alábbi példa bemutatja, hogyan konfigurálhat egy CDockablePane objektumot a CDockablePane osztály különböző metódusaival. A példa bemutatja, hogyan engedélyezheti a dokkolható ablaktábla összes funkciójának automatikus elrejtése, a felirat vagy a fogó engedélyezését, az automatikus elrejtés módját, az ablaktábla megjelenítését és az automatikus elrejtés módban lévő panel animálását. Ez a kódrészlet a Visual Studio Demo mintarésze.

// GetOwner is an inherited method.
CDockablePane *pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());

pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true, false, true);
pParentBar->Slide(true);

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

Követelmények

fejléc:afxDockablePane.h

CDockablePane::AttachToTabWnd

Az aktuális ablaktáblát egy célpanelhez csatolja, és létrehoz egy többlapos ablaktáblát.

virtual CDockablePane* AttachToTabWnd(
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive= TRUE,
    CDockablePane** ppTabbedControlBar = NULL);

Paraméterek

pTabControlBarAttachTo
[be, ki] Azt a célpanelt adja meg, amelyhez az aktuális ablaktábla csatlakozik. A célpanelnek dokkolható panelnek kell lennie.

dockMethod
[in] Megadja a rögzítési módszert.

bSetActive
[in] TRUE a füles panel aktiválásához a csatolási művelet után; ellenkező esetben FALSE.

ppTabbedControlBar
[kifelé] A csatolási művelet eredményeként kapott lapozott panelt tartalmazza.

Visszaadott érték

Az aktuális ablaktábla mutatója, ha nem lapozott ablaktábla; ellenkező esetben a csatolási műveletből származó füles ablaktáblára mutató mutató. A visszatérési érték NULL, ha az aktuális panel nem csatolható, vagy ha hiba történik.

Megjegyzések

Ha az egyik dokkolható ablaktábla ezzel a módszerrel egy másik panelhez csatlakozik, a következő történik:

  1. A keretrendszer ellenőrzi, hogy a célpanel pTabControlBarAttachTo normál dokkolópanel-e, vagy CBaseTabbedPaneszármazik-e.

  2. Ha a célpanel egy többlapos ablaktábla, a keretrendszer lapként hozzáadja az aktuális ablaktáblát.

  3. Ha a célpanel egy normál dokkolópanel, a keretrendszer létrehoz egy többlapos panelt.

    • A keretrendszer meghívja pTabControlBarAttachTo->CreateTabbedPane. Az új lapozott panel stílusa a m_pTabbedControlBarRTC tagtól függ. Alapértelmezés szerint ez a tag a CTabbedPanefuttatókörnyezeti osztályára van állítva. Ha a AFX_CBRS_OUTLOOK_TABS stílust dwTabbedStyle paraméterként adja át a CDockablePane::Create metódusnak, a futtatókörnyezet osztály objektuma a CMFCOutlookBarfuttatókörnyezeti osztályára van állítva. Ezt a tagot bármikor módosíthatja az új panel stílusának módosításához.

    • Ha ez a módszer egy többlapos panelt hoz létre, a keretrendszer az egérmutatót pTabControlBarAttachTo (ha az ablaktábla egy több-minikeretes ablakban van rögzítve vagy lebeg), az új füles ablaktáblára mutató mutatóra cseréli.

    • A keretrendszer első lapként hozzáadja a pTabControlBarAttachTo panelt a lapozott panelhez. A keretrendszer ezután hozzáadja az aktuális panelt második lapként.

  4. Ha az aktuális ablaktábla CBaseTabbedPaneszármazik, az összes lapja át lesz helyezve pTabControlBarAttachTo, és az aktuális ablaktábla megsemmisül. Ezért körültekintően hívja meg ezt a metódust, mert az aktuális panelre mutató mutató érvénytelen lehet a metódus visszatérésekor.

Ha dokkoló elrendezés létrehozásakor csatolja az egyik panelt a másikhoz, állítsa dockMethodDM_SHOWértékre.

Mielőtt egy másik panelt csatol hozzá, rögzítse az első panelt.

CDockablePane::CalcFixedLayout

A panel téglalapjának méretét adja vissza.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paraméterek

bStretch
[in] Nincs használatban.

bHorz
[in] Nincs használatban.

Visszaadott érték

Egy CSize objektum, amely a panel téglalapjának méretét tartalmazza.

CDockablePane::CanAcceptMiniFrame

Meghatározza, hogy a megadott minikeret rögzíthető-e az ablaktáblához.

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

Paraméterek

pMiniFrame
[in] Mutasson egy CPaneFrameWnd objektumra.

Visszaadott érték

TRUE, hogy pMiniFrame rögzíthetők-e a panelen; ellenkező esetben FALSE.

CDockablePane::CanAcceptPane

Meghatározza, hogy egy másik ablaktábla rögzíthető-e az aktuális ablaktáblához.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Paraméterek

pBar
[in] Az aktuális ablaktáblához rögzítendő panelt adja meg.

Visszaadott érték

TRUE, hogy a megadott panel rögzíthető-e ehhez a panelhez; ellenkező esetben FALSE.

Megjegyzések

A keretrendszer meghívja ezt a metódust, mielőtt egy panel az aktuális ablaktáblához lesz rögzítve.

Felülbírálja ezt a függvényt egy származtatott osztályban, hogy engedélyezze vagy tiltsa le a dokkolást egy adott panelen.

Ez a metódus alapértelmezés szerint TRUE ad vissza, ha pBar vagy szülője CDockablePanetípusú.

CDockablePane::CanAutoHide

Meghatározza, hogy a panel képes-e automatikusan elrejteni.

virtual BOOL CanAutoHide() const;

Visszaadott érték

TRUE, hogy a panel automatikusan el tud-e rejteni; ellenkező esetben FALSE.

Megjegyzések

CDockablePane::CanAutoHide az alábbi helyzetekben FALSE ad vissza:

  • A panelen nincs szülő.

  • A dokkolókezelő nem engedélyezi az ablaktáblák automatikus elrejtését.

  • A panel nincs rögzítve.

CDockablePane::CanBeAttached

Meghatározza, hogy az aktuális panel rögzíthető-e egy másik ablaktáblához.

virtual BOOL CanBeAttached() const;

Visszaadott érték

TRUE, hogy a rögzíthető ablaktábla rögzíthető-e egy másik panelre vagy a főkeret ablakára; ellenkező esetben FALSE.

Megjegyzések

Alapértelmezés szerint ez a metódus mindig TRUEad vissza. A metódus felülbírálása származtatott osztályban a dokkolás engedélyezéséhez vagy letiltásához CBasePane::EnableDockingmeghívása nélkül.

CDockablePane::CDockablePane

Létrehoz és inicializál egy CDockablePane objektumot.

CDockablePane();

Megjegyzések

A rögzíthető ablaktábla-objektum létrehozása után hívja meg CDockablePane::Create vagy CDockablePane::CreateEx létrehozásához.

CDockablePane::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] CTabbedPanekonvertálásakor adja meg a TRUE, hogy csak az aktív lapot konvertálja. Adja meg a FALSE a panel összes lapjának konvertálásához.

CDockablePane::CheckAutoHideCondition

Meghatározza, hogy a dokkolópanel rejtett-e (más néven automatikus felfedési mód).

virtual BOOL CheckAutoHideCondition();

Visszaadott érték

TRUE, hogy teljesül-e az elrejtő feltétel; ellenkező esetben FALSE.

Megjegyzések

A keretrendszer időzítővel rendszeresen ellenőrzi, hogy el kívánja-e rejteni az automatikusan rögzíthető ablaktáblát. A metódus TRUE ad vissza, ha az ablaktábla nem aktív, az ablaktábla nincs átméretezve, és az egérmutató nincs az ablaktáblán.

Ha az összes korábbi feltétel teljesül, a keretrendszer meghívja CDockablePane::Slide, hogy elrejtse a panelt.

CDockablePane::CheckStopSlideCondition

Meghatározza, hogy mikor állítsa le az automatikus rögzítési panel csúszását.

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

Paraméterek

bDirection
[in] TRUE, hogy a panel látható-e; FALSE, hogy a panel rejtett-e.

Visszaadott érték

TRUE, hogy teljesül-e a leállítási feltétel; ellenkező esetben FALSE.

Megjegyzések

Ha egy dokkolható panel automatikus megjelenítési módra van beállítva, a keretrendszer csúsztatási effektusokkal jeleníti meg vagy rejti el az ablaktáblát. A keretrendszer akkor hívja meg ezt a függvényt, ha a panel csúszik. CheckStopSlideCondition TRUE ad vissza, ha az ablaktábla teljesen látható vagy teljesen rejtett.

Felülbírálja ezt a metódust egy származtatott osztályban az egyéni automatikus felfedési effektusok implementálásához.

CDockablePane::CopyState

Egy rögzíthető ablaktábla állapotát másolja át.

virtual void CopyState(CDockablePane* pOrgBar);

Paraméterek

pOrgBar
[in] Mutató egy rögzíthető panelre.

Megjegyzések

CDockablePane::CopyState a pOrgBar állapotát az aktuális panelre másolja az alábbi metódusok meghívásával:

CDockablePane::Create

Létrehozza a Windows-vezérlőt, és csatolja a CDockablePane objektumhoz.

virtual BOOL Create(
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE);

Paraméterek

lpszCaption
[in] Megadja az ablak nevét.

pParentWnd
[be, ki] A szülőablakot adja meg.

rect
[in] Az ablak méretét és pozícióját adja meg a pParentWndügyfélkoordinátáiban.

bHasGripper
[in] TRUE a panel felirattal való létrehozásához; ellenkező esetben FALSE.

nID
[in] Megadja a gyermekablak azonosítóját. Ennek az értéknek egyedinek kell lennie, ha menteni szeretné a dokkolás állapotát ehhez a dokkolópanelhez.

dwStyle
[in] Megadja az ablakstílus attribútumait.

dwTabbedStyle
[in] Egy lapozott ablak lapozott stílusát adja meg, amely akkor jön létre, amikor a felhasználó húz egy panelt a panel feliratára.

dwControlBarStyle
[in] További stílusattribútumokat ad meg.

pContext
[be, ki] Megadja az ablak létrehozási környezetét.

lpszWindowName
[in] Megadja az ablak nevét.

sizeDefault
[in] Az ablak méretét adja meg.

Visszaadott érték

TRUE, hogy a rögzíthető panel sikeresen létrejött-e; ellenkező esetben FALSE.

Megjegyzések

Létrehoz egy Windows-panelt, és csatolja az CDockablePane objektumhoz.

Ha a dwStyle ablakstílus CBRS_FLOAT_MULTI jelölővel rendelkezik, a minikeret ablaka a minikeret ablak többi ablakával együtt lebeghet. Alapértelmezés szerint a dokkolópanelek csak egyenként lebeghetnek.

Ha a dwTabbedStyle paraméterben meg van adva a AFX_CBRS_OUTLOOK_TABS jelző, akkor az ablaktábla Outlook-stílusú lapozott ablaktáblákat hoz létre, amikor a CDockablePane::AttachToTabWnd metódussal egy másik ablaktáblát csatol ehhez a panelhez. Alapértelmezés szerint a rögzíthető ablaktáblák normál, CTabbedPanetípusú lapozott ablaktáblákat hoznak létre.

CDockablePane::CreateDefaultPaneDivider

Létrehoz egy alapértelmezett elválasztót a panelhez, miközben egy keretablakhoz van rögzítve.

static CPaneDivider* __stdcall CreateDefaultPaneDivider(
    DWORD dwAlignment,
    CWnd* pParent,
    CRuntimeClass* pSliderRTC = NULL);

Paraméterek

dwAlignment
[in] Annak a fő keretnek az oldalát adja meg, amelyhez az ablaktábla rögzítve van. Ha dwAlignment tartalmazza a CBRS_ALIGN_LEFT vagy CBRS_ALIGN_RIGHT jelzőt, ez a módszer létrehoz egy függőleges (CPaneDivider::SS_VERT) elválasztót; ellenkező esetben ez a metódus vízszintes (CPaneDivider::SS_HORZ) elválasztót hoz létre.

pParent
[in] Mutasson a szülőkeretre.

pSliderRTC
[in] Nincs használatban.

Visszaadott érték

Ez a metódus egy mutatót ad vissza az újonnan létrehozott elválasztóhoz, vagy NULL, ha az elválasztó létrehozása sikertelen.

Megjegyzések

dwAlignment a következő értékek bármelyike lehet:

Érték Leírás
CBRS_ALIGN_TOP A panel a keretablak ügyfélterületének tetejére van rögzítve.
CBRS_ALIGN_BOTTOM A panel a keretablak ügyfélterületének aljára van rögzítve.
CBRS_ALIGN_LEFT A panel a keretablak ügyfélterületének bal oldalára van rögzítve.
CBRS_ALIGN_RIGHT A panel a keretablak ügyfélterületének jobb oldalára van rögzítve.

CDockablePane::CreateEx

Létrehozza a Windows-vezérlőt, és csatolja a CDockablePane objektumhoz.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

Paraméterek

dwStyleEx
[in] Az új ablak kiterjesztett stílusattribútumait adja meg.

lpszCaption
[in] Megadja az ablak nevét.

pParentWnd
[be, ki] A szülőablakot adja meg.

rect
[in] Az ablak méretét és pozícióját adja meg a pParentWndügyfélkoordinátáiban.

bHasGripper
[in] TRUE a panel felirattal való létrehozásához; ellenkező esetben FALSE.

nID
[in] Megadja a gyermekablak azonosítóját. Ennek az értéknek egyedinek kell lennie, ha menteni szeretné a dokkolópanel dokkolási állapotát.

dwStyle
[in] Megadja az ablakstílus attribútumait.

dwTabbedStyle
[in] Egy lapozott ablak lapozott stílusát adja meg, amely akkor jön létre, amikor a felhasználó húz egy panelt a panel feliratára.

dwControlBarStyle
[in] Megadja a további stílusattribútumokat.

pContext
[be, ki] Megadja az ablak létrehozási környezetét.

Visszaadott érték

TRUE, hogy a rögzíthető panel sikeresen létrejött-e; ellenkező esetben FALSE.

Megjegyzések

Létrehoz egy Windows-panelt, és csatolja az CDockablePane objektumhoz.

Ha a dwStyle ablakstílus CBRS_FLOAT_MULTI jelölővel rendelkezik, a minikeret ablaka a minikeret ablak többi ablakával együtt lebeghet. Alapértelmezés szerint a dokkolópanelek csak egyenként lebeghetnek.

Ha a dwTabbedStyle paraméterben meg van adva a AFX_CBRS_OUTLOOK_TABS jelző, akkor az ablaktábla Outlook-stílusú lapozott ablaktáblákat hoz létre, amikor a CDockablePane::AttachToTabWnd metódussal egy másik ablaktáblát csatol ehhez a panelhez. Alapértelmezés szerint a rögzíthető ablaktáblák normál, CTabbedPanetípusú lapozott ablaktáblákat hoznak létre.

CDockablePane::CreateTabbedPane

Többlapos panelt hoz létre az aktuális panelről.

virtual CTabbedPane* CreateTabbedPane();

Visszaadott érték

Az új lapozott ablaktábla, vagy NULL, ha a létrehozási művelet sikertelen volt.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor egy lapozott panelt hoz létre a panel helyére. További információ: CDockablePane::AttachToTabWnd.

Felülbírálja ezt a metódust egy származtatott osztályban a lapozott ablaktáblák létrehozásának és inicializálásának testreszabásához.

A lapozott panel a m_pTabbedControlBarRTC tagban tárolt futtatókörnyezeti osztály adatai alapján jön létre, amelyet a CDockablePane::CreateEx metódus inicializál.

CDockablePane::DockPaneContainer

Tároló rögzítése az ablaktáblához.

virtual BOOL DockPaneContainer(
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment,
    AFX_DOCK_METHOD dockMethod);

Paraméterek

barContainerManager
[in] A rögzített tároló tárolókezelőjének hivatkozása.

dwAlignment
[in] DWORD, amely annak a panelnek az oldalát adja meg, amelyhez a tároló rögzítve van.

dockMethod
[in] Nincs használatban.

Visszaadott érték

TRUE, hogy a tároló sikeresen rögzítette-e a panelt; ellenkező esetben FALSE.

Megjegyzések

dwAlignment a következő értékek bármelyike lehet:

Érték Leírás
CBRS_ALIGN_TOP A tároló a panel tetejére van rögzítve.
CBRS_ALIGN_BOTTOM A tároló a panel aljára van rögzítve.
CBRS_ALIGN_LEFT A tároló a panel bal oldalán van rögzítve.
CBRS_ALIGN_RIGHT A tároló a panel jobb oldalán van rögzítve.

CDockablePane::DockPaneStandard

Tagolásos (standard) rögzítéssel rögzít egy panelt.

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

Paraméterek

bWasDocked
[in] A metódus visszatérésekor ez az érték TRUE tartalmaz, ha a panelt sikeresen rögzítették; ellenkező esetben FALSEtartalmaz.

Visszaadott érték

Ha az ablaktábla többlapos ablakhoz lett rögzítve, vagy ha a rögzítés eredményeként többlapos ablak jött létre, ez a metódus egy mutatót ad vissza a lapozott ablakhoz. Ha a panel egyébként sikeresen rögzítve lett, ez a metódus visszaadja a this mutatót. Ha a rögzítés sikertelen, ez a metódus NULLad vissza.

CDockablePane::DockToRecentPos

Rögzít egy panelt a tárolt rögzítési pozícióhoz.

BOOL CDockablePane::DockToRecentPos();

Visszaadott érték

TRUE, hogy a panel sikeresen rögzítve van-e; ellenkező esetben FALSE.

Megjegyzések

A rögzíthető ablaktáblák a legutóbbi rögzítési adatokat egy CRecentDockSiteInfo objektumban tárolják.

CDockablePane::DockToWindow

Egy dokkolópanel rögzítése egy másik dokkolópanelre.

virtual BOOL DockToWindow(
    CDockablePane* pTargetWindow,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

Paraméterek

pTargetWindow
[be, ki] Megadja azt a rögzíthető ablaktáblát, amelybe ezt a panelt rögzíteni szeretné.

dwAlignment
[in] A panel dokkolásának igazítását adja meg. Lehet CBRS_ALIGN_LEFT, CBRS_ALIGN_TOP, CBRS_ALIGN_RIGHT, CBRS_ALIGN_BOTTOM vagy CBRS_ALIGN_ANY. (Definiálva afxres.h.)

lpRect
[in] A panel dokkoló téglalapját adja meg.

Visszaadott érték

TRUE, hogy a panelt sikeresen rögzítették-e; ellenkező esetben FALSE.

Megjegyzések

Ennek a metódusnak a meghívásával rögzítheti az egyik panelt egy másik panelre a dwAlignmentáltal megadott igazítással.

CDockablePane::DrawCaption

Megrajzolja a dokkolópanel feliratát (más néven fogóját).

virtual void DrawCaption(
    CDC* pDC,
    CRect rectCaption);

Paraméterek

pDC
[in] A rajzhoz használt eszközkörnyezetet jelöli.

rectCaption
[in] A panel feliratának határoló téglalapját adja meg.

Megjegyzések

A keretrendszer meghívja ezt a metódust egy dokkolható ablaktábla feliratának megrajzolásához.

Felülbírálja ezt a metódust egy származtatott osztályban a felirat megjelenésének testreszabásához.

CDockablePane::EnableAutohideAll

Engedélyezi vagy letiltja az automatikus felfedés módját ehhez a panelhez és a tároló többi ablaktáblájához.

void EnableAutohideAll(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] TRUE a dokkolható panel összes funkciójának automatikus megjelenítéséhez; ellenkező esetben FALSE.

Megjegyzések

Ha egy felhasználó a Ctrl billentyűt használja, és a rögzítés gombra kattintva automatikus felfedés módra vált egy ablaktáblát, az ugyanabban a tárolóban lévő összes többi ablaktáblát is automatikus felfedés módba váltja.

Hívja meg ezt a metódust úgy, hogy bEnableFALSE beállítással tiltsa le ezt a funkciót egy adott panelen.

CDockablePane::EnableGripper

Megjeleníti vagy elrejti a feliratot (más néven a fogót).

virtual void EnableGripper(BOOL bEnable);

Paraméterek

bEnable
[in] TRUE a felirat engedélyezéséhez; ellenkező esetben FALSE.

Megjegyzések

Amikor a keretrendszer dokkolható ablaktáblákat hoz létre, még akkor sem rendelkezik WS_STYLE ablakstílusával, ha meg van adva. Ez azt jelenti, hogy a panel felirata egy nem ügyfél-terület, amelyet a keretrendszer szabályoz, de ez a terület eltér a szabványos ablakfelirattól.

A feliratot bármikor megjelenítheti vagy elrejtheti. A keretrendszer elrejti a feliratot, ha egy ablaktábla lapként van hozzáadva egy lapfülhez, vagy ha egy ablaktábla egy minikeretablakban lebeg.

CDockablePane::GetAHRestoredRect

Az ablaktábla pozícióját adja meg automatikus elrejtés módban.

CRect GetAHRestoredRect() const;

Visszaadott érték

Egy CRect objektum, amely automatikus elrejtés módban tartalmazza a panel pozícióját.

Megjegyzések

CDockablePane::GetAHSlideMode

Lekéri az ablaktábla diamódjának automatikus elrejtésére szolgáló módot.

virtual UINT GetAHSlideMode() const;

Visszaadott érték

Egy UINT, amely megadja az ablaktábla automatikus elrejtő üzemmódját. A visszatérési érték lehet AFX_AHSM_MOVE vagy AFX_AHSM_STRETCH, de az implementáció csak AFX_AHSM_MOVEhasznál.

Megjegyzések

CDockablePane::GetCaptionHeight

Az aktuális felirat képpontban kifejezett magasságát adja vissza.

virtual int GetCaptionHeight() const;

Visszaadott érték

A felirat magassága képpontban.

Megjegyzések

A felirat magassága 0, ha a feliratot a CDockablePane::EnableGripper metódus rejtette el, vagy ha a panelen nincs felirat.

CDockablePane::GetDefaultPaneDivider

A panel tárolójának alapértelmezett ablaktábla-elválasztóját adja vissza.

CPaneDivider* GetDefaultPaneDivider() const;

Visszaadott érték

Érvényes CPaneDivider objektum, ha a dokkolható ablaktábla a fő keretablakhoz van rögzítve, vagy NULL, ha a dokkolható ablaktábla nincs rögzítve, vagy lebegő.

Megjegyzések

A panelelválasztókkal kapcsolatos további információkért lásd CPaneDivider osztály.

CDockablePane::GetDockingStatus

Meghatározza, hogy egy panel rögzíthető-e a megadott mutatóhely alapján.

virtual AFX_CS_STATUS GetDockingStatus(
    CPoint pt,
    int nSensitivity);

Paraméterek

pt
[in] A mutató helye a képernyő koordinátáiban.

nSensitivity
[in] A téglalap szélétől képpontban megadott távolságnak kell lennie a dokkolás engedélyezéséhez.

Visszaadott érték

Az alábbi állapotértékek egyike:

AFX_CS_STATUS érték Jelentés
CS_NOTHING Az egérmutató nincs dokkhelyen. A keretrendszer nem rögzíti a panelt.
CS_DOCK_IMMEDIATELY Az egérmutató a dokkoló hely felett található azonnali módban (a panel a DT_IMMEDIATE dokkoló módot használja). A keretrendszer azonnal dokkolja a panelt.
CS_DELAY_DOCK Az egérmutató egy másik dokkolópanelt vagy a főkeret szélét képező dokkolóhely fölé mutat. A keretrendszer késleltetés után dokkolja a panelt. A késéssel kapcsolatos további információkért tekintse meg a Megjegyzések szakaszt.
CS_DELAY_DOCK_TO_TAB Az egérmutató egy dokkolóhelyen található, amely miatt az ablaktábla egy többlapos ablakban van rögzítve. Ez akkor fordul elő, ha az egérmutató egy másik dokkoló ablaktábla felirata vagy egy füles panel lapterülete felett található.

Megjegyzések

A keretrendszer meghívja ezt a metódust egy lebegő ablaktábla dokkolásának kezelésére.

A DT_IMMEDIATE rögzítési módot használó lebegő eszköztárak vagy dokkolópanelek esetében a keretrendszer késlelteti a dock parancsot, hogy a felhasználó a rögzítés előtt ki tudja helyezni az ablakot a szülőkeret ügyfélterületéről. A késés hosszát ezredmásodpercben mérik, és az CDockingManager::m_nTimeOutBeforeToolBarDock adattag szabályozza. A CDockingManager::m_nTimeOutBeforeToolBarDock alapértelmezett értéke 200. Ez a viselkedés a Microsoft Word 2007 dokkolási viselkedését emulálja.

Késleltetett dokkolási állapotok (CS_DELAY_DOCK és CS_DELAY_DOCK_TO_TAB) esetén a keretrendszer csak akkor hajt végre dokkolást, ha a felhasználó fel nem oldja az egérgombot. Ha egy panel a DT_STANDARD rögzítési módot használja, a keretrendszer egy téglalapot jelenít meg a tervezett rögzítési helyen. Ha egy panel a DT_SMART rögzítési módot használja, a keretrendszer intelligens dokkolójelölőket és félig átlátszó téglalapokat jelenít meg a kivetített rögzítési helyen. A panel rögzítési módjának megadásához hívja meg a CBasePane::SetDockingMode metódust. További információ az intelligens dokkolásról: CDockingManager::GetSmartDockingParams.

CDockablePane::GetDragSensitivity

Egy dokkolópanel húzási érzékenységét adja vissza.

static const CSize& GetDragSensitivity();

Visszaadott érték

Egy CSize objektum, amely egy húzásponton középre álló téglalap szélességét és magasságát tartalmazza képpontban. Az húzási művelet addig nem kezdődik, amíg az egérmutató el nem kerül ezen a téglalapon kívülre.

CDockablePane::GetLastPercentInPaneContainer

Lekéri a panel tárolójában elfoglalt terület százalékos arányát (CPaneContainer osztály).

int GetLastPercentInPaneContainer() const;

Visszaadott érték

Egy int, amely meghatározza a panel tárolójában elfoglalt terület százalékos arányát.

Megjegyzések

Ezt a módszert akkor használja a rendszer, ha a tároló módosítja az elrendezését.

CDockablePane::GetTabArea

Lekéri a panel lapterületét.

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

Paraméterek

rectTabAreaTop
[in] GetTabArea kitölti ezt a változót a tabulátorterülettel, ha a lapok a panel tetején találhatók. Ha a lapfülek a panel alján találhatók, a változó üres téglalappal van kitöltve.

rectTabAreaBottom
[in] GetTabArea kitölti ezt a változót a tabulátorterülettel, ha a lapok a panel alján találhatók. Ha a lapfülek a panel tetején találhatók, a változó üres téglalappal van kitöltve.

Megjegyzések

Ez a módszer csak CDockablePane származó és lapfülekkel rendelkező osztályokban használatos. További információ: CTabbedPane::GetTabArea és CMFCOutlookBar::GetTabArea.

CDockablePane::GetTabbedPaneRTC

Visszaadja a futtatókörnyezeti osztály adatait egy lapozott ablakról, amely akkor jön létre, amikor egy másik ablaktábla dokkol az aktuális ablaktáblához.

CRuntimeClass* GetTabbedPaneRTC() const;

Visszaadott érték

A dokkolható panel futtatókörnyezeti osztályának adatai.

Megjegyzések

Hívja meg ezt a metódust a dinamikusan létrehozott többlapos panelek futtatókörnyezeti osztályának adatainak lekéréséhez. Ez akkor fordulhat elő, ha egy felhasználó az egyik ablaktáblát egy másik ablaktábla feliratára húzza, vagy ha meghívja a CDockablePane::AttachToTabWnd metódust, hogy programozott módon hozzon létre egy többlapos panelt két rögzíthető ablaktáblából.

A futtatókörnyezeti osztály adatait a CDockablePane::SetTabbedPaneRTC metódus meghívásával állíthatja be.

CDockablePane::HasAutoHideMode

Megadja, hogy a dokkolópanel átváltható-e automatikus felfedési módra.

virtual BOOL HasAutoHideMode() const;

Visszaadott érték

TRUE, hogy a dokkolható panel automatikus felfedés módra váltható-e; ellenkező esetben FALSE.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban, hogy letiltsa az automatikus felfedési módot egy adott dokkolható panelen.

CDockablePane::HitTest

A panel azon helyét adja meg, ahol a felhasználó az egérre kattint.

virtual int HitTest(
    CPoint point,
    BOOL bDetectCaption = FALSE);

Paraméterek

point
[in] Megadja a tesztelni kívánt pontot.

bDetectCaption
[in] TRUE, hogy HTCAPTION kell-e visszaadni, ha a pont a panel feliratán van; ellenkező esetben FALSE.

Visszaadott érték

Az alábbi értékek egyike:

  • HTNOWHERE, ha point nincs a rögzíthető panelen.

  • HTCLIENT, ha point a dokkolható panel ügyfélterületén van.

  • HTCAPTION, ha point a rögzíthető ablaktábla feliratterületén van.

  • AFX_HTCLOSE, ha point a bezárás gombon van.

  • HTMAXBUTTON, ha point a gombostűn van.

CDockablePane::IsAutohideAllEnabled

Azt jelzi, hogy a dokkolópanel és a tároló összes többi ablaktáblája átváltható-e automatikus felfedési módra.

virtual BOOL IsAutohideAllEnabled() const;

Visszaadott érték

TRUE, hogy a rögzíthető panel és a tároló összes többi ablaktáblája automatikus felfedés módra váltható-e; ellenkező esetben FALSE.

Megjegyzések

A felhasználó úgy engedélyezi az automatikus felfedési módot, hogy a rögzítési gombra kattint, miközben lenyomja a Ctrl billentyűt

A viselkedés engedélyezéséhez vagy letiltásához hívja meg a CDockablePane::EnableAutohideAll metódust.

CDockablePane::IsAutoHideMode

Meghatározza, hogy egy panel automatikusan látható-e.

virtual BOOL IsAutoHideMode() const;

Visszaadott érték

TRUE, ha a dokkolható panel automatikusan megjelenik; ellenkező esetben FALSE.

CDockablePane::IsDocked

Meghatározza, hogy az aktuális panel rögzítve van-e.

virtual BOOL IsDocked() const;

Visszaadott érték

TRUE, hogy a rögzíthető ablaktábla nem minikeretablakhoz tartozik-e, vagy ha egy másik ablaktábla egy minikeretablakban lebeg. FALSE, ha az ablaktábla egy minikeret ablak gyermeke, és nincs más ablaktábla, amely a minikeret ablakához tartozik.

Megjegyzések

Annak megállapításához, hogy az ablaktábla a fő keretablakhoz van-e rögzítve, hívja fel a CDockablePane::GetDefaultPaneDivider. Ha a metódus nemNULL mutatót ad vissza, a panel a fő keretablakban lesz rögzítve.

CDockablePane::IsHideInAutoHideMode

Meghatározza az automatikus felfedési módban lévő panel viselkedését, ha az CDockablePane::ShowPanemeghívásával (vagy rejtettként) jelenik meg.

virtual BOOL IsHideInAutoHideMode() const;

Visszaadott érték

TRUE, hogy a rögzíthető ablaktáblának rejtettnek kell-e lennie automatikus felfedés módban; ellenkező esetben FALSE.

Megjegyzések

Ha egy dokkolható ablaktábla automatikus megjelenítési módban van, az másképp viselkedik, amikor meghívja ShowPane, hogy elrejtse vagy megjelenítse a panelt. Ezt a viselkedést a statikus tag CDockablePane::m_bHideInAutoHideModeszabályozza. Ha ez a tag TRUE, a dokkolható ablaktábla és annak kapcsolódó automatikus felfedő eszköztára vagy automatikus felfedése gombja rejtett vagy megjelenik ShowPanehívásakor. Ellenkező esetben a dokkolható ablaktábla aktiválva vagy inaktiválva van, és a kapcsolódó automatikus felfedés eszköztára vagy automatikus felfedése gombja mindig látható.

Felülbírálja ezt a metódust egy származtatott osztályban az egyes panelek alapértelmezett viselkedésének módosításához.

A m_bHideInAutoHideMode alapértelmezett értéke FALSE.

CDockablePane::IsInFloatingMultiPaneFrameWnd

Megadja, hogy az ablaktábla több ablaktáblás keretablakban (CMultiPaneFrameWnd Class) van-e.

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Visszaadott érték

TRUE, ha az ablaktábla több ablaktáblás keretablakban van; ellenkező esetben FALSE.

Megjegyzések

CDockablePane::IsResizable

Megadja, hogy a panel átméretezhető-e.

virtual BOOL IsResizable() const;

Visszaadott érték

TRUE, hogy a panel méretezhető-e; ellenkező esetben FALSE.

Megjegyzések

Alapértelmezés szerint a rögzíthető panelek átméretezhetők. Az átméretezés megakadályozása érdekében felülbírálja ezt a metódust egy származtatott osztályban, és adja vissza FALSE. Vegye figyelembe, hogy egy FALSE érték sikertelen ASSERT eredményez a CPane::DockPane. Ehelyett a CDockingManager::AddPane használatával rögzíthet egy panelt egy szülőkereten belül.

A nem méretezhető panelek nem lebeghetnek, és nem léphetnek automatikusan elrejtő módba, és mindig a szülőkeret külső szélén találhatók.

CDockablePane::IsTabLocationBottom

Megadja, hogy a lapok a panel tetején vagy alján találhatók-e.

virtual BOOL IsTabLocationBottom() const;

Visszaadott érték

TRUE, hogy a lapok a panel alján találhatók-e; FALSE, hogy a lapok a panel tetején találhatók-e.

Megjegyzések

További információ: CTabbedPane::IsTabLocationBottom.

CDockablePane::IsTracked

Megadja, hogy a felhasználó áthelyez-e egy panelt.

BOOL IsTracked() const;

Visszaadott érték

TRUE, hogy a panel áthelyezése folyamatban van-e; ellenkező esetben FALSE.

CDockablePane::IsVisible

Meghatározza, hogy az aktuális panel látható-e.

virtual BOOL IsVisible() const;

Visszaadott érték

TRUE, hogy a rögzíthető ablaktábla látható-e; ellenkező esetben FALSE.

Megjegyzések

Hívja meg ezt a metódust annak megállapításához, hogy látható-e egy rögzíthető ablaktábla. Ezt a módszert használhatja CWnd::IsWindowVisible meghívása vagy a WS_VISIBLE stílus tesztelése helyett. A visszaadott láthatósági állapot attól függ, hogy az automatikus megjelenítési mód engedélyezve van-e vagy le van tiltva, valamint a CDockablePane::IsHideInAutoHideMode tulajdonság értékétől.

Ha a rögzíthető ablaktábla automatikusan megjelenik, és IsHideInAutoHideMode visszaadja FALSE a láthatósági állapot mindig FALSE.

Ha a dokkolható ablaktábla automatikus felfedés módban van, és IsHideInAutoHideMode visszaadja TRUE a láthatósági állapot a kapcsolódó automatikus felfedés eszköztár láthatósági állapotától függ.

Ha a rögzíthető ablaktábla nincs automatikus felfedési módban, a láthatósági állapotot a CBasePane::IsVisible metódus határozza meg.

## CDockablePane::LoadState

Csak belső használatra. További részletekért tekintse meg a Visual Studio-telepítés mfc mappájában található forráskódot. Például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL LoadState(
   LPCTSTR lpszProfileName = NULL,
   int nIndex = -1,
   UINT uiID = (UINT) -1
);

CDockablePane::m_bDisableAnimation

Megadja, hogy a dokkolható ablaktábla automatikus megjelenítése le van-e tiltva.

AFX_IMPORT_DATA static BOOL m_bDisableAnimation;

CDockablePane::m_bHideInAutoHideMode

Meghatározza a panel viselkedését, amikor a panel automatikusan megjelenik.

AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;

Megjegyzések

Ez az érték az alkalmazás összes dokkolópaneljére hatással van.

Ha ezt a tagot TRUEértékre állítja, a dokkolható ablaktáblák rejtettek vagy a kapcsolódó automatikus felfedő eszköztárakkal és gombokkal jelennek meg, amikor meghívja CDockablePane::ShowPane.

Ha ezt a tagot FALSEértékre állítja, a dokkolható ablaktáblák aktiválódnak vagy inaktiválódnak CDockablePane::ShowPanehívásakor.

CDockablePane::m_nSlideSteps

Automatikus felfedés módban adja meg a panel animációs sebességét.

AFX_IMPORT_DATA static int m_nSlideSteps;

Megjegyzések

A gyorsabb animációs effektus érdekében csökkentse ezt az értéket. A lassabb animációs effektus érdekében növelje ezt az értéket.

CDockablePane::OnAfterChangeParent

További részletekért tekintse meg a Visual Studio-telepítés mfc mappájában található forráskódot. Például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Paraméterek

[in] pWndOldParent

Megjegyzések

CDockablePane::OnAfterDockFromMiniFrame

A keretrendszer meghívja, amikor egy lebegő dokkolósáv dokkol egy keretablakban.

virtual void OnAfterDockFromMiniFrame();

Megjegyzések

Alapértelmezés szerint ez a metódus nem tesz semmit.

CDockablePane::OnBeforeChangeParent

A keretrendszer meghívja ezt a metódust, mielőtt megváltoztatja a panel szülőját.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

Paraméterek

pWndNewParent
[in] Mutató az új szülőablakra.

bDelay
[in] BOOL, amely megadja, hogy késleltetni kell-e a dokkolás elrendezésének újraszámítását, ha a panel nincs kijelzve. További információ: CDockablePane::UndockPane.

Megjegyzések

Ha az ablaktábla rögzítve van, és az új szülő nem engedélyezi a dokkolást, ez a metódus leválasztja az ablaktáblát.

Ha a panelt többlapos dokumentummá konvertálja, ez a metódus tárolja a legutóbbi rögzítési pozícióját. A keretrendszer a legutóbbi rögzítési pozícióval állítja vissza a panel pozícióját, amikor vissza lett állítva rögzített állapotba.

CDockablePane::OnBeforeFloat

A keretrendszer meghívja ezt a metódust, mielőtt egy panel lebegő állapotba vált.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

Paraméterek

rectFloat
[in] Meghatározza a panel helyét és méretét, ha lebegő állapotban van.

dockMethod
[in] Megadja a rögzítési módszert. A lehetséges értékek listáját lásd a CPane::DockPane.

Visszaadott érték

TRUE, hogy a panel lebegtethető-e; ellenkező esetben FALSE.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor egy panel lebegni készül. Ezt a metódust felülbírálhatja egy származtatott osztályban, ha bármilyen feldolgozást szeretne végrehajtani, mielőtt a panel lebeg.

CDockablePane::OnPressButtons

Akkor hívjuk, ha a felhasználó a AFX_HTCLOSE és a AFX_HTMAXBUTTON gombtól eltérő feliratgombot lenyom.

virtual void OnPressButtons(UINT nHit);

Paraméterek

nHit
[in] Ezt a paramétert nem használja a rendszer.

Megjegyzések

Ha egyéni gombot ad hozzá egy rögzíthető panel feliratához, felülbírálja ezt a módszert, hogy értesítéseket kapjon, amikor egy felhasználó megnyomja a gombot.

CDockablePane::OnSlide

A keretrendszer meghívta, hogy automatikus felfedés módban animálja a panelt.

virtual void OnSlide(BOOL bSlideOut);

Paraméterek

bSlideOut
[in] TRUE a panel megjelenítéséhez; FALSE a panel elrejtéséhez.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban az egyéni automatikus felfedési effektusok implementálásához.

CDockablePane::RemoveFromDefaultPaneDividier

A keretrendszer meghívja ezt a metódust, ha egy panelt nem használ.

void RemoveFromDefaultPaneDividier();

Megjegyzések

Ez a metódus beállítja az alapértelmezett ablaktábla-elválasztót NULL, és eltávolítja a panelt a tárolóból.

CDockablePane::ReplacePane

Lecseréli a panelt egy megadott panelre.

BOOL ReplacePane(
    CDockablePane* pBarToReplaceWith,
    AFX_DOCK_METHOD dockMethod,
    BOOL bRegisterWithFrame = FALSE);

Paraméterek

pBarToReplaceWith
[in] Mutató egy rögzíthető panelre.

dockMethod
[in] Nincs használatban.

bRegisterWithFrame
[in] Ha TRUE, az új panel regisztrálva lesz a régi panel szülőjének dokkolókezelőjében. Az új ablaktábla a régi panel indexére kerül a dokkolókezelő által fenntartott ablaktáblák listájában.

Visszaadott érték

TRUE, ha a csere sikeres; ellenkező esetben FALSE.

CDockablePane::RestoreDefaultPaneDivider

Ha egy panel deszerializálva van, a keretrendszer meghívja ezt a metódust az alapértelmezett panelelosztó visszaállítására.

void RestoreDefaultPaneDivider();

Megjegyzések

Ha létezik, a visszaállított alapértelmezett ablaktábla-elválasztó lecseréli az aktuális alapértelmezett ablaktábla-elválasztót.

CDockablePane::SetAutoHideMode

A dokkolópanel váltása a látható és az automatikus felfedési mód között.

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

Paraméterek

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

dwAlignment
[in] Megadja az automatikusan létrehozandó ablaktábla igazítását.

pCurrAutoHideBar
[be, ki] Mutató az aktuális automatikus felfedés eszköztárára. Lehet NULL.

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

Visszaadott érték

Az automatikus felfedés módra váltás vagy NULLeredményeként létrehozott automatikus felfedés eszköztár.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha egy felhasználó a rögzítés gombra kattint, hogy a rögzíthető panelt automatikus felfedési módra vagy normál rögzítési módra váltsa.

Hívja meg ezt a módszert, ha egy dokkolható panelt programozott módon szeretne automatikusan felfedni. A panelt a fő keretablakhoz kell rögzíteni (CDockablePane::GetDefaultPaneDivider érvényes mutatót kell visszaadnia a CPaneDivider).

CDockablePane::SetAutoHideParents

Beállítja az automatikus elrejtés gombot, és automatikusan elrejti az eszköztárat a panelen.

void SetAutoHideParents(
    CMFCAutoHideBar* pToolBar,
    CMFCAutoHideButton* pBtn);

Paraméterek

pToolBar
[in] Mutasson egy automatikus elrejtő eszköztárra.

pBtn
[in] Mutasson egy automatikus elrejtés gombra.

CDockablePane::SetLastPercentInPaneContainer

Beállítja a panel tárolójában elfoglalt terület százalékos arányát.

void SetLastPercentInPaneContainer(int n);

Paraméterek

n
[in] Egy int, amely meghatározza a panel tárolójában elfoglalt terület százalékos arányát.

Megjegyzések

A keretrendszer úgy módosítja a panelt, hogy az új értéket használja az elrendezés újraszámításakor.

CDockablePane::SetRestoredDefaultPaneDivider

Beállítja a visszaállított alapértelmezett panelelválasztót.

void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);

Paraméterek

hRestoredSlider
[in] Fogópont egy panelelválasztóhoz (csúszkához).

Megjegyzések

Az ablaktábla deszerializálásakor a rendszer visszaállított alapértelmezett panelelválasztót kap. További információ: CDockablePane::RestoreDefaultPaneDivider.

CDockablePane::SetTabbedPaneRTC

Beállítja a futtatókörnyezeti osztály adatait egy többlapos ablakhoz, amely akkor jön létre, amikor két ablaktábla egymáshoz rögzít.

void SetTabbedPaneRTC(CRuntimeClass* pRTC);

Paraméterek

pRTC
[in] A többlapos panel futtatókörnyezeti osztályának adatai.

Megjegyzések

Hívja meg ezt a metódust a dinamikusan létrehozott többlapos panelek futtatókörnyezeti osztályadatainak beállításához. Ez akkor fordulhat elő, ha egy felhasználó az egyik ablaktáblát egy másik ablaktábla feliratára húzza, vagy ha meghívja a CDockablePane::AttachToTabWnd metódust, hogy programozott módon hozzon létre egy többlapos panelt két rögzíthető ablaktáblából.

Az alapértelmezett futtatókörnyezeti osztály a dwTabbedStyle és CDockablePane::CreateCDockablePane::CreateEx paraméterének megfelelően van beállítva. Az új lapozott panelek testreszabásához az osztályt az alábbi osztályok egyikéből származtathatja:

Ezután hívja meg ezt a metódust a futtatókörnyezeti osztály adataira mutató mutatóval.

CDockablePane::ShowPane

Megjeleníti vagy elrejti a panelt.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Paraméterek

bShow
[in] TRUE a panel megjelenítéséhez; FALSE a panel elrejtéséhez.

bDelay
[in] TRUE a dokkolás elrendezésének késleltetéséhez; FALSE a rögzítési elrendezés azonnali módosításához.

bActivate
[in] TRUE a panel aktiválásához, amikor megjelenik; ellenkező esetben FALSE.

Megjegyzések

Hívja meg ezt a metódust a CWnd::ShowWindow helyett a rögzíthető ablaktáblák megjelenítésekor vagy elrejtésekor.

CDockablePane::Slide

Automatikusan megjelenő módban lévő panel animálása.

virtual void Slide(
    BOOL bSlideOut,
    BOOL bUseTimer = TRUE);

Paraméterek

bSlideOut
[in] TRUE a panel megjelenítéséhez; FALSE a panel elrejtéséhez.

bUseTimer
[in] TRUE a panel automatikus megjelenítési effektussal való megjelenítéséhez vagy elrejtéséhez; FALSE a panel azonnali megjelenítéséhez vagy elrejtéséhez.

Megjegyzések

A keretrendszer ezt a metódust automatikusan megjelenő panel animálására hívja meg.

Ez a módszer a CDockablePane::m_nSlideDefaultTimeOut értékkel határozza meg a diaeffektus időtúllépését. Az időtúllépés alapértelmezett értéke 1. Ha testre szabja az automatikus felfedés algoritmusát, módosítsa ezt a tagot az időtúllépés módosításához.

CDockablePane::ToggleAutoHide

A mindig látható és az automatikus elrejtés mód között váltja a panelt.

virtual void ToggleAutoHide();

Megjegyzések

Ez a metódus a panel automatikus elrejtési módját váltja ki a CDockablePane::SetAutoHideModemeghívásával.

CDockablePane::UndockPane

Az ablaktábla leválasztása a fő keretablakból vagy egy minikeret ablaktárolóból.

virtual void UndockPane(BOOL bDelay = FALSE);

Paraméterek

bDelay
[in] TRUE a dokkolás elrendezésének kiszámításának késleltetéséhez; FALSE a dokkolás elrendezésének azonnali újraszámításához.

Megjegyzések

Ennek a metódusnak a meghívásával leválaszthat egy panelt a fő keretablakból vagy egy több minikeretes ablaktárolóból (egy olyan panelről, amely egyetlen minikeretablakban lebeg más ablaktáblákkal).

A CDockingManageráltal nem végrehajtott külső művelet végrehajtása előtt le kell vennie a panelt. Ha például egy panelt programozott módon szeretne áthelyezni egyik helyről a másikra, le kell húznia a panelt.

A keretrendszer automatikusan leválasztja a paneleket, mielőtt azok megsemmisülnének.

Lásd még:

hierarchiadiagram
osztályok
CPane osztály