Dela via


CMDIChildWndEx-klass

Klassen CMDIChildWndEx innehåller funktionerna i ett underordnat fönster för Windows multidokumentgränssnitt (MDI). Den utökar funktionerna i CMDIChildWnd Class. Ramverket kräver den här klassen när ett MDI-program använder vissa MFC-klasser.

Mer information finns i källkoden i mappen VC\atlmfc\src\mfc i Visual Studio-installationen.

Syntax

class CMDIChildWndEx : public CMDIChildWnd

Medlemmar

Offentliga metoder

Namn Beskrivning
CMDIChildWndEx::ActivateTopLevelFrame Anropas internt av ramverket för att aktivera ram på översta nivån när programmet ska aktiveras från en flik i aktivitetsfältet.
CMDIChildWndEx::AddDockSite Den här metoden används inte eller implementeras.
CMDIChildWndEx::AddPane Lägger till ett fönster.
CMDIChildWndEx::AddTabbedPane Lägger till ett fönster med flikar.
CMDIChildWndEx::AdjustDockingLayout Justerar dockningslayouten.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs Anger för ramverket om det här MDI-underordnad objektet kan visas på flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::CanShowOnWindowsList Returnerar TRUE om det underordnade MDI-fönstrets namn kan visas i dialogrutan CMFCWindowsManagerDialog Class. Annars returneras FALSE.
CMDIChildWndEx::CreateObject Anropas av ramverket för att skapa en dynamisk instans av den här klasstypen.
CMDIChildWndEx::D ockPane Dockar ett fönster.
CMDIChildWndEx::D ockPaneLeftOf Dockar ett fönster till vänster om ett annat fönster.
CMDIChildWndEx::EnableAutoHidePanes Aktiverar automatiskt döljläge för fönster när de dockas på de angivna sidorna av fönstret.
CMDIChildWndEx::EnableDocking Aktiverar dockning av det underordnade fönstret till huvudramen.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect Aktiverar eller inaktiverar automatiskt val av en del av ett fönsters klientområde som ska visas som fönstrets miniatyrbild i aktivitetsfältet.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName Returnerar namnet på dokumentet som visas i det underordnade MDI-fönstret.
CMDIChildWndEx::GetFrameIcon Anropas av ramverket för att hämta den underordnade MDI-fönsterikonen.
CMDIChildWndEx::GetFrameText Anropas av ramverket för att hämta texten för det underordnade MDI-fönstret.
CMDIChildWndEx::GetPane Söker efter ett fönster med det angivna kontroll-ID:t.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane Returnerar en pekare till ett inbäddat dockningsfönster som konverterades till ett tabbdokument.
CMDIChildWndEx::GetTabProxyWnd Returnerar flikproxyfönstret som faktiskt har registrerats med flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd Anropas av ramverket när det behöver skaffa ett underordnat fönster (vanligtvis en vy eller ett delningsfönster) som ska visas i miniatyrbilden för aktivitetsfältet i Windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect Anropas av ramverket när det behöver välja en del av ett fönsters klientområde som ska visas som fönstrets miniatyrbild i aktivitetsfältet.
CMDIChildWndEx::GetThisClass Anropas av ramverket för att hämta en pekare till det CRuntimeClass- objekt som är associerat med den här klasstypen.
CMDIChildWndEx::GetToolbarButtonToolTipText Anropas av ramverket för att hämta en knappbeskrivning för en verktygsfältsknapp.
CMDIChildWndEx::InsertPane Registrerar det angivna fönstret med dockningshanteraren.
CMDIChildWndEx::InvalidateIconicBitmaps Ogiltigförklarar ikonisk bitmappsrepresentation av MDI-underordnad.
CMDIChildWndEx::IsPointNearDockSite Avgör om en angiven punkt ligger nära dockningsplatsen.
CMDIChildWndEx::IsReadOnly Returnerar TRUE om dokumentet som visas i det underordnade fönstret är skrivskyddat. Annars returneras FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs Returnerar TRUE om MDI-underordnad registrerades med flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::IsTabbedPane Returnerar TRUE om det underordnade MDI-fönstret innehåller ett dockningsfönster. Annars returneras FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled Anger om MDI-underordnad kan visas på flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled Anger om automatiskt val av en del av ett fönsters klientområde ska visas som miniatyrbild i aktivitetsfältet är aktiverat eller inaktiverat.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags En kombination av flaggor som skickas av ramverket till metoden SetTaskbarTabProperties när en flik (MDI-underordnad) registreras med flikarna i Aktivitetsfältet i Windows 7. Standardkombinationen är STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap Anropas av ramverket när det behöver hämta en bitmapp för liveförhandsgranskning av MDI-underordnad.
CMDIChildWndEx::OnGetIconicThumbnail Anropas av ramverket när det behöver hämta en bitmapp för ikonisk miniatyrbild av MDI-underordnad.
CMDIChildWndEx::OnMoveMiniFrame Anropas av ramverket för att flytta ett miniramfönster.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton Anropas av ramverket när användaren trycker på knappen Stäng i miniatyrbilden på fliken Aktivitetsfältet.
CMDIChildWndEx::OnSetPreviewMode Anropas av ramverket för att ange eller avsluta förhandsgranskningsläget.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate Anropas av ramverket när miniatyrbilden på fliken Aktivitetsfältet ska bearbeta WM_ACTIVATE meddelande.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate Anropas av ramverket när miniatyrbilden på fliken Aktivitetsfältet ska bearbeta WM_MOUSEACTIVATE meddelande.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch Anropas av ramverket när det behöver sträcka ut en bitmapp för windows 7-fliken miniatyrbild för underordnad MDI.
CMDIChildWndEx::OnUpdateFrameTitle Anropas av ramverket för att uppdatera ramrubriken. (Åsidosätter CMDIChildWnd::OnUpdateFrameTitle.)
CMDIChildWndEx::P aneFromPoint Returnerar fönstret som innehåller den angivna punkten.
CMDIChildWndEx::PreTranslateMessage Används av klassen CWinApp för att översätta fönstermeddelanden innan de skickas till funktionerna TranslateMessage och DispatchMessage Windows. (Åsidosätter CWnd::P reTranslateMessage.)
CMDIChildWndEx::RecalcLayout Beräknar om layouten för fönstret.
CMDIChildWndEx::RegisterTaskbarTab Registrerar MDI-underordnad med flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager Tar bort ett fönster från dockningshanteraren.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive Aktiverar motsvarande flik i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::SetTaskbarTabOrder Infogar MDI-underordnad före angivet fönster på flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties Anger egenskaper för en flik i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect Anropas internt av ramverket för att ange urklippsrektangeln för att välja en del av ett fönsters klientområde som ska visas som fönstrets miniatyrbild i aktivitetsfältet.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab Tar bort MDI-underordnad från flikarna i Aktivitetsfältet i Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon Uppdaterar flikikonen i Aktivitetsfältet i Windows 7.

Anmärkningar

Om du vill dra nytta av utökade dockningsfunktioner i MDI-program härleder du den underordnade MDI-fönsterklassen för ditt program från CMDIChildWndEx i stället för CMDIChildWnd-.

Exempel

I följande exempel härleds en klass från CMDIChildWndEx. Det här kodfragmentet kommer från VisualStudioDemo-exempel: 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()
};

Arvshierarki

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIChildWnd

CMDIChildWndEx

Krav

Rubrik: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Lägger till ett fönster.

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

Parametrar

pControlBar
[i] En pekare till fönstret.

bTail
[i] TRUE för att lägga till fönstret i slutet av listan över fönster för dockningshanteraren. annars FALSKT.

Returvärde

SANT om fönstret har registrerats med dockningshanteraren. annars FALSKT.

CMDIChildWndEx::AddTabbedPane

Lägger till ett fönster med flikar.

void AddTabbedPane(CDockablePane* pControlBar);

Parametrar

pControlBar
[i] En pekare till fönstret.

CMDIChildWndEx::AdjustDockingLayout

Justerar dockningslayouten.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parametrar

hdwp
[i] Hantera till en uppskjuten fönsterpositionsstruktur.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Returvärde

Anmärkningar

CMDIChildWndEx::CanShowOnWindowsList

Anger om namnet på det underordnade MDI-fönstret kan visas i dialogrutan CMFCWindowsManagerDialog Class.

virtual BOOL CanShowOnWindowsList();

Returvärde

SANT om fönstret kan visas i dialogrutan Windows. annars FALSKT.

Anmärkningar

Åsidosätt den här metoden i en härledd klass och returnera FALSE om fönstret inte ska visas i dialogrutan Windows. Den här funktionen anropas från CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Dockar ett fönster.

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

Parametrar

pBar
[i] En pekare till fönstret.

nDockBarID
[i] Fönstrets ID.

lpRect
[i] En pekare till en rektangel.

Anmärkningar

Parametern lpRect används inte.

CMDIChildWndEx::D ockPaneLeftOf

Dockar ett fönster till vänster om ett annat fönster.

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

Parametrar

pBar
En pekare till fönstret som ska dockas.

pLeftOf
En pekare till fönstret som fungerar som referenspunkt.

Returvärde

SANT vid lyckat fel, FALSKT vid fel.

Anmärkningar

Den här metoden tar fönstret som anges av pBar och dockar det till vänster i fönstret som anges av pLeftOf.

Anropa den här metoden när du vill docka flera fönster i fördefinierad ordning.

CMDIChildWndEx::EnableAutoHidePanes

Aktiverar automatiskt döljläge för fönster när de dockas på de angivna sidorna av fönstret.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametrar

dwDockStyle
[i] Anger sidorna i huvudramfönstret som är aktiverat. Använd en eller flera av följande flaggor.

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

Returvärde

TRUE om metoden lyckas; annars FALSKT.

CMDIChildWndEx::EnableDocking

Aktiverar dockning av det underordnade fönstret till huvudramen.

BOOL EnableDocking(DWORD dwDockStyle);

Parametrar

dwDockStyle
[i] Anger den dockningsjustering som ska aktiveras.

Returvärde

TRUE om metoden lyckas; annars FALSKT.

Anmärkningar

Anropa den här metoden för att aktivera dockningsjustering till huvudramen. Du kan skicka en kombination av CBRS_ALIGN_ flaggor (mer information finns i CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Returvärde

Anmärkningar

CMDIChildWndEx::GetDocumentName

Returnerar namnet på dokumentet som visas i det underordnade MDI-fönstret.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Returvärde

En pekare till en sträng som innehåller namnet på ett dokument.

Anmärkningar

Ett dokument är vad det underordnade MDI-fönstret visar. I allmänhet visar fönstret data som läses in från eller sparas i en fil. Därför är namnet på dokumentet namnet på filen. Standardimplementeringen av GetDocumentName returnerar en sträng som hämtats från CDocument::GetPathName.

Om fönstret visar ett dokument som inte läses in från en fil åsidosätter du den här metoden i en härledd klass och returnerar en unik dokumentidentifierare.

GetDocumentName anropas av ramverket när det sparar tillståndet för alla öppnade dokument. Den returnerade strängen skrivs till registret.

När ramverket återställer tillståndet senare läss dokumentnamnet från registret och skickas till CMDIFrameWndEx::CreateDocumentWindow. Åsidosätt den här metoden i en CMDIFrameWndEx-derived-klass och skapa eller öppna ett dokument som har det här namnet och läsa i filen som har det här namnet. Om dokumentet inte baseras på en fil skapar du dokumentet baserat på själva dokumentidentifieraren. Du bör endast utföra föregående åtgärder om du tänker spara och återställa dokument.

Exempel

I följande exempel visas användningen av metoden GetDocumentName. Det här kodfragmentet kommer från VisualStudioDemo-exempel: MFC Visual Studio Application.

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

CMDIChildWndEx::GetFrameIcon

Anropas av ramverket för att hämta ikonen för det underordnade MDI-fönstret.

virtual HICON GetFrameIcon() const;

Returvärde

Ett handtag till fönsterikonen.

Anmärkningar

Den här metoden anropas av ramverket för att avgöra vilken ikon som ska visas på fliken MDI som innehåller det underordnade MDI-ramfönstret.

Som standard returnerar den här metoden fönsterikonen. Åsidosätt GetFrameIcon i en CMDIChildWndEx-härledd klass för att anpassa det här beteendet.

CMDIChildWndEx::GetFrameText

Anropas av ramverket för att hämta texten för det underordnade MDI-fönstret.

virtual CString GetFrameText() const;

Returvärde

En sträng som innehåller ramfönstrets text.

Anmärkningar

Den här metoden anropas av ramverket för att avgöra vilken text som ska visas på fliken MDI som innehåller det underordnade MDI-ramfönstret.

Som standard returnerar den här metoden fönstertexten. Åsidosätt GetFrameText i en CMDIChildWndEx-härledd klass för att anpassa det här beteendet.

CMDIChildWndEx::GetPane

Söker efter ett fönster med det angivna kontroll-ID:t.

CBasePane* GetPane(UINT nID);

Parametrar

nID
[i] Kontroll-ID för fönstret som ska hittas.

Returvärde

En pekare till fönstret om den hittas, annars NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Returvärde

Anmärkningar

CMDIChildWndEx::GetTabbedPane

Returnerar en pekare till ett dockningsfönster som ingår i en grupp med MDI-flikar.

CDockablePane* GetTabbedPane() const;

Returvärde

En pekare till ett dockningsfönster som ingår i en grupp med MDI-flikar.

CMDIChildWndEx::GetToolbarButtonToolTipText

Anropas av ramverket för att hämta en knappbeskrivning för en verktygsfältsknapp.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Returvärde

SANT om knappbeskrivningen har visats. Standardimplementeringen returnerar FALSE.

Anmärkningar

Åsidosätt den här metoden om du vill visa tips för anpassade verktyg för verktygsfältsknappar.

CMDIChildWndEx::InsertPane

Registrerar det angivna fönstret med dockningshanteraren.

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

Parametrar

pControlBar
[i] En pekare till fönstret som ska infogas.

pTarget
[i] En pekare till det intilliggande fönstret.

bAfter
[i] Om true infogas pControlBar efter pTarget. Om false infogas pControlBar innan pTarget.

Returvärde

SANT om metoden lyckas, ANNARS FALSE.

CMDIChildWndEx::IsPointNearDockSite

Avgör om en angiven punkt ligger nära dockningsplatsen.

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

Parametrar

punkt
[i] Den angivna punkten.

dwBarAlignment
[i] Anger vilken kant punkten är nära. Möjliga värden är CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP och CBRS_ALIGN_BOTTOM

bOuterEdge
[i] SANT om punkten ligger nära den yttre kantlinjen för dockningsplatsen. ANNARS FALSKT.

Returvärde

SANT om punkten ligger nära dockningsplatsen. annars FALSKT.

Anmärkningar

Punkten ligger nära dockningsplatsen när den ligger inom känslighetsuppsättningen i dockningshanteraren. Standardkänsligheten är 15 bildpunkter.

CMDIChildWndEx::IsReadOnly

Anger om dokumentet som visas i det underordnade fönstret är skrivskyddat.

virtual BOOL IsReadOnly();

Returvärde

SANT om dokumentet är skrivskyddat. annars FALSKT.

Anmärkningar

Den här funktionen används för att förhindra att skrivskyddade dokument sparas.

Exempel

I följande exempel visas åsidosättande av metoden IsReadOnly. Det här kodfragmentet kommer från VisualStudioDemo-exempel: MFC Visual Studio Application.

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

CMDIChildWndEx::IsTabbedPane

Anger om det underordnade MDI-fönstret innehåller ett dockningsfönster.

BOOL IsTabbedPane() const;

Returvärde

SANT om det underordnade MDI-fönstret innehåller ett dockningsfönster som konverterades till ett tabbdokument. annars FALSKT.

CMDIChildWndEx::OnMoveMiniFrame

Anropas av ramverket för att flytta ett miniramfönster.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametrar

pFrame
[i] En pekare till ett miniramfönster.

Returvärde

TRUE om metoden lyckas, annars FALSE.

CMDIChildWndEx::OnSetPreviewMode

Anropas av ramverket för att ange eller avsluta förhandsgranskningsläget.

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

Parametrar

bFörhandsversion
[i] Om SANT anger du förhandsgranskningsläge. Om det är FALSKT avslutar du förhandsgranskningsläget.

pState
[i] En pekare till tillståndsstrukturen för förhandsgranskningen.

CMDIChildWndEx::OnUpdateFrameTitle

Anropas av ramverket för att uppdatera ramrubriken.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parametrar

bAddToTitle
[i] Om det är SANT lägger du till dokumentnamnet i rubriken.

CMDIChildWndEx::P aneFromPoint

Returnerar fönstret som innehåller den angivna punkten.

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

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

Parametrar

punkt
[i] Anger den punkt i skärmkoordinater som ska kontrolleras.

nKänslighet
[i] Öka sökområdet med den här mängden. Ett fönster uppfyller sökvillkoren om den angivna punkten faller i det ökade området.

bExactBar
[i] TRUE för att ignorera parametern nSensitivity; annars FALSKT.

pRTCBarType
[i] Om inte NULL söker metoden bara i fönster av den angivna typen.

dwAlignment
[i] Om en ruta hittas på den angivna punkten innehåller den här parametern den sida av fönstret som var närmast den angivna punkten. Mer information finns i avsnittet Anmärkningar.

Returvärde

En pekare till det CBasePane-derived-objekt som innehåller den angivna punkten eller NULL om inget fönster hittades.

Anmärkningar

Anropa den här metoden för att avgöra om ett fönster innehåller den angivna punkten enligt de angivna villkoren, till exempel körningsklass och synlighet.

När funktionen returnerar och ett fönster hittades innehåller dwAlignment justeringen för den angivna punkten. Om punkten till exempel var närmast toppen av fönstret är dwAlignment- inställd på CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Beräknar om layouten för fönstret.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametrar

bNotify
[i] Om TRUE visas ett meddelande om layoutändringen för det aktiva objektet på plats för fönstret.

CMDIChildWndEx::RemovePaneFromDockManager

Tar bort ett fönster från dockningshanteraren.

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

Parametrar

pControlBar
[i] En pekare till fönstret som du vill ta bort.

bDestroy
[i] Om DET är SANT förstörs det borttagna fönstret.

bAdjustLayout
[i] Om det är SANT justerar du dockningslayouten omedelbart.

bAutoHide
[i] Om TRUE är dockningslayouten relaterad till listan över autohide-staplar. Om false är dockningslayouten relaterad till listan över vanliga fönster.

pBarReplacement
[i] En pekare till ett fönster som ersätter det borttagna fönstret.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parametrar

[in] p

Anmärkningar

CMDIChildWndEx::ShowPane

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

Parametrar

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Anmärkningar

CMDIChildWndEx::UpdateTaskbarTabIcon

Uppdaterar flikikonen i Aktivitetsfältet i Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parametrar

hIcon
Ett handtag till en ikon som ska visas på fliken i Aktivitetsfältet i Windows 7.

Anmärkningar

CMDIChildWndEx::UnregisterTaskbarTab

Tar bort MDI-underordnad från flikarna i Aktivitetsfältet i Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parametrar

bCheckRegisteredMDIChildCount
Anger om den här funktionen behöver kontrollera antalet MDI-underordnade som registrerats med MDI-flikar. Om det här talet är 0 tar den här funktionen bort urklippsrektangeln från programmets miniatyrbild i aktivitetsfältet.

Anmärkningar

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Anropas av ramverket för att ange urklippsrektangeln för att välja en del av ett fönsters klientområde som ska visas som det fönstrets miniatyrbild i aktivitetsfältet.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parametrar

rect
Anger den nya urklippsrektangeln. Om rektangeln är tom eller null tas urklipp bort.

Returvärde

SANT om det lyckas; annars FALSKT.

Anmärkningar

CMDIChildWndEx::SetTaskbarTabProperties

Anger egenskaper för en flik i Aktivitetsfältet i Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parametrar

dwFlags
En kombination av STPFLAG-värden. Mer information finns i ITaskbarList4::SetTabProperties.

Anmärkningar

CMDIChildWndEx::SetTaskbarTabOrder

Infogar MDI-underordnad före det angivna fönstret på flikarna i Aktivitetsfältet i Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parametrar

pWndBefore
En pekare till det underordnade MDI-fönstret vars miniatyrbild infogas till vänster. Det här fönstret måste redan vara registrerat via RegisterTaskbarTab. Om det här värdet är NULL läggs den nya miniatyrbilden till i slutet av listan.

Anmärkningar

CMDIChildWndEx::SetTaskbarTabActive

Aktiverar motsvarande flik i Aktivitetsfältet i Windows 7.

void SetTaskbarTabActive();

Anmärkningar

CMDIChildWndEx::RegisterTaskbarTab

Registrerar MDI-underordnad med flikarna i Aktivitetsfältet i Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parametrar

pWndBefore
En pekare till det underordnade MDI-fönstret vars miniatyrbild infogas till vänster. Det här fönstret måste redan vara registrerat via RegisterTaskbarTab. Om det här värdet är NULL läggs den nya miniatyrbilden till i slutet av listan.

Anmärkningar

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Anropas av ramverket när den behöver sträcka ut en bitmapp för en miniatyrbild av MDI-underordnad windows 7-flikminiatyr.

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

Parametrar

hBmpDst
Ett handtag till en målbitmapp.

rectDst
Anger målrektangeln.

hBmpSrc
Ett handtag till en källbitmapp.

rectSrc
Anger källrektangeln.

Anmärkningar

Krav: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Anropas av ramverket när miniatyrbilden på fliken Aktivitetsfältet ska bearbeta WM_MOUSEACTIVATE meddelandet.

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

Parametrar

pDesktopWnd
Anger en pekare till det överordnade fönstret på den översta nivån i fönstret som aktiveras. Pekaren kan vara tillfällig och bör inte lagras.

nHitTest
Anger träfftestets riktnummer. Ett träfftest är ett test som avgör markörens plats.

meddelande
Anger musmeddelandenumret.

Anmärkningar

Standardimplementeringen aktiverar den relaterade underordnade MDI-ramen.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Anropas av ramverket när miniatyrbilden på fliken Aktivitetsfältet ska bearbeta WM_ACTIVATE meddelandet.

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

Parametrar

nState
Anger om CWnd aktiveras eller inaktiveras.

pWndOther
Pekare till CWnd aktiveras eller inaktiveras. Pekaren kan vara NULL och kan vara tillfällig.

bMinimiserad
Anger det minimerade tillståndet för CWnd som aktiveras eller inaktiveras. Värdet TRUE anger att fönstret är minimerat.

Anmärkningar

Standardimplementeringen aktiverar den relaterade underordnade MDI-ramen.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Anropas av ramverket när användaren trycker på knappen Stäng i miniatyrbilden på fliken Aktivitetsfältet.

virtual void OnPressTaskbarThmbnailCloseButton();

Anmärkningar

CMDIChildWndEx::OnGetIconicThumbnail

Anropas av ramverket när det behöver hämta en bitmapp för den ikoniska miniatyrbilden av MDI-barnet.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parametrar

nWidth
Anger bredden på den nödvändiga bitmappen.

nHeight
Anger höjden på den nödvändiga bitmappen.

Anmärkningar

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Anropas av ramverket när det behöver hämta en bitmapp för liveförhandsgranskning av MDI-underordnad.

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

Parametrar

bIsMDIChildActive
Den här parametern är TRUE om bitmappen begärs för MDI-underordnad, som för närvarande är aktiv och huvudfönstret inte minimeras. Standardbearbetningen i det här fallet tar en ögonblicksbild av huvudfönstret.

ptLocation
Anger platsen för bitmappen i huvudklientkoordinaterna för huvudfönstret (den översta nivån). Den här punkten bör tillhandahållas av den anropade.

Returvärde

Om det bearbetas returneras ett handtag till en giltig 32bpp-bitmapp, annars NULL.

Anmärkningar

Åsidosätt den här metoden i en härledd klass och returnera en giltig 32bpp-bitmapp för liveförhandsgranskning av MDI-underordnad. Den här metoden anropas endast när MDI-underordnad visas på flikarna i Aktivitetsfältet i Windows 7. Om du returnerar NULL anropar MFC standardhanterarna och hämtar bitmappar med hjälp av PrintClient eller PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

En kombination av flaggor som skickas av ramverket till metoden SetTaskbarTabProperties, när en flik (MDI-underordnad) registreras med flikarna i Aktivitetsfältet i Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Anmärkningar

Standardkombinationen är STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Anger om automatiskt val av en del av ett fönsters klientområde ska visas som miniatyrbild i aktivitetsfältet är aktiverat eller inaktiverat.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Returvärde

Returnerar TRUE om automatisk markering av en del av ett fönsters klientområde som ska visas är aktiverat. annars FALSKT.

Anmärkningar

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Anger om MDI-underordnad kan visas på flikarna i Aktivitetsfältet i Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Returvärde

SANT om MDI-underordnad kan visas på flikarna i Aktivitetsfältet i Windows 7. FALSKT om MDI-underordnad inte kan visas på flikarna i Aktivitetsfältet i Windows 7.

Anmärkningar

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Returnerar TRUE om MDI-underordnad registrerades med flikarna i Aktivitetsfältet i Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Returvärde

SANT om MDI-underordnad är registrerad med flikarna i Aktivitetsfältet i Windows 7. annars FALSKT.

Anmärkningar

CMDIChildWndEx::InvalidateIconicBitmaps

Ogiltigförklarar en ikonisk bitmappsrepresentation av ett MDI-underordnat objekt.

BOOL InvalidateIconicBitmaps();

Returvärde

Returnerar FALSE om stöd för Aktivitetsfältet i Windows 7 är inaktiverat eller om MDI-underordnad inte har registrerats med flikarna i Aktivitetsfältet i Windows 7. annars returneras TRUE.

Anmärkningar

Ska anropas när liveinnehållet eller storleken på ett MDI-underordnat objekt har ändrats.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Anropas av ramverket när det behöver välja en del av ett fönsters klientområde som ska visas som fönstrets miniatyrbild i aktivitetsfältet.

virtual CRect GetTaskbarThumbnailClipRect() const;

Returvärde

En rektangel i windowskoordinater. Den här rektangeln mappas till klientområdet i den översta bildrutan. Rektangeln ska vara tom för att rensa urklippsrektangeln.

Anmärkningar

CMDIChildWndEx::GetTaskbarPreviewWnd

Anropas av ramverket när det behöver hämta ett underordnat fönster (vanligtvis en vy eller ett delningsfönster) som ska visas på en miniatyrbild av aktivitetsfältet i Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Returvärde

Bör returnera en giltig pekare till ett CWnd objekt, vars förhandsgranskning ska visas på en flik i Aktivitetsfältet i Windows 7 som är relaterad till det här MDI-underordnad objektet. Standardimplementeringen returnerar ett underordnat fönster för detta MDI-underordnat med AFX_IDW_PANE_FIRST kontroll-ID (som vanligtvis är en CView-härledd klass).

Anmärkningar

CMDIChildWndEx::GetTabProxyWnd

Returnerar det flikproxyfönster som registrerats med flikarna i Aktivitetsfältet i Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Returvärde

En pekare till ett CMDITabProxyWnd objekt, som är registrerat med flikarna i Aktivitetsfältet i Windows 7.

Anmärkningar

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Aktiverar eller inaktiverar automatiskt val av en del av ett fönsters klientområde som ska visas som fönstrets miniatyrbild i aktivitetsfältet.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parametrar

bEnable
Anger om du vill aktivera (TRUE) eller inaktivera automatisk markering (FALSE) av en del av ett fönsters klientområde som ska visas.

Anmärkningar

CMDIChildWndEx::CanShowOnTaskBarTabs

Anger för ramverket om det här MDI-underordnad objektet kan visas på flikarna i Aktivitetsfältet i Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Returvärde

SANT om innehållet i det underordnade MDI-objektet kan visas på miniatyrbilderna i Aktivitetsfältet i Windows 7.

Anmärkningar

Åsidosätt den här metoden i en härledd klass och returnera FALSE för att inaktivera utseendet på det här MDI-barnet på flikarna i Aktivitetsfältet i Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Anropas av ramverket för att aktivera den översta bildrutan när programmet aktiveras från en flik i aktivitetsfältet.

virtual void ActivateTopLevelFrame();

Anmärkningar

Se även

hierarkidiagram
klasser
CMDIChildWnd-klass
CMFCWindowsManagerDialog Class
CMDIFrameWndEx-klass