Megosztás:

CBasePane osztály

Alaposztály az MFC összes ablaktáblájához.

Szemantika

class CBasePane : public CWnd

Tagok

Nyilvános konstruktorok

Név Leírás
CBasePane::CBasePane Alapértelmezett konstruktor.
CBasePane::~CBasePane Destruktor.

Nyilvános metódusok

Név Leírás
CBasePane::accHitTest A keretrendszer meghívta, hogy lekérje a gyermekelemet vagy a gyermekobjektumot a képernyő egy adott pontján. (Felülbírálások CWnd::accHitTest.)
CBasePane::accLocation A keretrendszer meghívta a megadott objektum aktuális képernyőhelyének lekéréséhez. (Felülbírálja a CWnd::accLocation parancsot.)
CBasePane::AccNotifyObjectFocusEvent CBasePane nem használja ezt a módszert.
CBasePane::accSelect A keretrendszer meghívta a kijelölés módosítására vagy a megadott objektum billentyűzetfókuszának áthelyezésére. (Felülbírálások CWnd::accSelect.)
CBasePane::AddPane Panelt ad hozzá a dokkolókezelőhöz.
CBasePane::AdjustDockingLayout Átirányít egy hívást a dokkolókezelőnek a dokkolás elrendezésének módosításához.
CBasePane::AdjustLayout A keretrendszer meghívja, amikor a panelnek módosítania kell a belső elrendezését.
CBasePane::CalcFixedLayout Kiszámítja a vezérlősáv vízszintes méretét.
CBasePane::CanAcceptPane Meghatározza, hogy egy másik panel rögzíthető-e az ablaktáblához.
CBasePane::CanAutoHide Meghatározza, hogy a panel támogatja-e az automatikus elrejtés módját.
CBasePane::CanBeAttached Meghatározza, hogy az ablaktábla rögzíthető-e egy másik ablaktáblához.
CBasePane::CanBeClosed Meghatározza, hogy a panel bezárható-e.
CBasePane::CanBeDocked Meghatározza, hogy az ablaktábla rögzíthető-e egy másik ablaktáblához.
CBasePane::CanBeResized Meghatározza, hogy a panel átméretezhető-e.
CBasePane::CanBeTabbedDocument Megadja, hogy a panel átalakítható-e MDI-lapozott dokumentummá.
CBasePane::CanFloat Meghatározza, hogy a panel lebeghet-e.
CBasePane::CanFocus Megadja, hogy a panel kap-e fókuszt.
CBasePane::CopyState Egy adott panel állapotának másolása.
CBasePane::CreateDefaultMiniframe Ha az ablaktábla lebegni tud, létrehoz egy minikeretablakot.
CBasePane::CreateEx Létrehozza a panel vezérlőelemet.
CBasePane::D ockPane Egy panel rögzítése egy másik ablaktáblára vagy egy keretablakra.
CBasePane::D ockPaneUsingRTTI A munkaablak rögzítése futásidejű típusadatok használatával.
CBasePane::D ockToFrameWindow Rögzít egy rögzíthető panelt egy kerethez.
CBasePane::D oesAllowDynInsertBefore Meghatározza, hogy egy másik ablaktábla dinamikusan beszúrható-e a panel és a szülőkeret közé.
CBasePane::EnableDocking Engedélyezi a panel rögzítését a főkerethez.
CBasePane::EnableGripper Engedélyezi vagy letiltja a fogót. Ha a markoló engedélyezve van, a felhasználó húzással áthelyezheti a panelt.
CBasePane::FillWindowRect Belsőleg használva.
CBasePane::FloatPane Lebegteti a panelt.
CBasePane::get_accChild A keretrendszer meghívta, hogy lekérje a megadott gyermek IDispatch felületének címét. (Felülbírálások CWnd::get_accChild.)
CBasePane::get_accChildCount A keretrendszer meghívta, hogy lekérje az objektumhoz tartozó gyermekek számát. (Felülbírálások CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction A keretrendszer meghívta, hogy lekérjen egy sztringet, amely leírja az objektum alapértelmezett műveletét. (Felülbírálások CWnd::get_accDefaultAction.)
CBasePane::get_accDescription Keretrendszer által meghívva lekérhet egy sztringet, amely leírja a megadott objektum vizuális megjelenését. (Felülbírálások CWnd::get_accDescription.)
CBasePane::get_accFocus A keretrendszer meghívta, hogy lekérje a billentyűzetfókuszú objektumot. (Felülbírálja a CWnd::get_accFocus.)
CBasePane::get_accHelp A keretrendszer meghívta az objektum súgótulajdonság-sztringjének lekéréséhez. (Felülbírálja a CWnd::get_accHelp.)
CBasePane::get_accHelpTopic A keretrendszer meghívta, hogy lekérje a megadott objektumhoz társított WinHelp-fájl teljes elérési útját és a fájlban található megfelelő témakör azonosítóját. (Felülbírálja a CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut A keretrendszer meghívta az objektumhoz megadott billentyűparancs lekéréséhez. (Felülbírálja a CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName A keretrendszer meghívta a megadott objektum nevét. (Felülbírálja a CWnd::get_accName.)
CBasePane::get_accParent A keretrendszer meghívta az IDispatch objektum szülőfelületének lekéréséhez. (Felülbírálja a CWnd::get_accParent.)
CBasePane::get_accRole A keretrendszer meghívta a megadott objektum szerepkörét leíró információk lekérésére. (Felülbírálja a CWnd::get_accRole.)
CBasePane::get_accSelection A keretrendszer meghívta, hogy lekérje az objektum kiválasztott gyermekeit. (Felülbírálja a CWnd::get_accSelection.)
CBasePane::get_accState A keretrendszer meghívta a megadott objektum aktuális állapotának lekéréséhez. (Felülbírálja a CWnd::get_accState.)
CBasePane::get_accValue A keretrendszer meghívta a megadott objektum értékének lekéréséhez. (Felülbírálja a CWnd::get_accValue.)
CBasePane::GetCaptionHeight A felirat magasságát adja vissza.
CBasePane::GetControlBarStyle A vezérlősáv stílusát adja vissza.
CBasePane::GetCurrentAlignment Az aktuális panel igazítását adja vissza.
CBasePane::GetDockingMode A panel aktuális rögzítési módját adja vissza.
CBasePane::GetDockSiteFrameWnd Egy mutatót ad vissza arra az ablakra, amely az ablaktábla dokkolóhelye.
CBasePane::GetEnabledAlignment A panelre alkalmazott CBRS_ALIGN_ stílusokat adja vissza.
CBasePane::GetMFCStyle Az MFC-hez tartozó panelstílusokat adja vissza.
CBasePane::GetPaneIcon Egy fogópontot ad vissza a panel ikonjához.
CBasePane::GetPaneRect Belsőleg használva.
CBasePane::GetPaneRow Egy mutatót ad vissza arra a CDockingPanesRow objektumra, ahol a panel rögzítve van.
CBasePane::GetPaneStyle A panel stílusát adja vissza.
CBasePane::GetParentDockSite Egy mutatót ad vissza a szülő dokkolóhelyre.
CBasePane::GetParentMiniFrame A szülő minikeret ablakára mutató mutatót ad vissza.
CBasePane::GetParentTabbedPane A szülőlapos panelre mutató mutatót ad vissza.
CBasePane::GetParentTabWnd A lapon található szülőablakra mutató mutatót ad vissza.
CBasePane::GetRecentVisibleState A keretrendszer ezt a metódust hívja meg, amikor egy panelt visszaállít egy archívumból.
CBasePane::HideInPrintPreviewMode Megadja, hogy a panel rejtett-e a nyomtatási képben.
CBasePane::InsertPane Regisztrálja a megadott panelt a dokkolókezelővel.
CBasePane::IsAccessibilityCompatible Megadja, hogy a panel támogatja-e az aktív akadálymentességet.
CBasePane::IsAutoHideMode Meghatározza, hogy egy panel automatikusan elrejtett módban van-e.
CBasePane::IsDialogControl Megadja, hogy a panel párbeszédpanel-vezérlő-e.
CBasePane::IsDocked Meghatározza, hogy a panel rögzítve van-e.
CBasePane::IsFloating Meghatározza, hogy a panel lebegő-e.
CBasePane::IsHorizontal Meghatározza, hogy a panel vízszintesen van-e rögzítve.
CBasePane::IsInFloatingMultiPaneFrameWnd Megadja, hogy az ablaktábla több ablaktáblás keretablakban van-e.
CBasePane::IsMDITabbed Meghatározza, hogy az ablaktábla többlapos dokumentumként lett-e hozzáadva egy MDI-gyermekablakhoz.
CBasePane::IsPaneVisible Megadja, hogy a WS_VISIBLE jelző be van-e állítva a panelen.
CBasePane::IsPointNearDockSite Meghatározza, hogy egy megadott pont a dokkhely közelében van-e.
CBasePane::IsResizable Meghatározza, hogy a panel átméretezhető-e.
CBasePane::IsRestoredFromRegistry Meghatározza, hogy a panel visszaállítva van-e a beállításjegyzékből.
CBasePane::IsTabbed Meghatározza, hogy az ablaktábla be lett-e szúrva egy lapfül vezérlőelembe.
CBasePane::IsTooltipTopmost Belsőleg használva.
CBasePane::IsVisible Meghatározza, hogy a panel látható-e.
CBasePane::LoadState Betölti a panel állapotát a beállításjegyzékből.
CBasePane::MoveWindow Áthelyezi a panelt.
CBasePane::OnAfterChangeParent A keretrendszer meghívta a panel szülőjének módosításakor.
CBasePane::OnBeforeChangeParent A keretrendszer meghívta, mielőtt a panel módosítja a szülőablakát.
CBasePane::OnDrawCaption A keretrendszer ezt a metódust hívja meg a felirat rajzolásakor.
CBasePane::OnMovePaneDivider Ez a metódus jelenleg nem használható.
CBasePane::OnPaneContextMenu A keretrendszer meghívja, amikor egy panellistát tartalmazó menüt hoz létre.
CBasePane::OnRemoveFromMiniFrame A keretrendszer meghívja, amikor egy panel el van távolítva a szülő minikeret ablakából.
CBasePane::OnSetAccData CBasePane nem használja ezt a módszert.
CBasePane::OnUpdateCmdUI Belsőleg használva.
CBasePane::P aneFromPoint Az adott pontot tartalmazó panelt adja vissza.
CBasePane::PreTranslateMessage A CWinApp az TranslateMessage és DispatchMessage Windows-függvényekhez való küldés előtt fordítja le az ablaküzeneteket. (Felülbírálások CWnd::P reTranslateMessage.)
CBasePane::RecalcLayout CBasePane nem használja ezt a módszert.
CBasePane::RemovePaneFromDockManager Törli a panel regisztrációját, és eltávolítja azt a dokkolókezelő listájából.
CBasePane::SaveState Menti a panel állapotát a beállításjegyzékbe.
CBasePane::SelectDefaultFont Kiválasztja egy adott eszközkörnyezet alapértelmezett betűtípusát.
CBasePane::Serialize Beolvassa vagy beírja ezt az objektumot egy archívumból vagy egy archívumba. (Felülbírálja a CObject::Serialize parancsot.)
CBasePane::SetControlBarStyle Beállítja a vezérlősáv stílusát.
CBasePane::SetDockingMode Beállítja a panel dokkolási módját.
CBasePane::SetMDITabbed Belsőleg használva.
CBasePane::SetPaneAlignment Beállítja a panel igazítását.
CBasePane::SetPaneRect Belsőleg használva.
CBasePane::SetPaneStyle Beállítja a panel stílusát.
CBasePane::SetRestoredFromRegistry Belsőleg használva.
CBasePane::SetWindowPos Módosítja a panel méretét, pozícióját és Z-sorrendjét.
CBasePane::ShowPane Megjeleníti vagy elrejti a panelt.
CBasePane::StretchPane Függőlegesen vagy vízszintesen feszíti a panelt.
CBasePane::UndockPane Eltávolítja a panelt a dokkolás helyéről, az alapértelmezett csúszkáról vagy a minikeret ablakáról, ahol jelenleg rögzítve van.

Védett metódusok

Név Leírás
CBasePane::D oPaint Kitölti a panel hátterét.

Megjegyzések

Ha olyan panelosztályt szeretne létrehozni, amely támogatja az MFC-ben elérhető kiterjesztett dokkolási funkciókat, akkor azt a CBasePane vagy abból kell származtatnia.

Testreszabási tippek

Az alábbi testreszabási tippek a CBasePane Class tőle öröklő osztályokra vonatkoznak:

  • Panel létrehozásakor számos új stílust alkalmazhat:

    • AFX_CBRS_FLOAT lebegteti a panelt.

    • AFX_CBRS_AUTOHIDE engedélyezi az automatikus elrejtés módját.

    • AFX_CBRS_CLOSE lehetővé teszi a panel bezárását (rejtett).

    Ezek olyan jelzők, amelyeket bitenkénti VAGY művelettel kombinálhat.

CBasePane A következő virtuális logikai metódusokat implementálja a következő jelzőknek megfelelően: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. A viselkedésük testreszabásához felülbírálhatja őket származtatott osztályokban.

  • A dokkolás viselkedését a CBasePane::CanAcceptPane felülbírálásával szabhatja testre. A metódus hamis értéket ad vissza a panelnek, hogy megakadályozza, hogy egy másik ablaktábla hozzá legyen rögzítve.

  • Ha olyan statikus ablaktáblát szeretne létrehozni, amely nem tud lebegni, és amely megakadályozza, hogy bármely más ablaktábla rögzítsen előtte (hasonlóan az OutlookDemo-példában látható Outlook-sávhoz), hozza létre nem lebegőként, és felülbírálja a CBasePane::D oesAllowDynInsertBefore értéket a FALSE visszaadásához. Az alapértelmezett implementáció HAMIS értéket ad vissza, ha a panel AFX_CBRS_FLOAT stílus nélkül jön létre.

  • Hozza létre az összes panelt a -1 azonosítótól eltérő azonosítókkal.

  • A panel láthatóságának meghatározásához használja a CBasePane::IsVisible parancsot. Megfelelően kezeli a láthatósági állapotot többlapos és automatikus elrejtés módban.

  • Ha nem lebegő átméretezhető panelt szeretne létrehozni, hozza létre a AFX_CBRS_FLOAT stílus nélkül, és hívja meg a CFrameWnd::D ockControlBar parancsot.

  • Ha ki szeretne zárni egy panelt egy dokkolóelrendezésből, vagy el szeretne távolítani egy eszköztárat a dokkolósávról, hívja meg a CBasePane::UndockPane parancsot. Ne hívja meg ezt a metódust automatikus elrejtési módban lévő ablaktáblákhoz vagy többlapos ablakok lapjaihoz.

  • Ha automatikus elrejtés módban lévő panelt szeretne lebegtetni vagy leválasztani, a CDockablePane::SetAutoHideMode with FALSE (Hamis) értéket kell meghívnia első argumentumként a CBasePane::FloatPane vagy CBasePane::UndockPane hívása előtt.

példa

Az alábbi példa bemutatja, hogyan használhat különböző metódusokat a CBasePane osztályban. A példa bemutatja, hogyan kérhető le egy ablaktábla az CFrameWndEx osztályból, és hogyan állíthatja be a rögzítési módot, az ablaktábla igazítását és a panel stílusát. A kód a Word Pad-mintából származik.

// This CMainFrame class extends the CFrameWndEx class.
// GetPane is a method in the CFrameWndEx class which
// Returns a pointer to the pane that has the specified ID.
CBasePane *pBar = GetPane(ID_VIEW_FORMATBAR);
if (pBar != NULL)
{
    // Set the docking mode, the pane alignment, and the pane style.
    pBar->SetDockingMode(DT_STANDARD);
    pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
    pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
    pBar->ShowPane(TRUE, FALSE, FALSE);
}

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CBasePane

Követelmények

Fejléc: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane nem használja ezt a módszert.

virtual void AccNotifyObjectFocusEvent(int);

Paraméterek

Int
[in] Nincs használatban.

CBasePane::AddPane

Panelt ad hozzá a dokkolókezelőhöz.

void AddPane(CBasePane* pBar);

Paraméterek

pBar
[in] A hozzáadni kívánt ablaktábla mutatója.

Megjegyzések

Ez egy egyszerű módszer, amely panelt ad hozzá egy dokkolókezelőhöz. Ezzel a módszerrel nem kell olyan kódot írnia, amely elemzi a szülőkeret típusát.

További információ: CDockingManager Osztály és CMDIFrameWndEx::AddPane.

CBasePane::AdjustDockingLayout

Átirányít egy hívást a dokkolókezelőnek a dokkolás elrendezésének módosításához.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Paraméterek

hdwp
[kifelé] Több ablakpozíciót tartalmazó szerkezet fogópontja.

Megjegyzések

Ez egy kényelmi módszer, amely módosítja a dokkolás elrendezését. Ezzel a módszerrel nem kell olyan kódot írnia, amely elemzi a szülőkeret típusát.

További információ: CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

A keretrendszer meghívta a panel belső elrendezésének módosítására.

virtual void AdjustLayout();

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha egy panelnek módosítania kell a belső elrendezését. Az alap implementáció nem tesz semmit.

CBasePane::CalcFixedLayout

Kiszámítja a vezérlősáv vízszintes méretét.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paraméterek

bStretch
[in] Azt jelzi, hogy a sávot a keret méretéhez kell-e nyúlni. A bStretch paraméter nem rúd, ha a sáv nem dokkolósáv (dokkoláshoz nem érhető el), és 0, ha dokkolt vagy lebegő (dokkolható).

bHorz
[in] Azt jelzi, hogy a sáv vízszintesen vagy függőlegesen orientált. A bHorz paraméter nem nulla, ha a sáv vízszintesen orientált, és függőlegesen 0.

Visszaadott érték

Egy objektum vezérlősávjának CSize mérete képpontban.

Megjegyzések

Lásd a CControlBar megjegyzések szakaszát::CalcFixedLayout

CBasePane::CanAcceptPane

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

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Paraméterek

pBar
[in] A dokkolandó ablaktábla mutatója.

Visszaadott érték

IGAZ, ha egy másik panel is elfogadható; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, mielőtt a pBar által megadott panelt az aktuális panelre rögzítené.

Ezt a módszert és a CBasePane::CanBeDocked metódust használva szabályozhatja, hogy a panelek hogyan rögzíthetők az alkalmazás más paneljeihez.

Az alapértelmezett implementáció HAMIS értéket ad vissza.

CBasePane::CanAutoHide

Meghatározza, hogy a panel támogatja-e az automatikus elrejtés módját.

virtual BOOL CanAutoHide() const;

Visszaadott érték

IGAZ, ha ez a panel támogatja az automatikus elrejtés módját; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a függvényt annak meghatározására, hogy a panel támogatja-e az automatikus elrejtés módot.

Az építés során ezt a képességet úgy állíthatja be, hogy átadja a AFX_CBRS_AUTOHIDE jelzőt a CBasePane::CreateEx fájlnak.

Az alapértelmezett implementáció ellenőrzi a AFX_CBRS_AUTOHIDE jelzőt. A viselkedés testreszabásához felülbírálja ezt a metódust egy származtatott osztályban.

CBasePane::CanBeAttached

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

virtual BOOL CanBeAttached() const;

Visszaadott érték

IGAZ, ha az ablaktábla rögzíthető egy másik ablaktáblára vagy keretablakra; egyéb esetben HAMIS.

Megjegyzések

Az alapértelmezett implementáció HAMIS értéket ad vissza. Bírálja felül ezt a metódust egy származtatott osztályban, hogy engedélyezze vagy tiltsa le a dokkolás képességét a CBasePane::EnableDocking hívása nélkül.

CBasePane::CanBeClosed

Meghatározza, hogy a panel bezárható-e.

virtual BOOL CanBeClosed() const;

Visszaadott érték

IGAZ, ha a panel bezárható; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a panel bezárható-e. Ha a metódus IGAZ értéket ad vissza, a rendszer hozzáad egy Bezárás gombot a panel címsorához, vagy ha az ablaktábla lebegő, a panel minikeretablakának címsorához.

Az építés során ezt a képességet úgy állíthatja be, hogy átadja a AFX_CBRS_CLOSE jelzőt a CBasePane::CreateEx fájlnak.

Az alapértelmezett implementáció ellenőrzi a AFX_CBRS_CLOSE jelzőt.

CBasePane::CanBeDocked

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

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Paraméterek

pDockBar
[in] Egy másik ablaktábla mutatója.

Visszaadott érték

IGAZ, ha ez az ablaktábla rögzíthető egy másik ablaktáblához; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, mielőtt a pDockBar által megadott panelt az aktuális panelre rögzítené.

Ezt a módszert és a CBasePane::CanAcceptPane metódust használva szabályozhatja, hogy a panelek hogyan rögzíthetők az alkalmazás más ablaktábláihoz.

Az alapértelmezett implementáció HAMIS értéket ad vissza.

CBasePane::CanBeResized

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

virtual BOOL CanBeResized() const;

Visszaadott érték

IGAZ, ha a panel átméretezhető; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus ellenőrzi a AFX_CBRS_RESIZE jelzőt, amely alapértelmezés szerint a következőben van megadva: CBasePane::OnCreate. Ha ez a jelző nincs megadva, a dokkoláskezelő a dokkolás helyett belsőleg ingóként jelöli meg a panelt.

CBasePane::CanBeTabbedDocument

Megadja, hogy a panel átalakítható-e MDI-lapozott dokumentummá.

virtual BOOL CanBeTabbedDocument() const;

Visszaadott érték

IGAZ, ha a panel többlapos dokumentummá alakítható; egyéb esetben HAMIS. CBasePane::CanBeTabbedDocument mindig HAMIS értéket ad vissza.

Megjegyzések

Csak bizonyos CBasePaneszármaztatott típusú objektumok, például a CDockablePane osztály konvertálhatók többlapos dokumentumokká.

CBasePane::CanFloat

Meghatározza, hogy a panel lebeghet-e.

virtual BOOL CanFloat() const;

Visszaadott érték

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

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a panel lebeghet-e.

Az építés során ezt a képességet úgy állíthatja be, hogy átadja a AFX_CBRS_FLOAT jelzőt a CBasePane::CreateEx fájlnak.

Megjegyzés:

A keretrendszer feltételezi, hogy a nem lebegő ablaktáblák statikusak, és a rögzítési állapotuk nem módosítható. Ezért a keretrendszer nem menti a nem lebegő ablaktáblák dokkolási állapotát.

Az alapértelmezett implementáció a AFX_CBRS_FLOAT stílust ellenőrzi.

CBasePane::CanFocus

Megadja, hogy a panel kap-e fókuszt.

virtual BOOL CanFocus() const;

Visszaadott érték

IGAZ, ha a panel képes a fókusz fogadására; egyéb esetben HAMIS.

Megjegyzések

A fókusz szabályozásához felülbírálja ezt a metódust egy származtatott osztályban. Mivel például az eszköztárak nem tudják fogadni a fókuszt, ez a metódus HAMIS értéket ad vissza, amikor az eszköztár-objektumokra van meghívva.

A keretrendszer megkísérli beállítani a bemeneti fókuszt egy panel rögzítésekor vagy lebegtetésekor.

CBasePane::CopyState

Egy adott panel állapotának másolása.

virtual void CopyState(CBasePane* pOrgBar);

Paraméterek

pOrgBar
[in] Egy másik ablaktábla mutatója.

Megjegyzések

Ez a metódus az állapotot a pOrgBar-ból ebbe a panelre másolja.

CBasePane::CreateDefaultMiniframe

Ha az ablaktábla lebegni tud, ez a metódus létrehoz egy minikeretablakot.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Paraméterek

rectInitial
[in] A minikeretablak kezdeti koordinátáit adja meg.

Visszaadott érték

Mutató az új minikeret ablakára vagy NULL értékre, ha a létrehozás sikertelen volt.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor egy panel lebegő állapotra vált. A metódus létrehoz egy minikeretes ablakot, és ehhez az ablakhoz csatolja a panelt.

Az alapértelmezett implementáció null értéket ad vissza.

CBasePane::CreateEx

Létrehozza a panel vezérlőelemet.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle=0,
    CCreateContext* pContext=NULL);

Paraméterek

dwStyleEx
[in] A kiterjesztett stílusok (további információkért lásd : CWnd::CreateEx ).

lpszClassName
[in] Az ablakosztály neve.

lpszWindowName
[in] Az ablak neve.

dwStyle
[in] Az ablakstílus (lásd : CWnd::CreateEx).

téglalap
[in] A kezdeti téglalap.

pParentWnd
[in] Mutató a szülőablakra.

Nid
[in] Megadja a panel azonosítóját. Egyedinek kell lennie.

dwControlBarStyle
[in] Stílusjelölők az ablaktáblákhoz.

pContext
[in] Mutató a CcreateContext

Visszaadott érték

IGAZ, ha a panel sikeresen létrejött; egyéb esetben HAMIS.

Megjegyzések

Létrehoz egy osztályablakot lpszClassName. Ha WS_CAPTION ad meg, ez a metódus törli a WS_CAPTION stílusbitet, és IGAZ értékre állítja CBasePane::m_bHasCaption , mivel a kódtár nem támogatja a feliratokat tartalmazó ablaktáblákat.

A gyermekablakstílusok és az MFC vezérlősávok (CBRS_) bármilyen kombinációját használhatja.

A kódtár számos új stílust ad hozzá az ablaktáblákhoz. Az alábbi táblázat az új stílusokat ismerteti:

Stílus Leírás
AFX_CBRS_FLOAT A panel lebeghet.
AFX_CBRS_AUTOHIDE A panel támogatja az automatikus elrejtés módját
AFX_CBRS_RESIZE A panel átméretezhető. Fontos: Ez a stílus nincs implementálva.
AFX_CBRS_CLOSE Az ablaktábla bezárható.
AFX_CBRS_AUTO_ROLLUP A panel feltekerhető, amikor lebeg.
AFX_CBRS_REGULAR_TABS Amikor az egyik ablaktábla egy másik, ezzel a stílussal rendelkező panelre rögzít, létrejön egy normál lapozott ablak. További információ: CTabbedPane osztály.
AFX_CBRS_OUTLOOK_TABS Amikor az egyik ablaktábla egy másik, ezzel a stílust tartalmazó panelre rögzít, létrejön egy Outlook-stílusú lapozott ablak. További információt a CMFCOutlookBar osztályban talál.

Az új stílusok használatához adja meg őket a dwControlBarStyle-ban.

CBasePane::D ockPane

Egy panel rögzítése egy másik ablaktáblára vagy egy keretablakra.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Paraméterek

pDockBar
[in] Egy másik ablaktábla mutatója.

lpRect
[in] A cél téglalapot adja meg.

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

Visszaadott érték

IGAZ, ha a vezérlősávot sikeresen rögzítették; egyéb esetben HAMIS.

Megjegyzések

Hívja meg ezt a függvényt, hogy egy panelt rögzítsen egy másik panelre vagy egy pDockBar által megadott dokkolósávra (CDockSite Class), vagy egy fő keretre, ha a pDockBar null értékű.

A dockMethod a panel dokkolásának módját adja meg. A lehetséges értékek listáját a CPane::D ockPane című témakörben találja.

CBasePane::D ockPaneUsingRTTI

A munkaablak rögzítése futásidejű típusadatok használatával.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Paraméterek

bUseDockSite
[in] Ha IGAZ, dokkoljon a dokkolóhelyhez. Ha HAMIS, dokkoljon a szülőkerethez.

CBasePane::D ockToFrameWindow

Rögzít egy rögzíthető panelt egy kerethez.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Paraméterek

dwAlignment
[in] A szülőkeret azon oldala, amelyhez rögzíteni szeretné a panelt.

lpRect
[in] A kívánt méret.

dwDockFlags
[in] Figyelmen kívül hagyja.

pRelativeBar
[in] Figyelmen kívül hagyja.

nRelativeIndex
[in] Figyelmen kívül hagyja.

bOuterEdge
[in] Ha IGAZ, és a dwAlignment által megadott oldalon más rögzíthető ablaktáblák is vannak, az ablaktábla a többi ablaktáblán kívül lesz rögzítve, közelebb a szülőkeret széléhez. Ha HAMIS, az ablaktábla az ügyfélterület középpontjához közelebb van rögzítve.

Visszaadott érték

IGAZ, ha a módszer sikeres volt; egyéb esetben HAMIS.

Megjegyzések

Ez a módszer meghiúsul, ha nem hozható létre panelelválasztó ( CPaneDivider-osztály). Ellenkező esetben mindig IGAZ értéket ad vissza.

CBasePane::D oesAllowDynInsertBefore

Meghatározza, hogy egy másik ablaktábla dinamikusan beszúrható-e a panel és a szülőkeret közé.

virtual BOOL DoesAllowDynInsertBefore() const;

Visszaadott érték

IGAZ, ha egy felhasználó be tud szúrni egy másik panelt; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a felhasználó képes-e dinamikusan beszúrni egy panelt az ablaktábla elé.

Tegyük fel például, hogy az alkalmazás létrehoz egy panelt a keret bal oldalán (például az Outlook sávon). Ha meg szeretné akadályozni, hogy a felhasználó egy másik panelt rögzítsen az első paneltől balra, írja felül ezt a módszert, és adja vissza a HAMIS értéket.

Javasoljuk, hogy felülbírálja ezt a metódust, és a CDockablePane osztályból származó nem lebegő ablaktáblák esetén adja vissza a FALSE értéket.

Az alapértelmezett implementáció IGAZ értéket ad vissza.

CBasePane::D oPaint

Kitölti a panel hátterét.

virtual void DoPaint(CDC* pDC);

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

Az alapértelmezett implementáció meghívja az aktuális vizualizációkezelőt a háttér kitöltésére ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Engedélyezi a panel rögzítését a főkerethez.

virtual void EnableDocking(DWORD dwAlignment);

Paraméterek

dwAlignment
[in] Megadja az engedélyezendő dokkolás igazítását.

Megjegyzések

Ennek a metódusnak a meghívásával engedélyezheti a dokkolás igazítását a fő kerethez. A CBRS_ALIGN_ jelzők kombinációját is átadhatja (további információ: CControlBar::EnableDocking).

EnableDocking beállítja a belső jelzőt CBasePane::m_dwEnabledAlignment , és a keretrendszer ellenőrzi ezt a jelzőt egy panel rögzítésekor.

Hívja meg a CBasePane::GetEnabledAlignment parancsot egy panel dokkolásának meghatározásához.

CBasePane::EnableGripper

Engedélyezi vagy letiltja a fogót. Ha a markoló engedélyezve van, a felhasználó húzással áthelyezheti a panelt.

virtual void EnableGripper(BOOL bEnable);

Paraméterek

bEnable
[in] IGAZ a fogó engedélyezéséhez; HAMIS a letiltásához.

Megjegyzések

A keretrendszer ezzel a módszerrel engedélyezi a fogót a WS_CAPTION stílus használata helyett.

CBasePane::FloatPane

Lebegteti a panelt.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

Paraméterek

rectFloat
[in] Megadja a képernyő koordinátáit, ahol a lebegő ablaktábla megjelenik.

dockMethod
[in] Megadja az ablaktábla lebegtetéséhez használandó dokkolómetódust.

bShow
[in] Megadja, hogy a lebegő ablaktábla látható-e (IGAZ) vagy rejtett (HAMIS).

Visszaadott érték

IGAZ, ha a panelt sikeresen lebegtették; egyéb esetben HAMIS.

Megjegyzések

Ennek a metódusnak a meghívásával lebegtethet egy panelt a rectFloat által megadott képernyőpozícióban.

CBasePane::get_accHelpTopic

A keretrendszer meghívja ezt a metódust, hogy lekérje a megadott objektumhoz társított WinHelp-fájl teljes elérési útját és a fájlban található megfelelő témakör azonosítóját.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Paraméterek

pszHelpFile
[in] Egy olyan BSTR címe, amely megkapja a megadott objektumhoz társított WinHelp-fájl teljes elérési útját, ha van ilyen.

varChild
[in] Megadja, hogy a lekérendő súgótémakör az objektum vagy az objektum egyik gyermekeleme-e. Ez a paraméter lehet CHILDID_SELF (az objektum súgótémakörének lekéréséhez) vagy egy gyermekazonosító (az objektum egyik gyermekeleméhez tartozó súgótémakör beszerzéséhez).

pidTopic
[in] A megadott objektumhoz társított súgófájl-témakört azonosítja.

Visszaadott érték

CBasePane nem implementálja ezt a módszert. CBasePane::get_accHelpTopic Ezért mindig S_FALSE ad vissza.

Megjegyzések

Ez a függvény az MFC aktív akadálymentességi támogatásának része. Felülbírálja ezt a függvényt egy származtatott osztályban, hogy segítséget nyújtson az objektumról.

CBasePane::get_accSelection

A keretrendszer meghívja ezt a metódust az objektum kijelölt gyermekeinek lekéréséhez.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Paraméterek

pvarChildren
[in] A kiválasztott gyermekeket azonosító információkat kap.

Visszaadott érték

CBasePane nem implementálja ezt a módszert. Ha a pvarChildren értéke NULL, akkor ez a metódus E_INVALIDARG ad vissza. Ellenkező esetben ez a metódus DISP_E_MEMBERNOTFOUND ad vissza.

Megjegyzések

Ez a függvény az MFC aktív akadálymentességi támogatásának része. Felülbírálja ezt a függvényt egy származtatott osztályban, ha nem ablak nélküli ActiveX-vezérlőkkel rendelkezik a felhasználói felület nem ablakos elemeivel.

CBasePane::GetCaptionHeight

A felirat magasságát adja vissza.

virtual int GetCaptionHeight() const;

Visszaadott érték

A felirat magassága.

CBasePane::GetControlBarStyle

A vezérlősáv stílusát adja vissza.

virtual DWORD GetControlBarStyle() const

Visszaadott érték

A AFX_CBRS_ jelzők bitenkénti VAGY kombinációja.

Megjegyzések

A visszatérési érték a következő lehetséges értékek kombinációja.

Stílus Leírás
AFX_CBRS_FLOAT Lebegteti a vezérlősávot.
AFX_CBRS_AUTOHIDE Engedélyezi az automatikus elrejtés módját.
AFX_CBRS_RESIZE Engedélyezi a vezérlősáv átméretezését. Ha ez a jelző be van állítva, a vezérlősáv rögzíthető panelen helyezhető el.
AFX_CBRS_CLOSE Lehetővé teszi a vezérlősáv elrejtését.

CBasePane::GetCurrentAlignment

Az aktuális panel igazítását adja vissza.

virtual DWORD GetCurrentAlignment() const;

Visszaadott érték

A vezérlősáv aktuális igazítása. Az alábbi táblázat a lehetséges értékeket mutatja be:

Érték Igazítás
CBRS_ALIGN_LEFT Bal oldali igazítás.
CBRS_ALIGN_RIGHT Helyes igazítás.
CBRS_ALIGN_TOP Felső igazítás.
CBRS_ALIGN_BOTTOM Alsó igazítás.

CBasePane::GetDockingMode

A panel aktuális rögzítési módját adja vissza.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Visszaadott érték

DT_STANDARD ha az ablaktábla húzását egy húzási téglalap jelzi a képernyőn. DT_IMMEDIATE, hogy a panel tartalma húzva van-e.

Megjegyzések

A keretrendszer meghívja ezt a metódust a panel aktuális rögzítési módjának meghatározásához.

Ha CBasePane::m_dockMode nincs definiálva (DT_UNDEFINED), akkor a rögzítési mód a globális rögzítési módból (AFX_GLOBAL_DATA::m_dockModeGlobal).

A m_dockMode vagy felülírás GetDockingMode beállításával szabályozhatja az egyes panelek dokkolási módját.

CBasePane::GetDockSiteFrameWnd

Egy mutatót ad vissza arra a CDockingPanesRow objektumra, ahol a panel rögzítve van.

virtual CWnd* GetDockSiteFrameWnd() const;

Visszaadott érték

A panel dokkolóhelyére mutató mutató.

Megjegyzések

Hívja meg ezt a metódust a panel dokkhelyére mutató mutató lekéréséhez. A dokkolóhely lehet főkeretablak, ha az ablaktábla a főkerethez van rögzítve, vagy egy minikeretes ablak, ha az ablaktábla lebegő.

CBasePane::GetEnabledAlignment

A panelre alkalmazott CBRS_ALIGN_ stílusokat adja vissza.

virtual DWORD GetEnabledAlignment() const;

Visszaadott érték

A CBRS_ALIGN_ stílusok kombinációja. Az alábbi táblázat a lehetséges stílusokat mutatja be:

Zászló Engedélyezett igazítás
CBRS_ALIGN_LEFT Balra.
CBRS_ALIGN_RIGHT Jobbra.
CBRS_ALIGN_TOP Felső.
CBRS_ALIGN_BOTTOM Fenék.
CBRS_ALIGN_ANY Az összes jelölő kombinációja.

Megjegyzések

Hívja meg ezt a metódust az ablaktábla engedélyezett igazításának meghatározásához. Az engedélyezett igazítás azt jelenti, hogy a fő keretablak oldalaihoz rögzíthető egy ablaktábla.

A dokkolás igazításának engedélyezése a CBasePane::EnableDocking használatával.

CBasePane::GetMFCStyle

Az MFC-hez tartozó panelstílusokat adja vissza.

virtual DWORD GetMFCStyle() const;

Visszaadott érték

Könyvtárspecifikus (AFX_CBRS_) panelstílusok kombinációja.

CBasePane::GetPaneIcon

Egy fogópontot ad vissza a panel ikonjához.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Paraméterek

bBigIcon
[in] 32 képpontos és 32 képpontos ikont ad meg, ha IGAZ; 16 képpontos és 16 képpontos ikont ad meg, ha HAMIS.

Visszaadott érték

Az ablaktábla ikonjának fogópontja. Ha nem sikerül, null értéket ad vissza.

Megjegyzések

Az alapértelmezett implementáció meghívja a CWnd::GetIcon parancsot.

CBasePane::GetPaneRow

Egy mutatót ad vissza arra a CDockingPanesRow objektumra, ahol a panel rögzítve van.

CDockingPanesRow* GetPaneRow();

Visszaadott érték

Mutató arra az esetre CDockingPanesRow , ha az ablaktábla rögzítve van, vagy null értékű, ha lebegő.

Megjegyzések

Hívja meg ezt a metódust annak a sornak a eléréséhez, ahol a panel rögzítve van. Ha például egy adott sorba szeretné rendezni a paneleket, hívja meg GetPaneRow és hívja meg a CDockingPanesRow::ArrangePanes parancsot.

CBasePane::GetPaneStyle

A panel stílusát adja vissza.

virtual DWORD GetPaneStyle() const;

Visszaadott érték

A CBasePane::SetPaneStyle metódus által a létrehozáskor beállított vezérlősávstílusok (beleértve a CBRS_ stílusokat is) kombinációja.

CBasePane::GetParentDockSite

Egy mutatót ad vissza a szülő dokkolóhelyre.

virtual CDockSite* GetParentDockSite() const;

Visszaadott érték

A szülőkötet helye.

CBasePane::GetParentMiniFrame

A szülő minikeret ablakára mutató mutatót ad vissza.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

Paraméterek

bNoAssert
[in] Ha IGAZ, ez a metódus nem ellenőrzi a nem érvényes mutatókat. Ha ezt a metódust az alkalmazás kilépésekor hívja meg, állítsa ezt a paramétert IGAZ értékre.

Visszaadott érték

Érvényes mutató a szülő minikeret ablakára, ha az ablaktábla lebegő; ellenkező esetben NULL.

Megjegyzések

Hívja meg ezt a függvényt, hogy lekérjen egy mutatót a szülő minikeret ablakához. Ez a módszer végigfut az összes szülőn, és ellenőrzi a CPaneFrameWnd osztályból származó objektumot.

Annak meghatározására használható GetParentMiniFrame , hogy a panel lebegő-e.

CBasePane::GetParentTabbedPane

A szülőlapos panelre mutató mutatót ad vissza.

CBaseTabbedPane* GetParentTabbedPane() const;

Visszaadott érték

Mutató a szülőlapos panelre, ha létezik; ellenkező esetben NULL.

CBasePane::GetParentTabWnd

A lapon található szülőablakra mutató mutatót ad vissza.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Paraméterek

hWndTab
[kifelé] Ha a visszatérési érték nem NULL, ez a paraméter tartalmazza a szülőlapos ablak leíróját.

Visszaadott érték

Érvényes mutató a szülőlapos ablakra vagy NULL értékre.

Megjegyzések

Ezzel a függvénnyel lekérhet egy mutatót a szülőlapos ablakra. Néha nem elég meghívni GetParent, mert előfordulhat, hogy egy panel egy dokkoló burkolóban ( CDockablePaneAdapter Osztály) vagy egy paneladapterben (CDockablePaneAdapter osztály) található. Az ilyen GetParentTabWnd esetekben érvényes mutatót fog tudni lekérni (feltéve, hogy a szülő egy lapozott ablak).

CBasePane::GetRecentVisibleState

A keretrendszer ezt a metódust hívja meg, amikor egy panelt visszaállít egy archívumból.

virtual BOOL GetRecentVisibleState() const;

Visszaadott érték

A legutóbbi látható állapotot meghatározó BOOL. Ha IGAZ, akkor a panel látható volt a szerializált állapotban, és a visszaállításkor láthatónak kell lennie. Ha HAMIS, a panel a szerializáláskor rejtett volt, és a visszaállításkor el kell rejteni.

CBasePane::HideInPrintPreviewMode

Megadja, hogy a panel rejtett-e a nyomtatási képben.

virtual BOOL HideInPrintPreviewMode() const;

Visszaadott érték

IGAZ, ha a panel nem jelenik meg nyomtatási képként; egyéb esetben HAMIS.

Megjegyzések

Az alappanelek nem jelennek meg a nyomtatási képben. Ezért ez a módszer mindig IGAZ értéket ad vissza.

CBasePane::InsertPane

Regisztrálja a megadott panelt a dokkolókezelővel.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Paraméterek

pControlBar
[in] A beszúrni kívánt ablaktábla mutatója.

pTarget
[in] Mutató a szomszédos panelre.

bAfter
[in] Ha IGAZ, pControlBarpTargetután lesz beszúrva. Ha HAMIS, pControlBar beszúrása pTargetelőtt történik.

Visszaadott érték

IGAZ, ha a metódus sikeres, hamis.

CBasePane::IsAccessibilityCompatible

Megadja, hogy a panel támogatja-e az aktív akadálymentességet.

virtual BOOL IsAccessibilityCompatible();

Visszaadott érték

IGAZ, ha a panel támogatja az aktív akadálymentességet; egyéb esetben HAMIS.

CBasePane::IsAutoHideMode

Meghatározza, hogy egy panel automatikusan elrejtett módban van-e.

virtual BOOL IsAutoHideMode() const;

Visszaadott érték

IGAZ, ha a panel automatikus elrejtés módban van; egyéb esetben HAMIS.

Megjegyzések

Az alappanelek nem rejthetők el automatikusan. Ez a metódus mindig HAMIS értéket ad vissza.

CBasePane::IsDialogControl

Megadja, hogy az ablaktábla párbeszédpanel-vezérlő-e.

BOOL IsDialogControl() const;

Visszaadott érték

IGAZ, ha az ablaktábla párbeszédpanel-vezérlő; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer ezzel a módszerrel biztosítja az elrendezés konzisztenciáját az összes panelen.

CBasePane::IsDocked

Meghatározza, hogy a panel rögzítve van-e.

virtual BOOL IsDocked() const;

Visszaadott érték

IGAZ, ha a panel szülője nem minikeret, vagy ha az ablaktábla egy másik ablaktáblával rendelkező minikeretben lebeg; egyéb esetben HAMIS.

CBasePane::IsFloating

Meghatározza, hogy a panel lebegő-e.

virtual BOOL IsFloating() const;

Visszaadott érték

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

Megjegyzések

Ez a metódus a CBasePane::IsDocked ellenkező értékét adja vissza.

CBasePane::IsHorizontal

Meghatározza, hogy a panel vízszintesen van-e rögzítve.

virtual BOOL IsHorizontal() const;

Visszaadott érték

IGAZ, ha a panel vízszintesen van rögzítve; egyéb esetben HAMIS.

Megjegyzések

Az alapértelmezett implementáció ellenőrzi a CBRS_ORIENT_HORZ aktuális dokkolás-igazítását.

CBasePane::IsInFloatingMultiPaneFrameWnd

Megadja, hogy az ablaktábla egy többablakos keretablakban ( CMultiPaneFrameWnd osztály) van-e.

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Visszaadott érték

IGAZ, ha az ablaktábla több ablaktáblás keretablakban van; egyéb esetben HAMIS.

Megjegyzések

Csak a rögzíthető ablaktáblák lebeghetnek egy többablakos keretablakban. CBasePane::IsInFloatingMultiPaneFrameWnd Ezért mindig HAMIS értéket ad vissza.

CBasePane::IsMDITabbed

Meghatározza, hogy az ablaktábla többlapos dokumentumként lett-e hozzáadva egy MDI-gyermekablakhoz.

virtual BOOL IsMDITabbed() const;

Visszaadott érték

IGAZ, ha az ablaktábla többlapos dokumentumként lett hozzáadva egy MDI-gyermekablakhoz; egyéb esetben HAMIS.

CBasePane::IsPaneVisible

Megadja, hogy a WS_VISIBLE jelző be van-e állítva a panelen.

BOOL IsPaneVisible() const;

Visszaadott érték

IGAZ, ha WS_VISIBLE be van állítva; egyéb esetben HAMIS.

Megjegyzések

A panel láthatóságának meghatározásához használja a CBasePane::IsVisible parancsot .

CBasePane::IsPointNearDockSite

Meghatározza, hogy egy megadott pont a dokkhely közelében van-e.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Paraméterek

pont
[in] A megadott pont.

dwBarAlignment
[kifelé] Megadja, hogy a pont melyik széle legyen közel. Lehetséges értékek: CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP és CBRS_ALIGN_BOTTOM

bOuterEdge
[kifelé] IGAZ, ha a pont a kikötőhely külső szegélyének közelében van; HAMIS egyéb esetben.

Visszaadott érték

IGAZ, ha a pont a dokkhely közelében van; egyéb esetben HAMIS.

Megjegyzések

A pont a dokkoló hely közelében van, amikor a dokkolókezelő bizalmassági csoportján belül van. Az alapértelmezett érzékenység 15 képpont.

CBasePane::IsResizable

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

virtual BOOL IsResizable() const;

Visszaadott érték

IGAZ, ha a panelt a felhasználó átméretezheti; egyéb esetben HAMIS.

Megjegyzések

A CDockablePane osztály paneljei átméretezhetők.

Az állapotsor ( CMFCStatusBar osztály) és a dokkolósáv ( CDockSite osztály) nem méretezhető át.

CBasePane::IsRestoredFromRegistry

Meghatározza, hogy a panel visszaállítva van-e a beállításjegyzékből.

virtual BOOL IsRestoredFromRegistry() const;

Visszaadott érték

IGAZ, ha a panel a beállításjegyzékből van visszaállítva; egyéb esetben HAMIS.

CBasePane::IsTabbed

Meghatározza, hogy az ablaktábla be lett-e szúrva egy lapfül vezérlőelembe.

virtual BOOL IsTabbed() const;

Visszaadott érték

IGAZ, ha a vezérlősáv egy lapfülre van beszúrva egy lapfülre; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus egy mutatót kér le a közvetlen szülőhöz, és megállapítja, hogy a szülő futtatókörnyezeti osztálya CMFCBaseTabCtrl osztály-e.

CBasePane::IsVisible

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

virtual BOOL IsVisible() const;

Visszaadott érték

IGAZ, ha a panel látható; egyéb esetben HAMIS.

Megjegyzések

Ezzel a módszerrel állapíthatja meg a panel láthatóságát. Ne használja az ::IsWindowVisible értéket.

Ha a panel nincs többlapos (lásd : CBasePane::IsTabbed), ez a metódus ellenőrzi a WS_VISIBLE stílust. Ha a panel lapozott, ez a módszer ellenőrzi a szülőlapos ablak láthatóságát. Ha a szülőablak látható, a függvény a CMFCBaseTabCtrl::IsTabVisible használatával ellenőrzi a panelfül láthatóságát.

CBasePane::LoadState

Betölti a panel állapotát a beállításjegyzékből.

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

Paraméterek

lpszProfileName
[in] Profilnév.

nIndex
[in] Profilindex.

uiID
[in] Ablaktábla azonosítója.

Visszaadott érték

IGAZ, ha a panel állapota sikeresen be lett töltve; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, hogy betöltse a panel állapotát a beállításjegyzékből. Felülbírálja egy származtatott osztályban a CBasePane által mentett további információk betöltéséhez::SaveState.

CBasePane::MoveWindow

Áthelyezi a panelt.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

Paraméterek

téglalap
[in] A panel új helyét és méretét meghatározó téglalap.

bRepaint
[in] Ha IGAZ, a panel újra van festve. Ha HAMIS, a panel nem lesz újrafestve.

hdwp
[in] Halasztott ablakpozíció szerkezetének kezelése.

Visszaadott érték

Halasztott ablakpozíció szerkezetének vagy NULL értékének leírója.

Megjegyzések

Ha a hdwp paraméterként null értéket ad át, ez a metódus a szokásos módon helyezi át az ablakot. Ha egy fogópontot ad át, ez a metódus késleltetett ablakátlépést hajt végre. A beginDeferWindowPos hívásával vagy a metódushoz tartozó korábbi hívás visszatérési értékének tárolásával lekérheti a leírót.

CBasePane::OnAfterChangeParent

A keretrendszer meghívta a panel szülőmódosításai után.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Paraméterek

pWndOldParent
[in] Az előző szülőre mutató mutató.

Megjegyzések

A keretrendszer ezt a metódust a panel szülőmódosításai után hívja meg, általában egy dokkoló vagy lebegő művelet miatt.

Az alapértelmezett implementáció nem végez semmit.

CBasePane::OnBeforeChangeParent

A keretrendszer meghívta, mielőtt a panel módosítja a szülőablakát.

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

Paraméterek

pWndNewParent
[in] Egy új szülőablakra mutató mutató.

bDelay
[in] Azt határozza meg, hogy az elrendezés-módosításokat késleltetni kell-e.

Megjegyzések

A keretrendszer ezt a metódust a panel szülőváltozása előtt hívja meg, általában egy dokkoló, lebegő vagy automatikus elrejtési művelet miatt.

Az alapértelmezett implementáció nem végez semmit.

CBasePane::OnDrawCaption

A keretrendszer ezt a metódust hívja meg a felirat rajzolásakor.

virtual void OnDrawCaption();

Megjegyzések

Ez a metódus nem rendelkezik az CBasePane osztály funkcióival.

CBasePane::OnMovePaneDivider

Ez a metódus jelenleg nem használható.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

Paraméterek

Használatlan
[in] Nincs használatban.

CBasePane::OnPaneContextMenu

A keretrendszer meghívja, amikor egy panellistát tartalmazó menüt hoz létre.

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

Paraméterek

pParentFrame
[in] Mutató a szülőkerethez.

pont
[in] Megadja a helyi menü helyét.

Megjegyzések

OnPaneContextMenu meghívja a dokkolókezelőt, amely fenntartja az aktuális keretablakhoz tartozó ablaktáblák listáját. Ez a metódus hozzáadja a panelek nevét egy helyi menühöz, és megjeleníti azt. A menü parancsai megjelenítik vagy elrejtik az egyes ablaktáblákat.

A módszer felülbírálása a viselkedés testreszabásához.

CBasePane::OnRemoveFromMiniFrame

A keretrendszer meghívja, amikor egy panel el van távolítva a szülő minikeret ablakából.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Paraméterek

pMiniFrame
[in] Mutató egy minikeretes ablakra, amelyből az ablaktábla el lett távolítva.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha egy panel el van távolítva a szülő minikeret ablakából (például dokkolás miatt).

Az alapértelmezett implementáció nem végez semmit.

CBasePane::OnSetAccData

CBasePane nem használja ezt a módszert.

virtual BOOL OnSetAccData(long lVal);

Paraméterek

lVal
[in] Nincs használatban.

Visszaadott érték

Ez a metódus mindig IGAZ értéket ad vissza.

Megjegyzések

CBasePane::P aneFromPoint

Az adott pontot tartalmazó panelt adja vissza.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) const;

Paraméterek

pont
[in] Megadja az ellenőrizni kívánt pontot a képernyő koordinátáiban.

nSzenzitivitási
[in] Növelje a keresési területet ezzel az összeggel. A panel megfelel a keresési feltételeknek, ha az adott pont a megnövekedett területre esik.

bExactBar
[in] IGAZ, hogy figyelmen kívül hagyja az nSensitivity paramétert; egyéb esetben HAMIS.

pRTCBarType
[in] Ha nem NULL, a metódus csak a megadott típusú paneleken keres.

Visszaadott érték

Az CBasePaneadott pontot tartalmazó -származtatott objektum, vagy NULL, ha nem található panel.

CBasePane::RecalcLayout

CBasePane nem használja ezt a módszert.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

Törli a panel regisztrációját, és eltávolítja azt a dokkolókezelő listájából.

void RemovePaneFromDockManager(
    CBasePane* pBar,
    BOOL bDestroy = TRUE,
    BOOL bAdjustLayout = FALSE,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Paraméterek

pBar
[in] Az eltávolítandó ablaktáblára mutató mutató.

bDestroy
[in] Ha IGAZ, az eltávolított panel megsemmisül.

bAdjustLayout
[in] Ha IGAZ, azonnal állítsa be a dokkolás elrendezését.

bAutoHide
[in] Ha IGAZ, a dokkolás elrendezése az automatikusan megjelenő sávok listájához kapcsolódik. Ha HAMIS, a dokkolás elrendezése a normál ablaktáblák listájához kapcsolódik.

pBarReplacement
[in] Az eltávolított ablaktáblát lecserélő ablaktábla mutatója.

CBasePane::SaveState

Menti a panel állapotát a beállításjegyzékbe.

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

Paraméterek

lpszProfileName
[in] Profilnév.

nIndex
[in] Profilindex.

uiID
[in] Ablaktábla azonosítója.

Visszaadott érték

IGAZ, ha az állapot mentése sikeresen megtörtént; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor menti a panel állapotát a beállításjegyzékbe. Felülbírálás SaveState származtatott osztályban további információk tárolásához.

CBasePane::SelectDefaultFont

Kiválasztja egy adott eszközkörnyezet alapértelmezett betűtípusát.

CFont* SelectDefaultFont(CDC* pDC);

Paraméterek

pDC
[in] Eszközkörnyezet.

Visszaadott érték

Az alapértelmezett CFont-osztályobjektumra mutató mutató.

CBasePane::SetControlBarStyle

Beállítja a vezérlősáv stílusát.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Paraméterek

dwNewStyle
[in] A következő lehetséges értékek bitenkénti VAGY kombinációja.

Stílus Leírás
AFX_CBRS_FLOAT Lebegteti a vezérlősávot.
AFX_CBRS_AUTOHIDE Engedélyezi az automatikus elrejtés módját.
AFX_CBRS_RESIZE Engedélyezi a vezérlősáv átméretezését. Ha ez a jelző be van állítva, a vezérlősáv rögzíthető panelen helyezhető el.
AFX_CBRS_CLOSE Lehetővé teszi a vezérlősáv elrejtését.

CBasePane::SetDockingMode

Beállítja a panel dokkolási módját.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Paraméterek

dockModeNew
[in] A panel új rögzítési módját adja meg.

Megjegyzések

A keretrendszer két rögzítési módot támogat: standard és azonnali.

Normál rögzítési módban a panelek és a minikeretablakok húzási téglalap használatával mozognak. Azonnali rögzítési módban a vezérlősávok és a minikeretes ablakok azonnal áthelyeződnek a környezetükkel együtt.

A rögzítési módot kezdetben globálisan a CDockingManager::m_dockModeGlobal határozza meg. A módszerrel egyenként állíthatja be a rögzítési módot az SetDockingMode egyes ablaktáblákhoz.

CBasePane::SetPaneAlignment

Beállítja a panel igazítását.

virtual void SetPaneAlignment(DWORD dwAlignment);

Paraméterek

dwAlignment
[in] Megadja az új igazítást.

Megjegyzések

A keretrendszer általában akkor hívja meg ezt a metódust, ha egy panel a főkeret egyik oldaláról a másikra van rögzítve.

Az alábbi táblázat a dwAlignment lehetséges értékeit mutatja be:

Érték Igazítás
CBRS_ALIGN_LEFT Bal oldali igazítás.
CBRS_ALIGN_RIGHT Helyes igazítás.
CBRS_ALIGN_TOP Felső igazítás.
CBRS_ALIGN_BOTTOM Alsó igazítás.

CBasePane::SetPaneStyle

Beállítja a panel stílusát.

virtual void SetPaneStyle(DWORD dwNewStyle);

Paraméterek

dwNewStyle
[in] Megadja a beállítani kívánt új stílust.

Megjegyzések

Ez a módszer az afxres.h fájlban definiált CBRS_ stílusok bármelyikének beállítására használható. Mivel a panelstílus és az ablaktábla igazítása együtt van tárolva, állítsa be az új stílust az aktuális igazítással az alábbiak szerint.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

Módosítja a panel méretét, pozícióját és Z-sorrendjét.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

Paraméterek

pWndInsertAfter
[in] Azonosítja az CWnd objektum előtti CWnd objektumot a Z-sorrendben. További információ: CWnd::SetWindowPos.

x
[in] Az ablak bal oldalának pozícióját adja meg.

y
[in] Az ablak tetejének pozícióját adja meg.

cx
[in] Az ablak szélességét adja meg.

Cy
[in] Az ablak magasságát adja meg.

nFlags
[in] Megadja a méret- és pozícióbeállításokat. További információ: CWnd::SetWindowPos.

hdwp
[in] Kezelje egy olyan struktúrát, amely egy vagy több ablak méret- és pozícióadatait tartalmazza.

Visszaadott érték

Egy frissített halasztott ablakpozíció-struktúrához vagy NULL-hoz vezető fogópont.

Megjegyzések

Ha a pWndInsertAfter értéke NULL, ez a metódus meghívja a CWnd::SetWindowPos függvényt. Ha a pWndInsertAfter értéke nem NULL, akkor ez a metódus meghívja a metódust DeferWindowPos.

CBasePane::ShowPane

Megjeleníti vagy elrejti a panelt.

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

Paraméterek

bShow
[in] Megadja, hogy megjelenítsen (IGAZ) vagy elrejtsen (HAMIS) egy panelt.

bDelay
[in] Ha IGAZ, a dokkolás elrendezésének újraszámítása késik.

bAktiválás
[in] Ha IGAZ, a panel aktív, amikor megjelenik.

Megjegyzések

Ez a metódus megjelenít vagy elrejt egy panelt. Használja ezt a metódust ahelyett ShowWindow , hogy ez a módszer értesíti a megfelelő dokkolókezelőket a panel láthatóságának változásairól.

A CBasePane::IsVisible használatával meghatározhatja egy panel aktuális láthatóságát.

CBasePane::StretchPane

Függőlegesen vagy vízszintesen feszíti a panelt.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Paraméterek

nHossz
[in] Az a hossz, amellyel a panelt ki kell húzni.

bVert
[in] Ha IGAZ, függőlegesen feszítse ki az ablaktáblát. Ha HAMIS, vízszintesen feszítse ki az ablaktáblát.

Visszaadott érték

A feszített ablaktábla mérete.

CBasePane::UndockPane

Eltávolítja a panelt a dokkolás helyéről, az alapértelmezett csúszkáról vagy a minikeret ablakáról, ahol jelenleg rögzítve van.

virtual void UndockPane(BOOL bDelay=FALSE);

Paraméterek

bDelay
Ha IGAZ, a dokkolás elrendezése nem lesz azonnal újraszámolva.

Megjegyzések

Ennek a metódusnak a meghívásával módosíthatja a panel állapotát, vagy kizárhatja a panelt a rögzítési elrendezésből.

Ha továbbra is használni szeretné ezt a panelt, a metódus meghívása előtt hívja meg a CBasePane::D ockPane vagy a CBasePane::FloatPane parancsot.

Lásd még

hierarchiadiagram
osztályok
CPane
CWnd osztály

  • Last updated on