CMDIChildWndEx-klasse

Artikel
03/17/2025

De CMDIChildWndEx-klasse biedt de functionaliteit van een onderliggend venster van Windows meerdere documentinterfaces (MDI). Het breidt de functionaliteit van CMDIChildWnd Classuit. Voor het framework is deze klasse vereist wanneer een MDI-toepassing bepaalde MFC-klassen gebruikt.

Zie de broncode in de map VC\atlmfc\src\mfc map van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMDIChildWndEx : public CMDIChildWnd

Leden

Openbare methoden

Naam	Beschrijving
CMDIChildWndEx::ActivateTopLevelFrame	Intern aangeroepen door het framework om frame op het hoogste niveau te activeren wanneer de toepassing moet worden geactiveerd vanaf een taakbalktabblad.
`CMDIChildWndEx::AddDockSite`	Deze methode wordt niet gebruikt of geïmplementeerd.
CMDIChildWndEx::AddPane	Hiermee voegt u een deelvenster toe.
CMDIChildWndEx::AddTabbedPane	Hiermee voegt u een deelvenster met tabbladen toe.
CMDIChildWndEx::AdjustDockingLayout	Hiermee past u de dockingindeling aan.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Geeft aan of dit MDI-onderliggend element op de taakbalktabbladen van Windows 7 kan worden weergegeven.
CMDIChildWndEx::CanShowOnWindowsList	Retourneert TRUE als de naam van het onderliggende MDI-venster kan worden weergegeven in het dialoogvenster CMFCWindowsManagerDialog Class. Anders wordt ONWAAR geretourneerd.
`CMDIChildWndEx::CreateObject`	Wordt aangeroepen door het framework om een dynamisch exemplaar van dit klassetype te maken.
CMDIChildWndEx::D ockPane-	Dockt een deelvenster.
CMDIChildWndEx::D ockPaneLeftOf	Hiermee wordt het ene deelvenster aan de linkerkant van een ander deelvenster gekoppeld.
CMDIChildWndEx::EnableAutoHidePanes	Hiermee schakelt u de modus automatisch verbergen in voor deelvensters wanneer ze aan de opgegeven zijden van het venster zijn vastgezet.
CMDIChildWndEx::EnableDocking	Hiermee kunt u het onderliggend venster aan het hoofdframe dokken.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Hiermee kunt u automatische selectie van een gedeelte van het clientgebied van een venster in- of uitschakelen om weer te geven als miniatuur van dat venster op de taakbalk.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Retourneert de naam van het document dat wordt weergegeven in het onderliggende MDI-venster.
CMDIChildWndEx::GetFrameIcon	Aangeroepen door het framework om het pictogram van het onderliggende MDI-venster op te halen.
CMDIChildWndEx::GetFrameText	Wordt aangeroepen door het framework om de tekst voor het onderliggende MDI-venster op te halen.
CMDIChildWndEx::GetPane	Hiermee vindt u een deelvenster met de opgegeven besturingselement-id.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Hiermee wordt een aanwijzer geretourneerd naar een ingesloten dockingvenster dat is geconverteerd naar een document met tabbladen.
CMDIChildWndEx::GetTabProxyWnd	Hiermee wordt het proxyvenster voor tabbladen geretourneerd dat daadwerkelijk is geregistreerd bij de taakbalktabbladen van Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd	Wordt aangeroepen door het framework wanneer het een onderliggend venster (meestal een weergave- of splitsvenster) moet ophalen dat moet worden weergegeven op de miniatuur van het tabblad windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Aangeroepen door het framework wanneer het een gedeelte van het clientgebied van een venster moet selecteren om weer te geven als miniatuur van dat venster op de taakbalk.
`CMDIChildWndEx::GetThisClass`	Aangeroepen door het framework om een aanwijzer te verkrijgen naar de CRuntimeClass-object dat is gekoppeld aan dit klassetype.
CMDIChildWndEx::GetToolbarButtonToolTipText	Aangeroepen door het framework om knopinfo voor een werkbalkknop op te halen.
CMDIChildWndEx::InsertPane-	Registreert het opgegeven deelvenster met de dockingmanager.
CMDIChildWndEx::InvalidateIconicBitmaps	Ongeldige bitmapweergave van MDI-kind.
CMDIChildWndEx::IsPointNearDockSite	Bepaalt of een opgegeven punt zich in de buurt van de docksite bevindt.
CMDIChildWndEx::IsReadOnly	Retourneert TRUE als het document dat wordt weergegeven in het onderliggende venster alleen-lezen is. Anders wordt ONWAAR geretourneerd.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Retourneert TRUE als het MDI-kind is geregistreerd bij de taakbalktabbladen van Windows 7.
CMDIChildWndEx::IsTabbedPane	Retourneert TRUE als het onderliggende MDI-venster een dockingvenster bevat. Anders wordt ONWAAR geretourneerd.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Hiermee wordt aangegeven of het MDI-kind kan worden weergegeven op tabbladen op de taakbalk van Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Hiermee wordt aangegeven of automatische selectie van een gedeelte van het clientgebied van een venster wordt weergegeven als de miniatuur van dat venster op de taakbalk is ingeschakeld of uitgeschakeld.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Een combinatie van vlaggen, die door het framework worden doorgegeven aan de methode SetTaskbarTabProperties, wanneer een tabblad (MDI-onderliggend) wordt geregistreerd bij tabbladen van de Windows 7-taakbalk. De standaardcombinatie is `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Wordt aangeroepen door het framework wanneer er een bitmap moet worden verkregen voor livevoorbeeld van het MDI-kind.
CMDIChildWndEx::OnGetIconicThumbnail	Wordt aangeroepen door het framework wanneer er een bitmap moet worden verkregen voor iconische miniatuur van MDI-kind.
CMDIChildWndEx::OnMoveMiniFrame	Aangeroepen door het framework om een miniframevenster te verplaatsen.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten op de miniatuur van het tabblad Taakbalk drukt.
CMDIChildWndEx::OnSetPreviewMode	Aangeroepen door het framework om de afdrukvoorbeeldmodus in of uit te schakelen.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Aangeroepen door het framework wanneer de miniatuur van het tabblad Taakbalk WM_ACTIVATE bericht moet verwerken.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Aangeroepen door het framework wanneer de miniatuur van het tabblad Taakbalk WM_MOUSEACTIVATE bericht moet verwerken.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Aangeroepen door het framework wanneer het een bitmap moet uitrekken voor het miniatuurvoorbeeld van het tabblad Windows 7 op de taakbalk van het MDI-kind.
CMDIChildWndEx::OnUpdateFrameTitle	Aangeroepen door het framework om de titel van het frame bij te werken. (Overschrijft `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx::P aneFromPoint-	Retourneert het deelvenster dat het opgegeven punt bevat.
`CMDIChildWndEx::PreTranslateMessage`	Wordt gebruikt door klasse CWinApp om vensterberichten te vertalen voordat ze worden verzonden naar de TranslateMessage- en DispatchMessage Windows-functies. (Overschrijft CWnd::P reTranslateMessage.)
CMDIChildWndEx::RecalcLayout-	Berekent de indeling van het venster opnieuw.
CMDIChildWndEx::RegisterTaskbarTab	Registreert MDI-onderliggend element met windows 7-taakbalktabbladen.
CMDIChildWndEx::RemovePaneFromDockManager	Hiermee verwijdert u een deelvenster uit het dockingbeheer.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Hiermee activeert u het bijbehorende tabblad van de Windows 7-taakbalk.
CMDIChildWndEx::SetTaskbarTabOrder	Voegt MDI-onderliggend element in voordat het opgegeven venster op de taakbalktabbladen van Windows 7 wordt weergegeven.
CMDIChildWndEx::SetTaskbarTabProperties	Hiermee stelt u eigenschappen in voor een tabblad van de Windows 7-taakbalk.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Intern aangeroepen door het framework om de rechthoek voor knippen in te stellen om een deel van het clientgebied van een venster te selecteren om weer te geven als de miniatuur van dat venster op de taakbalk.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Hiermee verwijdert u MDI-onderliggend element uit de taakbalktabbladen van Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon	Hiermee werkt u het tabbladpictogram van de Windows 7-taakbalk bij.

Opmerkingen

Als u wilt profiteren van uitgebreide dockingfuncties in MDI-toepassingen, leidt u de MDI-onderliggende vensterklasse van uw toepassing af van CMDIChildWndEx in plaats van CMDIChildWnd.

Voorbeeld

In het volgende voorbeeld wordt een klasse afgeleid van CMDIChildWndEx. Dit codefragment is afkomstig uit het VisualStudioDemo-voorbeeld: 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()
};

Overnamehiërarchie

Eisen

header: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Hiermee voegt u een deelvenster toe.

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

Parameters

pControlBar-
[in] Een aanwijzer naar het deelvenster.

bTail-
[in] TRUE om het deelvenster toe te voegen aan het einde van de lijst met deelvensters voor het dockingbeheer; anders, ONWAAR.

Retourwaarde

WAAR als het deelvenster is geregistreerd bij de dockingmanager; anders, ONWAAR.

CMDIChildWndEx::AddTabbedPane

Hiermee voegt u een deelvenster met tabbladen toe.

void AddTabbedPane(CDockablePane* pControlBar);

Parameters

pControlBar-
[in] Een aanwijzer naar het deelvenster.

CMDIChildWndEx::AdjustDockingLayout

Hiermee past u de dockingindeling aan.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameters

[in] Greep naar een uitgestelde positiestructuur van het venster.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Retourwaarde

Opmerkingen

CMDIChildWndEx::CanShowOnWindowsList

Hiermee geeft u op of de naam van het onderliggende MDI-venster kan worden weergegeven in het dialoogvenster CMFCWindowsManagerDialog Class.

virtual BOOL CanShowOnWindowsList();

Retourwaarde

WAAR als het venster kan worden weergegeven in het dialoogvenster Windows; anders, ONWAAR.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse en retourneer ONWAAR als het venster niet moet worden weergegeven in het dialoogvenster Windows. Deze functie wordt aangeroepen vanuit CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Dockt een deelvenster.

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

Parameters

pBar-
[in] Een aanwijzer naar het deelvenster.

nDockBarID-
[in] De id van het deelvenster.

lpRect-
[in] Een aanwijzer naar een rechthoek.

Opmerkingen

De parameter lpRect wordt niet gebruikt.

CMDIChildWndEx::D ockPaneLeftOf

Hiermee wordt het ene deelvenster aan de linkerkant van een ander deelvenster gekoppeld.

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

Parameters

pBar-
Een aanwijzer naar het deelvenster dat moet worden gedokt.

pLeftOf-
Een aanwijzer naar het deelvenster dat als referentiepunt fungeert.

Retourwaarde

TRUE on success, FALSE on failure.

Opmerkingen

Met deze methode wordt het deelvenster gebruikt dat is opgegeven door pBar- en wordt het aan de linkerkant van het deelvenster gekoppeld dat is opgegeven door pLeftOf.

Roep deze methode aan wanneer u meerdere deelvensters in vooraf gedefinieerde volgorde wilt docken.

CMDIChildWndEx::EnableAutoHidePanes

Hiermee schakelt u de modus automatisch verbergen in voor deelvensters wanneer ze aan de opgegeven zijden van het venster zijn vastgezet.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameters

dwDockStyle-
[in] Hiermee geeft u de zijkanten van het hoofdframevenster dat is ingeschakeld. Gebruik een of meer van de volgende vlaggen.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Retourwaarde

WAAR als de methode slaagt; anders ONWAAR.

CMDIChildWndEx::EnableDocking

Hiermee kunt u het onderliggend venster aan het hoofdframe dokken.

BOOL EnableDocking(DWORD dwDockStyle);

Parameters

dwDockStyle-
[in] Hiermee geeft u de dockinguitlijning op die moet worden ingeschakeld.

Retourwaarde

WAAR als de methode slaagt; anders ONWAAR.

Opmerkingen

Roep deze methode aan om dockinguitlijning naar het hoofdframe mogelijk te maken. U kunt een combinatie van CBRS_ALIGN_ vlaggen doorgeven (zie CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetDocumentName

Retourneert de naam van het document dat wordt weergegeven in het onderliggende MDI-venster.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Retourwaarde

Een aanwijzer naar een tekenreeks die de naam van een document bevat.

Opmerkingen

Een document is wat het onderliggende MDI-venster weergeeft. Over het algemeen worden in het venster gegevens weergegeven die zijn geladen van of opgeslagen in een bestand. Daarom is de naam van het document de naam van het bestand. De standaard implementatie van GetDocumentName retourneert een tekenreeks die is verkregen uit CDocument::GetPathName.

Als in het venster een document wordt weergegeven dat niet uit een bestand is geladen, overschrijft u deze methode in een afgeleide klasse en retourneert u een unieke document-id.

GetDocumentName wordt aangeroepen door het framework wanneer het de status van alle geopende documenten opslaat. De geretourneerde tekenreeks wordt naar het register geschreven.

Wanneer het framework de status later herstelt, wordt de documentnaam gelezen uit het register en doorgegeven aan CMDIFrameWndEx::CreateDocumentWindow. Overschrijf deze methode in een CMDIFrameWndEx-afgeleide klasse en maak of open een document met deze naam en lees het bestand met deze naam. Als het document niet is gebaseerd op een bestand, maakt u het document op basis van de document-id zelf. U moet de voorgaande acties alleen uitvoeren als u documenten wilt opslaan en herstellen.

Voorbeeld

In het volgende voorbeeld ziet u het gebruik van de methode GetDocumentName. Dit codefragment is afkomstig uit het VisualStudioDemo-voorbeeld: MFC Visual Studio Application.

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

CMDIChildWndEx::GetFrameIcon

Aangeroepen door het framework om het pictogram van het onderliggende MDI-venster op te halen.

virtual HICON GetFrameIcon() const;

Retourwaarde

Een greep naar het vensterpictogram.

Opmerkingen

Deze methode wordt aangeroepen door het framework om te bepalen welk pictogram moet worden weergegeven op het tabblad MDI dat het onderliggende framevenster van MDI bevat.

Deze methode retourneert standaard het vensterpictogram. Overschrijf GetFrameIcon in een CMDIChildWndEx-afgeleide klasse om dit gedrag aan te passen.

CMDIChildWndEx::GetFrameText

Wordt aangeroepen door het framework om de tekst voor het onderliggende MDI-venster op te halen.

virtual CString GetFrameText() const;

Retourwaarde

Een tekenreeks die de tekst van het framevenster bevat.

Opmerkingen

Deze methode wordt aangeroepen door het framework om te bepalen welke tekst moet worden weergegeven op het tabblad MDI dat het onderliggende framevenster van MDI bevat.

Deze methode retourneert standaard de venstertekst. Overschrijf GetFrameText in een CMDIChildWndEx-afgeleide klasse om dit gedrag aan te passen.

CMDIChildWndEx::GetPane

Hiermee vindt u een deelvenster met de opgegeven besturingselement-id.

CBasePane* GetPane(UINT nID);

Parameters

nID-
[in] De besturingselement-id van het deelvenster om te zoeken.

Retourwaarde

Een aanwijzer naar het deelvenster indien gevonden, anders NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetTabbedPane

Hiermee wordt een aanwijzer geretourneerd naar een dockingvenster dat deel uitmaakt van een groep documenten met tabbladen met MDI.

CDockablePane* GetTabbedPane() const;

Retourwaarde

Een aanwijzer naar een dockingvenster dat deel uitmaakt van een groep documenten met tabbladen met MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Aangeroepen door het framework om knopinfo voor een werkbalkknop op te halen.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Retourwaarde

WAAR als de knopinfo is weergegeven. De standaard implementatie retourneert FALSE.

Opmerkingen

Overschrijf deze methode als u aangepaste knopinfo voor werkbalkknoppen wilt weergeven.

CMDIChildWndEx::InsertPane

Registreert het opgegeven deelvenster met de dockingmanager.

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

Parameters

pControlBar-
[in] Een aanwijzer naar het deelvenster dat u wilt invoegen.

pTarget-
[in] Een aanwijzer naar het aangrenzende deelvenster.

[in] Als WAAR is, wordt pControlBar- ingevoegd na pTarget-. Als ONWAAR, pControlBar wordt ingevoegd voordat pTarget.

Retourwaarde

WAAR als de methode slaagt, anders ONWAAR.

CMDIChildWndEx::IsPointNearDockSite

Bepaalt of een opgegeven punt zich in de buurt van de docksite bevindt.

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

Parameters

punt
[in] Het opgegeven punt.

dwBarAlignment-
[in] Hiermee geeft u op welke rand het punt zich in de buurt bevindt. Mogelijke waarden zijn CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP en CBRS_ALIGN_BOTTOM

bOuterEdge-
[in] WAAR als het punt zich in de buurt van de buitenrand van de docksite bevindt; ANDERS ONWAAR.

Retourwaarde

WAAR als het punt zich in de buurt van de docksite bevindt; anders ONWAAR.

Opmerkingen

Het punt bevindt zich in de buurt van de docksite wanneer deze zich binnen de gevoeligheidsset in het dockingbeheer bevindt. De standaardgevoeligheid is 15 pixels.

CMDIChildWndEx::IsReadOnly

Hiermee geeft u op of het document dat wordt weergegeven in het onderliggende venster alleen-lezen is.

virtual BOOL IsReadOnly();

Retourwaarde

WAAR als het document het kenmerk Alleen-lezen heeft; anders ONWAAR.

Opmerkingen

Deze functie wordt gebruikt om het opslaan van alleen-lezen documenten te voorkomen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode IsReadOnly overschrijft. Dit codefragment is afkomstig uit het VisualStudioDemo-voorbeeld: MFC Visual Studio Application.

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

CMDIChildWndEx::IsTabbedPane

Hiermee geeft u op of het onderliggende MDI-venster een dockingvenster bevat.

BOOL IsTabbedPane() const;

Retourwaarde

WAAR als het onderliggende MDI-venster een dockingvenster bevat dat is geconverteerd naar een document met tabbladen; anders ONWAAR.

CMDIChildWndEx::OnMoveMiniFrame

Aangeroepen door het framework om een miniframevenster te verplaatsen.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameters

pFrame-
[in] Een aanwijzer naar een miniframevenster.

Retourwaarde

WAAR als de methode slaagt, anders ONWAAR.

CMDIChildWndEx::OnSetPreviewMode

Aangeroepen door het framework om de afdrukvoorbeeldmodus in of uit te schakelen.

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

Parameters

[in] Als WAAR, voert u de afdrukvoorbeeldmodus in. Als ONWAAR, sluit u de afdrukvoorbeeldmodus af.

pState-
[in] Een aanwijzer naar de statusstructuur van het afdrukvoorbeeld.

CMDIChildWndEx::OnUpdateFrameTitle

Aangeroepen door het framework om de titel van het frame bij te werken.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameters

bAddToTitle-
[in] Als WAAR is, voegt u de documentnaam toe aan de titel.

CMDIChildWndEx::P aneFromPoint

Retourneert het deelvenster dat het opgegeven punt bevat.

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

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parameters

punt
[in] Hiermee geeft u het punt, in schermcoördinaten, om te controleren.

[in] Verhoog het zoekgebied met dit bedrag. Een deelvenster voldoet aan de zoekcriteria als het opgegeven punt in het verhoogde gebied valt.

bExactBar-
[in] TRUE om de nSensitivity parameter te negeren; anders, ONWAAR.

pRTCBarType-
[in] Als dat niet NULL is, doorzoekt de methode alleen deelvensters van het opgegeven type.

dwAlignment-
[in] Als een deelvenster op het opgegeven punt wordt gevonden, bevat deze parameter de zijkant van het deelvenster dat het dichtst bij het opgegeven punt lag. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

Een aanwijzer naar het CBasePane-afgeleide object dat het opgegeven punt bevat of NULL als er geen deelvenster is gevonden.

Opmerkingen

Roep deze methode aan om te bepalen of een deelvenster het opgegeven punt bevat volgens de opgegeven voorwaarden, zoals runtimeklasse en zichtbaarheid.

Wanneer de functie wordt geretourneerd en er een deelvenster is gevonden, bevat dwAlignment de uitlijning van het opgegeven punt. Als het punt zich bijvoorbeeld het dichtst bij de bovenkant van het deelvenster bevindt, wordt dwAlignment- ingesteld op CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Berekent de indeling van het venster opnieuw.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameters

bNotify-
[in] Als WAAR is, ontvangt het actieve in-place item voor het venster een melding van de indelingswijziging.

CMDIChildWndEx::RemovePaneFromDockManager

Hiermee verwijdert u een deelvenster uit het dockingbeheer.

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

Parameters

pControlBar-
[in] Een aanwijzer naar het deelvenster dat u wilt verwijderen.

bDestroy-
[in] Als WAAR is, wordt het verwijderde deelvenster vernietigd.

bAdjustLayout-
[in] Indien WAAR, past u de dockingindeling onmiddellijk aan.

bAutoHide-
[in] Als WAAR is, is de dockingindeling gerelateerd aan de lijst met autohidebalken. Als ONWAAR is, is de dockingindeling gerelateerd aan de lijst met normale deelvensters.

pBarReplacement-
[in] Een aanwijzer naar een deelvenster dat het verwijderde deelvenster vervangt.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parameters

[in] p

Opmerkingen

CMDIChildWndEx::ShowPane

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

Parameters

[in] pBar

[in] bShow

[in]

Opmerkingen

CMDIChildWndEx::UpdateTaskbarTabIcon

Hiermee werkt u het tabbladpictogram van de Windows 7-taakbalk bij.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parameters

hIcon-
Een greep naar een pictogram dat moet worden weergegeven op het tabblad windows 7 op de taakbalk.

Opmerkingen

CMDIChildWndEx::UnregisterTaskbarTab

Hiermee verwijdert u het MDI-onderliggend element uit de taakbalktabbladen van Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parameters

bCheckRegisteredMDIChildCount
Hiermee geeft u op of deze functie het aantal MDI-kinderen moet controleren dat is geregistreerd bij MDI-tabbladen. Als dit getal 0 is, verwijdert deze functie de rechthoek voor knippen uit de miniatuur van de taakbalk van de toepassing.

Opmerkingen

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Aangeroepen door het framework om de rechthoek voor het knippen in te stellen om een deel van het clientgebied van een venster te selecteren om weer te geven als de miniatuur van dat venster op de taakbalk.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parameters

rect
Hiermee geeft u de nieuwe rechthoek voor knippen. Als de rechthoek leeg of null is, wordt de knipsel verwijderd.

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

CMDIChildWndEx::SetTaskbarTabProperties

Hiermee stelt u eigenschappen in voor een tabblad van de Windows 7-taakbalk.

void SetTaskbarTabProperties(DWORD dwFlags);

Parameters

dwFlags-
Een combinatie van STPFLAG-waarden. Zie ITaskbarList4::SetTabPropertiesvoor meer informatie.

Opmerkingen

CMDIChildWndEx::SetTaskbarTabOrder

Hiermee voegt u het MDI-onderliggend element in voor het opgegeven venster op de taakbalktabbladen van Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parameters

pWndBefore-
Een aanwijzer naar het onderliggende MDI-venster waarvan de miniatuur aan de linkerkant wordt ingevoegd. Dit venster moet al zijn geregistreerd via RegisterTaskbarTab. Als deze waarde NULL is, wordt de nieuwe miniatuur toegevoegd aan het einde van de lijst.

Opmerkingen

CMDIChildWndEx::SetTaskbarTabActive

Hiermee activeert u het bijbehorende tabblad van de Windows 7-taakbalk.

void SetTaskbarTabActive();

Opmerkingen

CMDIChildWndEx::RegisterTaskbarTab

Registreert het MDI-kind met tabbladen op de taakbalk van Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parameters

Opmerkingen

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Wordt aangeroepen door het framework wanneer er een bitmap moet worden uitgerekt voor een miniatuurvoorbeeld van het tabblad Windows 7 op de taakbalk van het MDI-kind.

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

Parameters

hBmpDst-
Een ingang naar een doel bitmap.

rectDst-
Hiermee geeft u de doelrechthoek op.

hBmpSrc-
Een ingang naar een bron bitmap.

rectSrc-
Hiermee geeft u de bronrechthoek op.

Opmerkingen

Vereiste: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Aangeroepen door het framework wanneer de miniatuur van het tabblad Taakbalk het WM_MOUSEACTIVATE bericht moet verwerken.

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

Parameters

pDesktopWnd-
Hiermee geeft u een aanwijzer naar het bovenliggende venster op het hoogste niveau van het venster dat wordt geactiveerd. De aanwijzer kan tijdelijk zijn en mag niet worden opgeslagen.

nHitTest-
Hiermee geeft u de hit-test net code. Een hittest is een test die de locatie van de cursor bepaalt.

bericht
Hiermee geeft u het nummer van het muisbericht op.

Opmerkingen

De standaardimplementatie activeert het gerelateerde MDI-onderliggende frame.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Aangeroepen door het framework wanneer de miniatuur van het tabblad Taakbalk het WM_ACTIVATE bericht moet verwerken.

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

Parameters

nState-
Hiermee geeft u op of de CWnd wordt geactiveerd of gedeactiveerd.

pWndOther
Aanwijzer naar de CWnd die wordt geactiveerd of gedeactiveerd. De aanwijzer kan NULL zijn en kan tijdelijk zijn.

geminimiseerde
Hiermee geeft u de geminimaliseerde status van de CWnd wordt geactiveerd of gedeactiveerd. Een waarde van TRUE geeft aan dat het venster is geminimaliseerd.

Opmerkingen

De standaardimplementatie activeert het gerelateerde MDI-onderliggende frame.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten op de miniatuur van het tabblad Taakbalk drukt.

virtual void OnPressTaskbarThmbnailCloseButton();

Opmerkingen

CMDIChildWndEx::OnGetIconicThumbnail

Wordt aangeroepen door het framework wanneer er een bitmap moet worden verkregen voor de iconische miniatuur van het MDI-kind.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parameters

nWidth-
Hiermee geeft u de breedte van de vereiste bitmap.

nHeight-
Hiermee geeft u de hoogte van de vereiste bitmap.

Opmerkingen

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Wordt aangeroepen door het framework wanneer er een bitmap moet worden verkregen voor livevoorbeeld van het MDI-kind.

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

Parameters

bIsMDIChildActive
Deze parameter is TRUE als de bitmap wordt aangevraagd voor het MDI-onderliggende element, dat momenteel actief is en het hoofdvenster niet wordt geminimaliseerd. De standaardverwerking in dit geval maakt een momentopname van het hoofdvenster.

ptLocation-
Hiermee geeft u de locatie van de bitmap in de hoofdvenstercoördinaten van het hoofdvenster (hoogste niveau). Dit punt moet worden verstrekt door de geroepen.

Retourwaarde

Als dit wordt verwerkt, retourneert u een ingang naar een geldige bitmap van 32bpp, anders NULL.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse en retourneer een geldige bitmap van 32bpp voor livevoorbeeld van MDI-onderliggende items. Deze methode wordt alleen aangeroepen wanneer het onderliggende MDI-element wordt weergegeven op de taakbalktabbladen van Windows 7. Als u NULL retourneert, roept MFC de standaardhandlers aan en verkrijgt ze bitmaps met behulp van PrintClient of PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Een combinatie van vlaggen, die door het framework worden doorgegeven aan de methode SetTaskbarTabProperties, wanneer een tabblad (MDI-onderliggend) wordt geregistreerd bij de taakbalktabbladen van Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Opmerkingen

De standaardcombinatie is STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Hiermee wordt aangegeven of automatische selectie van een gedeelte van het clientgebied van een venster wordt weergegeven als de miniatuur van dat venster op de taakbalk is ingeschakeld of uitgeschakeld.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Retourwaarde

Retourneert TRUE als automatische selectie van een gedeelte van het clientgebied van een venster dat moet worden weergegeven, is ingeschakeld; anders ONWAAR.

Opmerkingen

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Hiermee wordt aangegeven of het MDI-kind kan worden weergegeven op tabbladen op de taakbalk van Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Retourwaarde

WAAR als het MDI-onderliggend element op de taakbalktabbladen van Windows 7 kan worden weergegeven; ONWAAR als het MDI-kind niet kan worden weergegeven op tabbladen op de taakbalk van Windows 7.

Opmerkingen

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Retourneert TRUE als het MDI-kind is geregistreerd bij de taakbalktabbladen van Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Retourwaarde

WAAR als het MDI-kind is geregistreerd bij de taakbalktabbladen van Windows 7; anders ONWAAR.

Opmerkingen

CMDIChildWndEx::InvalidateIconicBitmaps

Ongeldig een iconische bitmapweergave van een MDI-kind.

BOOL InvalidateIconicBitmaps();

Retourwaarde

Retourneert ONWAAR als windows 7-taakbalkondersteuning is uitgeschakeld of het MDI-kind niet is geregistreerd bij de taakbalktabbladen van Windows 7; retourneert anders WAAR.

Opmerkingen

Moet worden aangeroepen wanneer de live-inhoud of -grootte van een MDI-kind is gewijzigd.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Aangeroepen door het framework wanneer het een gedeelte van het clientgebied van een venster moet selecteren om weer te geven als miniatuur van dat venster op de taakbalk.

virtual CRect GetTaskbarThumbnailClipRect() const;

Retourwaarde

Een rechthoek in venstercoördinaten. Deze rechthoek wordt toegewezen aan het clientgebied van het frame op het hoogste niveau. De rechthoek moet leeg zijn om de rechthoek met uitknipsels te wissen.

Opmerkingen

CMDIChildWndEx::GetTaskbarPreviewWnd

Aangeroepen door het framework wanneer er een onderliggend venster (meestal een weergave- of splitsvenster) moet worden weergegeven op een miniatuur van het tabblad Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Retourwaarde

Als een geldige aanwijzer wordt geretourneerd naar een CWnd-object, waarvan de preview moet worden weergegeven op een windows 7-taakbalktabblad met betrekking tot dit MDI-onderliggende element. De standaardimplementatie retourneert een onderliggend venster van dit MDI-kind met AFX_IDW_PANE_FIRST controle-id (meestal een CView-afgeleide klasse).

Opmerkingen

CMDIChildWndEx::GetTabProxyWnd

Retourneert het tabbladproxyvenster dat is geregistreerd bij de taakbalktabbladen van Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Retourwaarde

Een aanwijzer naar een CMDITabProxyWnd-object, dat is geregistreerd bij de taakbalktabbladen van Windows 7.

Opmerkingen

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Hiermee kunt u automatische selectie van een gedeelte van het clientgebied van een venster in- of uitschakelen om weer te geven als miniatuur van dat venster op de taakbalk.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parameters

bEnable-
Hiermee geeft u op of automatische selectie van een gedeelte van het clientgebied van een venster (WAAR) moet worden ingeschakeld of uitgeschakeld (ONWAAR).

Opmerkingen

CMDIChildWndEx::CanShowOnTaskBarTabs

Geeft aan of dit MDI-onderliggend element op de taakbalktabbladen van Windows 7 kan worden weergegeven.

virtual BOOL CanShowOnTaskBarTabs();

Retourwaarde

WAAR als de inhoud van het MDI-onderliggende element kan worden weergegeven op de taakbalkminiaturen van Windows 7.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse en retourneer FALSE om het uiterlijk van dit MDI-onderliggend element uit te schakelen op tabbladen op de Windows 7-taakbalk.

CMDIChildWndEx::ActivateTopLevelFrame

Aangeroepen door het framework om het frame op het hoogste niveau te activeren wanneer de toepassing wordt geactiveerd vanaf een taakbalktabblad.

virtual void ActivateTopLevelFrame();

Opmerkingen

Zie ook

Hiërarchiegrafiek
klassen
CMDIChildWnd Class
CMFCWindowsManagerDialog-klasse
CMDIFrameWndEx-klasse

Share via

CMDIChildWndEx-klasse

Syntaxis

Leden

Openbare methoden

Opmerkingen

Voorbeeld

Overnamehiërarchie

Eisen

CMDIChildWndEx::AddPane

Parameters

Retourwaarde

CMDIChildWndEx::AddTabbedPane

Parameters

CMDIChildWndEx::AdjustDockingLayout

Parameters

CMDIChildWndEx::CanShowOnMDITabs

Retourwaarde

Opmerkingen

CMDIChildWndEx::CanShowOnWindowsList

Retourwaarde

Opmerkingen

CMDIChildWndEx::D ockPane

Parameters

Opmerkingen

CMDIChildWndEx::D ockPaneLeftOf

Parameters

Retourwaarde

Opmerkingen

CMDIChildWndEx::EnableAutoHidePanes

Parameters

Retourwaarde

CMDIChildWndEx::EnableDocking

Parameters

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetDockingManager

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetDocumentName

Retourwaarde

Opmerkingen

Voorbeeld

CMDIChildWndEx::GetFrameIcon

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetFrameText

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetPane

Parameters

Retourwaarde

CMDIChildWndEx::GetRelatedTabGroup

Retourwaarde

Opmerkingen

CMDIChildWndEx::GetTabbedPane

Retourwaarde

CMDIChildWndEx::GetToolbarButtonToolTipText

Retourwaarde

Opmerkingen

CMDIChildWndEx::InsertPane

Parameters

Retourwaarde

CMDIChildWndEx::IsPointNearDockSite

Parameters

Retourwaarde

Opmerkingen

CMDIChildWndEx::IsReadOnly

Retourwaarde

Opmerkingen

Voorbeeld

CMDIChildWndEx::IsTabbedPane

Retourwaarde

CMDIChildWndEx::OnMoveMiniFrame

Parameters

Retourwaarde

CMDIChildWndEx::OnSetPreviewMode

Parameters

CMDIChildWndEx::OnUpdateFrameTitle

Parameters