CMDIChildWndEx osztály

Cikk
03/17/2025

A CMDIChildWndEx osztály a Windows több dokumentumfelületi (MDI) gyermekablakának funkcióit biztosítja. Kibővíti CMDIChildWnd osztályfunkcióit. A keretrendszer megköveteli ezt az osztályt, ha egy MDI-alkalmazás bizonyos MFC-osztályokat használ.

További részletekért lásd a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szintaxis

class CMDIChildWndEx : public CMDIChildWnd

Tagok

Nyilvános metódusok

Név	Leírás
CMDIChildWndEx::ActivateTopLevelFrame	A keretrendszer belsőleg hívja meg, hogy aktiválja a legfelső szintű keretet, amikor az alkalmazást aktiválni kell egy tálcán.
`CMDIChildWndEx::AddDockSite`	Ez a módszer nincs használatban vagy implementálva.
CMDIChildWndEx::AddPane	Panelt ad hozzá.
CMDIChildWndEx::AddTabbedPane	Többlapos panelt ad hozzá.
CMDIChildWndEx::AdjustDockingLayout	Beállítja a dokkolás elrendezését.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Megadja a keretrendszernek, hogy ez az MDI-gyermek megjeleníthető-e a Windows 7 tálcán.
CMDIChildWndEx::CanShowOnWindowsList	Igaz értéket ad vissza, ha az MDI gyermekablak neve megjeleníthető a CMFCWindowsManagerDialog Osztály párbeszédpanelen. Ellenkező esetben HAMIS értéket ad vissza.
`CMDIChildWndEx::CreateObject`	A keretrendszer meghívta, hogy hozzon létre egy ilyen típusú dinamikus példányt.
CMDIChildWndEx::D ockPane	Rögzít egy panelt.
CMDIChildWndEx::D ockPaneLeftOf	Az egyik panelt egy másik ablaktábla bal oldalán rögzíti.
CMDIChildWndEx::EnableAutoHidePanes	Engedélyezi az ablaktábla automatikus elrejtésének módját, ha azok az ablak megadott oldalán vannak rögzítve.
CMDIChildWndEx::EnableDocking	Engedélyezi a gyermekablak rögzítését a főkerethez.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Engedélyezi vagy letiltja az ablak ügyfélterületének egy részének automatikus kijelölését, hogy az az ablak miniatűrjeként jelenjen meg a tálcán.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Az MDI gyermekablakában megjelenő dokumentum nevét adja vissza.
CMDIChildWndEx::GetFrameIcon	A keretrendszer meghívta az MDI gyermekablak ikonjának lekéréséhez.
CMDIChildWndEx::GetFrameText	A keretrendszer meghívta, hogy lekérje az MDI gyermekablakának szövegét.
CMDIChildWndEx::GetPane	Megkeres egy panelt a megadott vezérlőazonosító alapján.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Egy mutatót ad vissza egy beágyazott dokkolópanelre, amelyet lapozott dokumentummá alakítottak át.
CMDIChildWndEx::GetTabProxyWnd	A lapproxy ablakát adja vissza, amely ténylegesen regisztrálva van a Windows 7 tálcán.
CMDIChildWndEx::GetTaskbarPreviewWnd	A keretrendszer meghívja, ha gyermekablakot (általában nézetet vagy osztóablakot) kell beszereznie, hogy megjelenjen a Windows 7 tálcalap miniatűrjén.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	A keretrendszer meghívja, amikor ki kell választania az ablak ügyfélterületének egy részét, hogy az ablak miniatűrjeként jelenjen meg a tálcán.
`CMDIChildWndEx::GetThisClass`	A keretrendszer meghívta, hogy az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutatót kapjon.
CMDIChildWndEx::GetToolbarButtonToolTipText	A keretrendszer meghívta egy eszköztárgomb elemleírásának lekéréséhez.
CMDIChildWndEx::InsertPane	Regisztrálja a megadott panelt a dokkolókezelővel.
CMDIChildWndEx::InvalidateIconicBitmaps	Érvényteleníti az MDI-gyermek ikonikus bitkép-ábrázolását.
CMDIChildWndEx::IsPointNearDockSite	Meghatározza, hogy egy megadott pont a dokkhely közelében van-e.
CMDIChildWndEx::IsReadOnly	IGAZ értéket ad vissza, ha a gyermekablakban megjelenített dokumentum írásvédett. Ellenkező esetben HAMIS értéket ad vissza.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Igaz értéket ad vissza, ha az MDI-gyermek sikeresen regisztrálva lett a Windows 7 tálcán.
CMDIChildWndEx::IsTabbedPane	IGAZ értéket ad vissza, ha az MDI gyermekablaka dokkolópanelt tartalmaz. Ellenkező esetben HAMIS értéket ad vissza.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Azt jelzi, hogy az MDI-gyermek megjelenhet-e a Windows 7 tálcán.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Azt jelzi, hogy az ablak ügyfélterületének egy részének automatikus kijelölése engedélyezve vagy letiltva van-e, mivel az ablak miniatűrje engedélyezve van a tálcán.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	A keretrendszer által a SetTaskbarTabProperties metódusnak átadott jelzők kombinációja, amikor egy lap (MDI gyermek) regisztrálva van a Windows 7 tálcák lapján. Az alapértelmezett kombináció a `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	A keretrendszer meghívja, amikor bitképet kell beszereznie az MDI-gyermek élő előnézetéhez.
CMDIChildWndEx::OnGetIconicThumbnail	A keretrendszer meghívta, amikor bitképet kell beszereznie az MDI-gyermek ikonikus miniatűrjéhez.
CMDIChildWndEx::OnMoveMiniFrame	A keretrendszer meghívta, hogy helyezzen át egy minikeretablakot.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	A keretrendszer meghívja, amikor a felhasználó lenyomja a Bezárás gombot a Tálca lap miniatűrjén.
CMDIChildWndEx::OnSetPreviewMode	A keretrendszer meghívta a nyomtatási kép módba való belépésre vagy kilépésre.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	A keretrendszer meghívta, amikor a Tálca lap miniatűrjének WM_ACTIVATE üzenetet kell feldolgoznia.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	A keretrendszer meghívta, amikor a Tálca lap miniatűrjének WM_MOUSEACTIVATE üzenetet kell feldolgoznia.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	A keretrendszer meghívta, amikor egy bitképet kell kinyújtania a Windows 7 tálcán lap miniatűr előnézete az MDI-gyermekhez.
CMDIChildWndEx::OnUpdateFrameTitle	A keretrendszer meghívta, hogy frissítse a keret címét. (Felülbírálások `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx::P aneFromPoint	Az adott pontot tartalmazó panelt adja vissza.
`CMDIChildWndEx::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.)
CMDIChildWndEx::RecalcLayout	Újraszámítja az ablak elrendezését.
CMDIChildWndEx::RegisterTaskbarTab	MDI-gyermek regisztrálása Windows 7 tálcás lapokkal.
CMDIChildWndEx::RemovePaneFromDockManager	Eltávolít egy panelt a dokkolókezelőből.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Aktiválja a megfelelő Windows 7 tálcát.
CMDIChildWndEx::SetTaskbarTabOrder	Beszúrja az MDI gyermekét a megadott ablak előtt a Windows 7 tálcán.
CMDIChildWndEx::SetTaskbarTabProperties	A Windows 7 tálcák lapjának tulajdonságait állítja be.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	A keretrendszer belsőleg meghívta a kivágási téglalap beállításához, hogy kijelölje az ablak ügyfélterületének egy részét, hogy az az ablak miniatűrjeként jelenjen meg a tálcán.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Eltávolítja az MDI gyermekét a Windows 7 tálcák lapjairól.
CMDIChildWndEx::UpdateTaskbarTabIcon	A Windows 7 tálcájának ikonja.

Megjegyzések

Az MDI-alkalmazások kiterjesztett dokkolási funkcióinak kihasználásához a CMDIChildWnd helyett CMDIChildWndEx származtathatja az alkalmazás MDI gyermekablak-osztályát.

Példa

Az alábbi példa egy osztályt CMDIChildWndExszármaztat. Ez a kódrészlet a VisualStudioDemo mintából származik: MFC Visual Studio Application.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

   // Implementation
public:
   virtual ~CChildFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Öröklési hierarchia

Követelmények

fejléc: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Panelt ad hozzá.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail = TRUE);

Paraméterek

pControlBar
[in] Az ablaktábla mutatója.

bTail
[in] IGAZ, ha hozzáadja a panelt a dokkolókezelő panellistájának végéhez; egyéb esetben HAMIS.

Visszaadott érték

IGAZ, ha a panel sikeresen regisztrálva lett a dokkolókezelőben; egyéb esetben HAMIS.

CMDIChildWndEx::AddTabbedPane

Többlapos panelt ad hozzá.

void AddTabbedPane(CDockablePane* pControlBar);

Paraméterek

pControlBar
[in] Az ablaktábla mutatója.

CMDIChildWndEx::AdjustDockingLayout

Beállítja a dokkolás elrendezését.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Paraméterek

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

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Visszaadott érték

Megjegyzések

CMDIChildWndEx::CanShowOnWindowsList

Megadja, hogy az MDI gyermekablak neve megjeleníthető-e a CMFCWindowsManagerDialog Osztály párbeszédpanelen.

virtual BOOL CanShowOnWindowsList();

Visszaadott érték

IGAZ, ha az ablak megjeleníthető a Windows párbeszédpanelen; egyéb esetben HAMIS.

Megjegyzések

Bírálja felül ezt a metódust egy származtatott osztályban, és hamis értéket ad vissza, ha az ablak nem jelenik meg a Windows párbeszédpanelen. Ezt a függvényt a CMFCWindowsManagerDialoghívjuk meg.

CMDIChildWndEx::D ockPane

Rögzít egy panelt.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Paraméterek

pBar
[in] Az ablaktábla mutatója.

nDockBarID
[in] A panel azonosítója.

lpRect
[in] Egy téglalapra mutató mutató.

Megjegyzések

A lpRect paraméter nem használatos.

CMDIChildWndEx::D ockPaneLeftOf

Az egyik panelt egy másik ablaktábla bal oldalán rögzíti.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Paraméterek

pBar
A rögzítendő panelre mutató mutató.

pLeftOf
Hivatkozási pontként szolgáló ablaktábla mutatója.

Visszaadott érték

TRUE on success, FALSE on failure.

Megjegyzések

Ez a metódus a pBar által megadott panelt veszi fel, és a pLeftOfáltal megadott panel bal oldalán rögzíti.

Hívja meg ezt a metódust, ha több panelt szeretne előre meghatározott sorrendben rögzíteni.

CMDIChildWndEx::EnableAutoHidePanes

Engedélyezi az ablaktábla automatikus elrejtésének módját, ha azok az ablak megadott oldalán vannak rögzítve.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Paraméterek

dwDockStyle
[in] Az engedélyezett fő keretablak oldalait adja meg. Használjon egy vagy több jelölőt.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Visszaadott érték

IGAZ, ha a metódus sikeres; egyéb esetben HAMIS.

CMDIChildWndEx::EnableDocking

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

BOOL EnableDocking(DWORD dwDockStyle);

Paraméterek

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

Visszaadott érték

IGAZ, ha a metódus sikeres; egyéb esetben HAMIS.

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).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetDocumentName

Az MDI gyermekablakában megjelenő dokumentum nevét adja vissza.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Visszaadott érték

Egy dokumentum nevét tartalmazó sztringre mutató mutató.

Megjegyzések

Az MDI gyermekablaka egy dokumentumot jelenít meg. Az ablak általában egy fájlból betöltött vagy mentett adatokat jeleníti meg. Ezért a dokumentum neve a fájl neve. A GetDocumentName alapértelmezett implementációja egy CDocument::GetPathName-ből beszerzett sztringet ad vissza.

Ha az ablakban egy fájlból nem betöltött dokumentum jelenik meg, felülbírálja ezt a metódust egy származtatott osztályban, és adjon vissza egy egyedi dokumentumazonosítót.

GetDocumentName a keretrendszer meghívja, amikor menti az összes megnyitott dokumentum állapotát. A visszaadott sztringet a rendszer a beállításjegyzékbe írja.

Amikor a keretrendszer később visszaállítja az állapotot, a rendszer beolvassa a dokumentum nevét a beállításjegyzékből, és átadja CMDIFrameWndEx::CreateDocumentWindow. Bírálja felül ezt a metódust egy CMDIFrameWndEx-származtatott osztályban, és hozzon létre vagy nyisson meg egy olyan dokumentumot, amelynek ez a neve, és olvassa el az ilyen nevű fájlt. Ha a dokumentum nem fájlon alapul, hozza létre a dokumentumot a dokumentumazonosító alapján. Az előző műveleteket csak akkor végezze el, ha menteni és visszaállítani szeretné a dokumentumokat.

Példa

Az alábbi példa a GetDocumentName metódus használatát mutatja be. Ez a kódrészlet a VisualStudioDemo mintából származik: MFC Visual Studio Application.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

A keretrendszer meghívta az MDI gyermekablak ikonjának lekéréséhez.

virtual HICON GetFrameIcon() const;

Visszaadott érték

Az ablak ikonjának fogópontja.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg annak meghatározásához, hogy milyen ikon jelenjen meg az MDI gyermekkeret ablakát tartalmazó MDI lapon.

Ez a metódus alapértelmezés szerint az ablak ikonját adja vissza. A viselkedés testreszabásához felülbírálja a GetFrameIcon egy CMDIChildWndEx-származtatott osztályban.

CMDIChildWndEx::GetFrameText

A keretrendszer meghívta, hogy lekérje az MDI gyermekablakának szövegét.

virtual CString GetFrameText() const;

Visszaadott érték

A keretablak szövegét tartalmazó sztring.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg annak meghatározásához, hogy milyen szöveg jelenjen meg az MDI gyermekkeretablakot tartalmazó MDI lapon.

Ez a metódus alapértelmezés szerint az ablak szövegét adja vissza. A viselkedés testreszabásához felülbírálja a GetFrameText egy CMDIChildWndEx-származtatott osztályban.

CMDIChildWndEx::GetPane

Megkeres egy panelt a megadott vezérlőazonosító alapján.

CBasePane* GetPane(UINT nID);

Paraméterek

nID
[in] A keresendő panel vezérlőazonosítója.

Visszaadott érték

Az ablaktábla mutatója, ha található, ellenkező esetben NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetTabbedPane

Egy mutatót ad vissza egy dokkolópanelre, amely az MDI-lapozott dokumentumok egy csoportjának része.

CDockablePane* GetTabbedPane() const;

Visszaadott érték

Mutató egy dokkolópanelre, amely egy többlapos MDI-dokumentumok csoportjának része.

CMDIChildWndEx::GetToolbarButtonToolTipText

A keretrendszer meghívta egy eszköztárgomb elemleírásának lekéréséhez.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Visszaadott érték

IGAZ, ha az elemleírás megjelenik. Az alapértelmezett implementáció HAMIS értéket ad vissza.

Megjegyzések

Bírálja felül ezt a módszert, ha egyéni eszköztippeket szeretne megjeleníteni az eszköztárgombokhoz.

CMDIChildWndEx::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.

CMDIChildWndEx::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
[in] 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
[in] 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.

CMDIChildWndEx::IsReadOnly

Megadja, hogy a gyermekablakban megjelenő dokumentum írásvédett-e.

virtual BOOL IsReadOnly();

Visszaadott érték

IGAZ, ha a dokumentum írásvédett; egyéb esetben HAMIS.

Megjegyzések

Ez a függvény az írásvédett dokumentumok mentésének megakadályozására szolgál.

Példa

Az alábbi példa a IsReadOnly metódus felülírását mutatja be. Ez a kódrészlet a VisualStudioDemo mintából származik: MFC Visual Studio Application.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

Megadja, hogy az MDI gyermekablak tartalmaz-e dokkolópanelt.

BOOL IsTabbedPane() const;

Visszaadott érték

IGAZ, ha az MDI gyermekablaka egy többlapos dokumentummá konvertált dokkolópanelt tartalmaz; egyéb esetben HAMIS.

CMDIChildWndEx::OnMoveMiniFrame

A keretrendszer meghívta, hogy helyezzen át egy minikeretablakot.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Paraméterek

pFrame
[in] Mutató egy minikeretes ablakhoz.

Visszaadott érték

IGAZ, ha a metódus sikeres, ellenkező esetben HAMIS.

CMDIChildWndEx::OnSetPreviewMode

A keretrendszer meghívta a nyomtatási kép módba való belépésre vagy kilépésre.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Paraméterek

bPreview
[in] Ha IGAZ, adja meg a nyomtatási kép módot. Ha HAMIS, lépjen ki a nyomtatási kép módból.

pState
[in] A nyomtatási kép állapotstruktúrájának mutatója.

CMDIChildWndEx::OnUpdateFrameTitle

A keretrendszer meghívta, hogy frissítse a keret címét.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Paraméterek

bAddToTitle
[in] Ha IGAZ, adja hozzá a dokumentum nevét a címhez.

CMDIChildWndEx::P aneFromPoint

Az adott pontot tartalmazó panelt adja vissza.

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

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) 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.

dwAlignment
[in] Ha egy panel a megadott ponton található, ez a paraméter a megadott ponthoz legközelebbi paneloldalt tartalmazza. További információkért lásd a Megjegyzések szakaszt.

Visszaadott érték

Mutató az adott pontot tartalmazó CBasePane-származtatott objektumra, vagy NULL értékre, ha nem található panel.

Megjegyzések

Hívja meg ezt a metódust annak meghatározásához, hogy egy panel tartalmazza-e a megadott pontot a megadott feltételeknek megfelelően, például futtatókörnyezeti osztályt és láthatóságot.

Amikor a függvény visszatér, és egy panel található, dwAlignment tartalmazza a megadott pont igazítását. Ha például a pont a panel tetejéhez volt legközelebb, dwAlignment CBRS_ALIGN_TOP értékre van állítva.

CMDIChildWndEx::RecalcLayout

Újraszámítja az ablak elrendezését.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Paraméterek

bNotify
[in] Ha IGAZ, az ablak aktív helyszíni eleme értesítést kap az elrendezés módosításáról.

CMDIChildWndEx::RemovePaneFromDockManager

Eltávolít egy panelt a dokkolókezelőből.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Paraméterek

pControlBar
[in] Az eltávolítandó ablaktábla mutatója.

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.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Paraméterek

[in] p

Megjegyzések

CMDIChildWndEx::ShowPane

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Paraméterek

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Megjegyzések

CMDIChildWndEx::UpdateTaskbarTabIcon

Frissíti a Windows 7 tálcalap ikont.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Paraméterek

hIcon
A Windows 7 tálcán megjelenítendő ikon fogópontja.

Megjegyzések

CMDIChildWndEx::UnregisterTaskbarTab

Eltávolítja az MDI-gyermeket a Windows 7 tálcák lapjairól.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Paraméterek

bCheckRegisteredMDIChildCount
Megadja, hogy a függvénynek ellenőriznie kell-e az MDI-lapon regisztrált MDI-gyermekek számát. Ha ez a szám 0, akkor ez a függvény eltávolítja a kivágási téglalapot az alkalmazás tálcájának miniatűrjából.

Megjegyzések

CMDIChildWndEx::SetTaskbarThumbnailClipRect

A keretrendszer meghívta, hogy állítsa be a kivágási téglalapot, hogy kijelölje az ablak ügyfélterületének egy részét, hogy az az ablak miniatűrjeként jelenjen meg a tálcán.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Paraméterek

Az új kivágási téglalapot adja meg. Ha a téglalap üres vagy null értékű, a kivágás törlődik.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

CMDIChildWndEx::SetTaskbarTabProperties

A Windows 7 tálcák lapjának tulajdonságait állítja be.

void SetTaskbarTabProperties(DWORD dwFlags);

Paraméterek

dwFlags
AZ STPFLAG értékek kombinációja. További információ: ITaskbarList4::SetTabProperties.

Megjegyzések

CMDIChildWndEx::SetTaskbarTabOrder

Beszúrja az MDI-gyermeket a megadott ablak elé a Windows 7 tálcán.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Paraméterek

pWndBefore
Mutató az MDI gyermekablakára, amelynek miniatűrje a bal oldalon van beszúrva. Ezt az ablakot már regisztrálni kell a RegisterTaskbarTab. Ha ez az érték NULL, a rendszer hozzáadja az új miniatűrt a lista végéhez.

Megjegyzések

CMDIChildWndEx::SetTaskbarTabActive

Aktiválja a megfelelő Windows 7 tálcát.

void SetTaskbarTabActive();

Megjegyzések

CMDIChildWndEx::RegisterTaskbarTab

Az MDI-gyermek regisztrálása Windows 7 tálcás lapokkal.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Paraméterek

Megjegyzések

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

A keretrendszer meghívja, ha bitképet kell kinyújtania egy Windows 7 tálcás lap miniatűrjének előnézetéhez az MDI-gyermekhez.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Paraméterek

hBmpDst
Egy célbitkép leírója.

rectDst
A cél téglalapot adja meg.

hBmpSrc
Egy forrásbitkép leírója.

rectSrc
Megadja a forrás téglalapot.

Megjegyzések

Követelmény: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

A keretrendszer meghívja, amikor a Tálca lap miniatűrjének fel kell dolgoznia a WM_MOUSEACTIVATE üzenetet.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Paraméterek

pDesktopWnd
Az aktivált ablak felső szintű szülőablakára mutató mutatót ad meg. Előfordulhat, hogy a mutató ideiglenes, ezért nem tárolható.

nHitTest
Megadja a hit-test terület kódját. A találati teszt egy olyan teszt, amely meghatározza a kurzor helyét.

üzenet
Megadja az egér üzenetszámát.

Megjegyzések

Az alapértelmezett implementáció aktiválja a kapcsolódó MDI gyermekkeretet.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

A keretrendszer meghívja, amikor a Tálca lap miniatűrjének fel kell dolgoznia a WM_ACTIVATE üzenetet.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Paraméterek

nState
Megadja, hogy a CWnd aktiválva vagy inaktiválva van-e.

pWndOther
Mutasson az aktivált vagy inaktivált CWnd. A mutató null értékű lehet, és ideiglenes is lehet.

bMinimized
Az aktivált vagy inaktivált CWnd minimális állapotát adja meg. A TRUE érték azt jelzi, hogy az ablak kis méretű.

Megjegyzések

Az alapértelmezett implementáció aktiválja a kapcsolódó MDI gyermekkeretet.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

A keretrendszer meghívja, amikor a felhasználó lenyomja a Bezárás gombot a Tálca lap miniatűrjén.

virtual void OnPressTaskbarThmbnailCloseButton();

Megjegyzések

CMDIChildWndEx::OnGetIconicThumbnail

A keretrendszer meghívja, amikor bitképet kell beszereznie az MDI-gyermek ikonikus miniatűrjéhez.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Paraméterek

nWidth
Megadja a szükséges bitkép szélességét.

nHeight
Megadja a szükséges bitkép magasságát.

Megjegyzések

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

A keretrendszer meghívta, amikor bitképet kell beszereznie az MDI-gyermek élő előnézetéhez.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Paraméterek

bIsMDIChildActive
Ez a paraméter IGAZ, ha a bitkép az MDI-gyermekhez van kérve, amely jelenleg aktív, és a főablak nincs minimalizálva. Ebben az esetben az alapértelmezett feldolgozás pillanatképet készít a főablakról.

ptLocation
Megadja a bitkép helyét a fő (legfelső szintű) ablak ügyfélkoordinátáiban. Ezt a pontot a hívónak kell megadnia.

Visszaadott érték

Ha feldolgozásra kerül, egy fogópontot ad vissza egy érvényes 32bpp-os bitképhez, ellenkező esetben NULL értékre.

Megjegyzések

Bírálja felül ezt a metódust egy származtatott osztályban, és adjon vissza érvényes 32bpp bitképet az MDI-gyermek élő előzetes verziójához. Ezt a metódust csak akkor hívjuk meg, ha az MDI-gyermek megjelenik a Windows 7 tálcán. Null érték visszaadása esetén az MFC meghívja az alapértelmezett kezelőket, és bitképeket szerez be PrintClient vagy PrintWindowhasználatával.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

A keretrendszer által a SetTaskbarTabProperties metódusnak átadott jelzők kombinációja, amikor egy lap (MDI-gyermek) regisztrálva van a Windows 7 tálcán.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Megjegyzések

Az alapértelmezett kombináció a STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Azt jelzi, hogy az ablak ügyfélterületének egy részének automatikus kijelölése engedélyezve vagy letiltva van-e, mivel az ablak miniatűrje engedélyezve van a tálcán.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Visszaadott érték

IGAZ értéket ad vissza, ha az ablak ügyfélterületének egy részének automatikus kijelölése engedélyezve van; egyéb esetben HAMIS.

Megjegyzések

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Azt jelzi, hogy az MDI-gyermek megjelenhet-e a Windows 7 tálcán.

BOOL IsTaskbarTabsSupportEnabled();

Visszaadott érték

IGAZ, ha az MDI-gyermek megjelenhet a Windows 7 tálcán; HAMIS, ha az MDI gyermek nem jelenik meg a Windows 7 tálcán.

Megjegyzések

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Igaz értéket ad vissza, ha az MDI-gyermek sikeresen regisztrálva lett a Windows 7 tálcán.

BOOL IsRegisteredWithTaskbarTabs();

Visszaadott érték

IGAZ, ha az MDI-gyermek regisztrálva van a Windows 7 tálcán; egyéb esetben HAMIS.

Megjegyzések

CMDIChildWndEx::InvalidateIconicBitmaps

Érvényteleníti az MDI-gyermek ikonikus bitkép-ábrázolását.

BOOL InvalidateIconicBitmaps();

Visszaadott érték

HAMIS értéket ad vissza, ha a Windows 7 tálcájának támogatása le van tiltva, vagy ha az MDI gyermek nincs regisztrálva a Windows 7 tálcák lapján; ellenkező esetben IGAZ értéket ad vissza.

Megjegyzések

Akkor kell meghívni, ha egy MDI-gyermek élő tartalma vagy mérete megváltozott.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

A keretrendszer meghívja, amikor ki kell választania az ablak ügyfélterületének egy részét, hogy az ablak miniatűrjeként jelenjen meg a tálcán.

virtual CRect GetTaskbarThumbnailClipRect() const;

Visszaadott érték

Téglalap az ablakok koordinátáiban. Ez a téglalap a felső szintű keret ügyfélterületére van leképezve. A kivágási téglalap törléséhez a téglalapnak üresnek kell lennie.

Megjegyzések

CMDIChildWndEx::GetTaskbarPreviewWnd

A keretrendszer meghívja, ha gyermekablakot (általában nézetet vagy osztóablakot) kell beszereznie, hogy megjelenjen a Windows 7 tálcájának miniatűrjén.

virtual CWnd* GetTaskbarPreviewWnd();

Visszaadott érték

Érvényes mutatót kell visszaadnia egy CWnd objektumnak, amelynek előnézetét az MDI-gyermekhez kapcsolódó Windows 7 tálcán kell megjeleníteni. Az alapértelmezett implementáció ennek az MDI-gyermeknek egy gyermekablakát adja vissza AFX_IDW_PANE_FIRST vezérlőazonosítóval (amely általában egy CView-származtatott osztály).

Megjegyzések

CMDIChildWndEx::GetTabProxyWnd

A Windows 7 tálcán regisztrált lapproxy ablakát adja vissza.

CMDITabProxyWnd* GetTabProxyWnd();

Visszaadott érték

Mutató egy CMDITabProxyWnd objektumra, amely a Windows 7 tálcák lapján van regisztrálva.

Megjegyzések

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Engedélyezi vagy letiltja az ablak ügyfélterületének egy részének automatikus kijelölését, hogy az az ablak miniatűrjeként jelenjen meg a tálcán.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Paraméterek

bEnable
Megadja, hogy engedélyezi-e (IGAZ) vagy tiltsa le a (HAMIS) automatikus kijelölést az ablak ügyfélterületének egy részének megjelenítéséhez.

Megjegyzések

CMDIChildWndEx::CanShowOnTaskBarTabs

Megadja a keretrendszernek, hogy ez az MDI-gyermek megjeleníthető-e a Windows 7 tálcán.

virtual BOOL CanShowOnTaskBarTabs();

Visszaadott érték

IGAZ, ha az MDI-gyermek tartalma megjeleníthető a Windows 7 tálcán miniatűrökön.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban, és hamis értéket ad vissza, hogy letiltsa ennek az MDI-gyermeknek a megjelenését a Windows 7 tálcán.

CMDIChildWndEx::ActivateTopLevelFrame

A keretrendszer meghívta, hogy aktiválja a felső szintű keretet, amikor az alkalmazás aktiválva van egy tálcán.

virtual void ActivateTopLevelFrame();

Megjegyzések

Lásd még:

hierarchiadiagram
osztályok
CMDIChildWnd osztály
CMFCWindowsManagerDialog osztály
CMDIFrameWndEx osztály

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

CMDIChildWndEx osztály

Szintaxis

Tagok

Nyilvános metódusok

Megjegyzések

Példa

Öröklési hierarchia

Követelmények

CMDIChildWndEx::AddPane

Paraméterek

Visszaadott érték

CMDIChildWndEx::AddTabbedPane

Paraméterek

CMDIChildWndEx::AdjustDockingLayout

Paraméterek

CMDIChildWndEx::CanShowOnMDITabs

Visszaadott érték

Megjegyzések

CMDIChildWndEx::CanShowOnWindowsList

Visszaadott érték

Megjegyzések

CMDIChildWndEx::D ockPane

Paraméterek

Megjegyzések

CMDIChildWndEx::D ockPaneLeftOf

Paraméterek

Visszaadott érték

Megjegyzések

CMDIChildWndEx::EnableAutoHidePanes

Paraméterek

Visszaadott érték

CMDIChildWndEx::EnableDocking

Paraméterek

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetDockingManager

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetDocumentName

Visszaadott érték

Megjegyzések

Példa

CMDIChildWndEx::GetFrameIcon

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetFrameText

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetPane

Paraméterek

Visszaadott érték

CMDIChildWndEx::GetRelatedTabGroup

Visszaadott érték

Megjegyzések

CMDIChildWndEx::GetTabbedPane

Visszaadott érték

CMDIChildWndEx::GetToolbarButtonToolTipText

Visszaadott érték

Megjegyzések

CMDIChildWndEx::InsertPane

Paraméterek

Visszaadott érték

CMDIChildWndEx::IsPointNearDockSite

Paraméterek

Visszaadott érték

Megjegyzések

CMDIChildWndEx::IsReadOnly

Visszaadott érték

Megjegyzések

Példa

CMDIChildWndEx::IsTabbedPane

Visszaadott érték

CMDIChildWndEx::OnMoveMiniFrame

Paraméterek

Visszaadott érték

CMDIChildWndEx::OnSetPreviewMode

Paraméterek

CMDIChildWndEx::OnUpdateFrameTitle

Paraméterek