CMDIChildWndEx-Klasse

Artikel
10/12/2023

Die CMDIChildWndEx Klasse stellt die Funktionalität eines untergeordneten Windows-Fensters für mehrere Dokumentschnittstellen (MDI) bereit. Sie erweitert die Funktionalität der CMDIChildWnd-Klasse. Das Framework benötigt diese Klasse, wenn eine MDI-Anwendung bestimmte MFC-Klassen verwendet.

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CMDIChildWndEx : public CMDIChildWnd

Member

Öffentliche Methoden

Name	Beschreibung
CMDIChildWndEx::ActivateTopLevelFrame	Wird intern vom Framework aufgerufen, um den Frame der obersten Ebene zu aktivieren, wenn die Anwendung über eine Taskleistenregisterkarte aktiviert werden soll.
`CMDIChildWndEx::AddDockSite`	Diese Methode wird nicht verwendet oder implementiert.
CMDIChildWndEx::AddPane	Fügt einen Bereich hinzu.
CMDIChildWndEx::AddTabbedPane	Fügt einen Registerkartenbereich hinzu.
CMDIChildWndEx::AdjustDockingLayout	Passt das Andocklayout an.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Teilt dem Framework mit, ob dieses untergeordnete MDI-Element auf Windows 7-Taskleistenregistern angezeigt werden kann.
CMDIChildWndEx::CanShowOnWindowsList	Gibt TRUE zurück, wenn der name des untergeordneten MDI-Fensters im Dialogfeld CMFCWindowsManagerDialog -Klasse angezeigt werden kann. Andernfalls wird FALSE zurückgegeben.
`CMDIChildWndEx::CreateObject`	Vom Framework aufgerufen, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMDIChildWndEx::D ockPane	Dockt einen Bereich an.
CMDIChildWndEx::D ockPaneLeftOf	Dockt einen Bereich auf der linken Seite eines anderen Bereichs an.
CMDIChildWndEx::EnableAutoHidePanes	Aktiviert den Modus "Automatisches Ausblenden" für Bereiche, wenn sie an den angegebenen Seiten des Fensters angedockt werden.
CMDIChildWndEx::EnableDocking	Aktiviert das Andocken des untergeordneten Fensters an den Hauptrahmen.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Aktiviert oder deaktiviert die automatische Auswahl eines Teils des Clientbereichs eines Fensters, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Gibt den Namen des Dokuments zurück, das im untergeordneten MDI-Fenster angezeigt wird.
CMDIChildWndEx::GetFrameIcon	Vom Framework aufgerufen, um das untergeordnete MDI-Fenstersymbol abzurufen.
CMDIChildWndEx::GetFrameText	Vom Framework aufgerufen, um den Text für das untergeordnete MDI-Fenster abzurufen.
CMDIChildWndEx::GetPane	Sucht einen Bereich nach der angegebenen Steuerelement-ID.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Gibt einen Zeiger auf einen eingebetteten Andockbereich zurück, der in ein Dokument mit Registerkarten konvertiert wurde.
CMDIChildWndEx::GetTabProxyWnd	Gibt das Registerkartenproxyfenster zurück, das tatsächlich mit Windows 7-Taskleistenregistern registriert wurde.
CMDIChildWndEx::GetTaskbarPreviewWnd	Wird vom Framework aufgerufen, wenn es ein untergeordnetes Fenster (in der Regel ein Ansichts- oder Teilerfenster) abrufen muss, das auf der Miniaturansicht der Windows 7-Taskleiste angezeigt werden soll.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Wird vom Framework aufgerufen, wenn ein Teil des Clientbereichs eines Fensters ausgewählt werden muss, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.
`CMDIChildWndEx::GetThisClass`	Vom Framework aufgerufen, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMDIChildWndEx::GetToolbarButtonToolTipText	Vom Framework aufgerufen, um eine QuickInfo für eine Symbolleistenschaltfläche abzurufen.
CMDIChildWndEx::InsertPane	Registriert den angegebenen Bereich mit dem Docking-Manager.
CMDIChildWndEx::InvalidateIconicBitmaps	Ungültige Iconic-Bitmapdarstellung des untergeordneten MDI-Elements.
CMDIChildWndEx::IsPointNearDockSite	Bestimmt, ob sich ein angegebener Punkt in der Nähe des Dockstandorts befindet.
CMDIChildWndEx::IsReadOnly	Gibt TRUE zurück, wenn das Dokument, das im untergeordneten Fenster angezeigt wird, schreibgeschützt ist. Andernfalls wird FALSE zurückgegeben.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Gibt TRUE zurück, wenn das untergeordnete MDI-Element erfolgreich mit Windows 7-Taskleistenregistern registriert wurde.
CMDIChildWndEx::IsTabbedPane	Gibt TRUE zurück, wenn das untergeordnete MDI-Fenster einen Andockbereich enthält. Andernfalls wird FALSE zurückgegeben.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Gibt an, ob das untergeordnete MDI-Element auf Windows 7-Taskleistenregisterkarten angezeigt werden kann.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Gibt an, ob die automatische Auswahl eines Teils des Clientbereichs eines Fensters angezeigt werden soll, wenn die Miniaturansicht dieses Fensters in der Taskleiste aktiviert oder deaktiviert ist.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Eine Kombination von Flags, die vom Framework an die SetTaskbarTabProperties-Methode übergeben wird, wenn eine Registerkarte (untergeordnete MDI) mit Windows 7-Taskleistenregisterkarten registriert wird. Die Standardkombination lautet `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Wird vom Framework aufgerufen, wenn eine Bitmap für die Livevorschau untergeordneter MDI-Elemente abgerufen werden muss.
CMDIChildWndEx::OnGetIconicThumbnail	Wird vom Framework aufgerufen, wenn eine Bitmap für die iconic-Miniaturansicht untergeordneter MDI-Elemente abgerufen werden muss.
CMDIChildWndEx::OnMoveMiniFrame	Vom Framework aufgerufen, um ein Miniframefenster zu verschieben.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Wird vom Framework aufgerufen, wenn der Benutzer die Schaltfläche "Schließen" auf der Miniaturansicht der Taskleiste drückt.
CMDIChildWndEx::OnSetPreviewMode	Vom Framework aufgerufen, um in den Druckvorschaumodus zu wechseln oder zu beenden.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Wird vom Framework aufgerufen, wenn die Miniaturansicht der Taskleisten-Registerkarte WM_ACTIVATE Nachricht verarbeiten soll.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Wird vom Framework aufgerufen, wenn die Miniaturansicht der Taskleisten-Registerkarte WM_MOUSEACTIVATE Nachricht verarbeiten soll.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Wird vom Framework aufgerufen, wenn eine Bitmap für die Windows 7-Taskleistenminiaturansicht untergeordneter MDI-Elemente gestreckt werden muss.
CMDIChildWndEx::OnUpdateFrameTitle	Vom Framework aufgerufen, um den Frametitel zu aktualisieren. (Überschreibt `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx::P aneFromPoint	Gibt den Bereich zurück, der den angegebenen Punkt enthält.
`CMDIChildWndEx::PreTranslateMessage`	Wird von der CWinApp -Klasse verwendet, um Fenstermeldungen zu übersetzen, bevor diese an die Windows-Funktionen TranslateMessage und DispatchMessage gesendet werden. (Überschreibt CWnd::PreTranslateMessage.)
CMDIChildWndEx::RecalcLayout	Berechnet das Layout des Fensters neu.
CMDIChildWndEx::RegisterTaskbarTab	Registriert untergeordnete MDI mit Windows 7-Taskleistenregisterkarten.
CMDIChildWndEx::RemovePaneFromDockManager	Entfernt einen Bereich aus dem Docking-Manager.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Aktiviert die entsprechende Windows 7-Taskleistenregisterkarte.
CMDIChildWndEx::SetTaskbarTabOrder	Fügt untergeordnete mDI vor dem angegebenen Fenster auf Windows 7-Taskleistenregistern ein.
CMDIChildWndEx::SetTaskbarTabProperties	Legt Eigenschaften für eine Registerkarte der Windows 7-Taskleiste fest.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Wird intern vom Framework aufgerufen, um das Beschneidungsrechteck festzulegen, um einen Teil des Clientbereichs eines Fensters auszuwählen, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Entfernt untergeordnete MDI aus Windows 7-Taskleistenregisterkarten.
CMDIChildWndEx::UpdateTaskbarTabIcon	Aktualisiert das Registerkartensymbol der Windows 7-Taskleiste.

Hinweise

Um erweiterte Docking-Features in MDI-Anwendungen nutzen zu können, leiten Sie die untergeordnete MDI-Fensterklasse Ihrer Anwendung von cmDIChildWnd ab CMDIChildWndEx .

Beispiel

Das folgende Beispiel leitet eine Klasse von CMDIChildWndEx. Dieser Codeausschnitt stammt aus dem VisualStudioDemo-Beispiel: MFC Visual Studio-Anwendung.

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()
};

Vererbungshierarchie

Anforderungen

Header: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Fügt einen Bereich hinzu.

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

Parameter

pControlBar
[in] Ein Zeiger auf den Bereich.

bTail
[in] TRUE, um den Bereich am Ende der Liste der Bereiche für den Docking-Manager hinzuzufügen; andernfalls FALSE.

Rückgabewert

TRUE, wenn der Bereich erfolgreich beim Docking-Manager registriert wurde; andernfalls FALSE.

CMDIChildWndEx::AddTabbedPane

Fügt einen Registerkartenbereich hinzu.

void AddTabbedPane(CDockablePane* pControlBar);

Parameter

pControlBar
[in] Ein Zeiger auf den Bereich.

CMDIChildWndEx::AdjustDockingLayout

Passt das Andocklayout an.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameter

hdwp
[in] Handle to a deferred window position structure.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Rückgabewert

Bemerkungen

CMDIChildWndEx::CanShowOnWindowsList

Gibt an, ob der name des untergeordneten MDI-Fensters im Dialogfeld CMFCWindowsManagerDialog Class angezeigt werden kann.

virtual BOOL CanShowOnWindowsList();

Rückgabewert

TRUE, wenn das Fenster im Windows-Dialogfeld angezeigt werden kann; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und geben Sie FALSE zurück, wenn das Fenster nicht im Windows-Dialogfeld angezeigt werden soll. Diese Funktion wird von CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Dockt einen Bereich an.

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

Parameter

pBar
[in] Ein Zeiger auf den Bereich.

nDockBarID
[in] Die ID des Bereichs.

lpRect
[in] Ein Zeiger auf ein Rechteck.

Hinweise

Der lpRect-Parameter wird nicht verwendet.

CMDIChildWndEx::D ockPaneLeftOf

Dockt einen Bereich auf der linken Seite eines anderen Bereichs an.

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

Parameter

pBar
Ein Zeiger auf den Bereich, der angedockt werden soll.

pLeftOf
Ein Zeiger auf den Bereich, der als Bezugspunkt dient.

Rückgabewert

WAHR bei Erfolg, FALSE bei Fehler.

Hinweise

Diese Methode verwendet den durch pBar angegebenen Bereich und dockt ihn an der linken Seite des durch pLeftOf angegebenen Bereichs an.

Rufen Sie diese Methode auf, wenn Sie mehrere Bereiche in vordefinierter Reihenfolge andocken möchten.

CMDIChildWndEx::EnableAutoHidePanes

Aktiviert den Modus "Automatisches Ausblenden" für Bereiche, wenn sie an den angegebenen Seiten des Fensters angedockt werden.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameter

dwDockStyle
[in] Gibt die Seiten des Hauptrahmenfensters an, das aktiviert ist. Verwenden Sie eine oder mehrere der folgenden Flags.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Rückgabewert

TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

CMDIChildWndEx::EnableDocking

Aktiviert das Andocken des untergeordneten Fensters an den Hauptrahmen.

BOOL EnableDocking(DWORD dwDockStyle);

Parameter

dwDockStyle
[in] Gibt die zu aktivierende Andockausrichtung an.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um die Andockausrichtung an den Hauptframe zu aktivieren. Sie können eine Kombination aus CBRS_ALIGN_ Flags übergeben (weitere Informationen finden Sie unter CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Rückgabewert

Bemerkungen

CMDIChildWndEx::GetDocumentName

Gibt den Namen des Dokuments zurück, das im untergeordneten MDI-Fenster angezeigt wird.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Rückgabewert

Ein Zeiger auf eine Zeichenfolge, die den Namen eines Dokuments enthält.

Hinweise

Ein Dokument zeigt das untergeordnete MDI-Fenster an. Im Allgemeinen zeigt das Fenster Daten an, die aus einer Datei geladen oder in einer Datei gespeichert werden. Daher ist der Name des Dokuments der Name der Datei. Die Standardimplementierung der GetDocumentName Rückgabe einer Zeichenfolge, die von CDocument::GetPathName.

Wenn im Fenster ein Dokument angezeigt wird, das nicht aus einer Datei geladen wird, überschreiben Sie diese Methode in einer abgeleiteten Klasse, und geben Sie einen eindeutigen Dokumentbezeichner zurück.

GetDocumentName wird vom Framework aufgerufen, wenn der Status aller geöffneten Dokumente gespeichert wird. Die zurückgegebene Zeichenfolge wird in die Registrierung geschrieben.

Wenn das Framework den Zustand später wiederherstellen wird, wird der Dokumentname aus der Registrierung gelesen und an CMDIFrameWndEx::CreateDocumentWindow übergeben. Überschreiben Sie diese Methode in einer CMDIFrameWndEx-abgeleiteten Klasse, und erstellen oder öffnen Sie ein Dokument mit diesem Namen und lesen Sie in der Datei mit diesem Namen. Wenn das Dokument nicht auf einer Datei basiert, erstellen Sie das Dokument basierend auf dem Dokumentbezeichner selbst. Die vorstehenden Aktionen sollten nur ausgeführt werden, wenn Sie Dokumente speichern und wiederherstellen möchten.

Beispiel

Im folgenden Beispiel wird die Verwendung der GetDocumentName-Methode gezeigt. Dieser Codeausschnitt stammt aus dem VisualStudioDemo-Beispiel: MFC Visual Studio-Anwendung.

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

CMDIChildWndEx::GetFrameIcon

Vom Framework aufgerufen, um das Symbol des untergeordneten MDI-Fensters abzurufen.

virtual HICON GetFrameIcon() const;

Rückgabewert

Ein Handle zum Fenstersymbol.

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, welches Symbol auf der Registerkarte MDI angezeigt werden soll, das das untergeordnete MDI-Rahmenfenster enthält.

Standardmäßig gibt diese Methode das Fenstersymbol zurück. Überschreiben GetFrameIcon Sie diese Eigenschaft in einer CMDIChildWndExabgeleiteten Klasse, um dieses Verhalten anzupassen.

CMDIChildWndEx::GetFrameText

Vom Framework aufgerufen, um den Text für das untergeordnete MDI-Fenster abzurufen.

virtual CString GetFrameText() const;

Rückgabewert

Eine Zeichenfolge, die den Rahmenfenstertext enthält.

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, welcher Text auf der MDI-Registerkarte mit dem untergeordneten MDI-Rahmenfenster angezeigt werden soll.

Standardmäßig gibt diese Methode den Fenstertext zurück. Überschreiben GetFrameText Sie diese Eigenschaft in einer CMDIChildWndExabgeleiteten Klasse, um dieses Verhalten anzupassen.

CMDIChildWndEx::GetPane

Sucht einen Bereich nach der angegebenen Steuerelement-ID.

CBasePane* GetPane(UINT nID);

Parameter

Nid
[in] Die Steuerelement-ID des zu suchenden Bereichs.

Rückgabewert

Ein Zeiger auf den Bereich, falls gefunden, andernfalls NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Rückgabewert

Bemerkungen

CMDIChildWndEx::GetTabbedPane

Gibt einen Zeiger auf einen Andockbereich zurück, der Teil einer Gruppe von MDI-Dokumenten mit Registerkarten ist.

CDockablePane* GetTabbedPane() const;

Rückgabewert

Ein Zeiger auf einen Andockbereich, der Teil einer Gruppe von MDI-Dokumenten mit Registerkarten ist.

CMDIChildWndEx::GetToolbarButtonToolTipText

Vom Framework aufgerufen, um eine QuickInfo für eine Symbolleistenschaltfläche abzurufen.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Rückgabewert

TRUE, wenn die QuickInfo angezeigt wurde. Die Standardimplementierung gibt FALSE zurück.

Hinweise

Überschreiben Sie diese Methode, wenn Sie benutzerdefinierte QuickInfos für Symbolleistenschaltflächen anzeigen möchten.

CMDIChildWndEx::InsertPane

Registriert den angegebenen Bereich mit dem Docking-Manager.

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

Parameter

pControlBar
[in] Ein Zeiger auf den einzufügenden Bereich.

pTarget
[in] Ein Zeiger auf den angrenzenden Bereich.

bAfter
[in] Wenn TRUE, wird pControlBar nach pTarget eingefügt. Wenn FALSE, wird pControlBar vor pTarget eingefügt.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist, andernfalls FALSE.

CMDIChildWndEx::IsPointNearDockSite

Bestimmt, ob sich ein angegebener Punkt in der Nähe des Dockstandorts befindet.

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

Parameter

Punkt
[in] Der angegebene Punkt.

dwBarAlignment
[in] Gibt an, welcher Rand sich der Punkt in der Nähe befindet. Mögliche Werte sind CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP und CBRS_ALIGN_BOTTOM

bOuterEdge
[in] TRUE, wenn sich der Punkt in der Nähe des äußeren Rands des Dockstandorts befindet; Andernfalls FALSE.

Rückgabewert

TRUE, wenn sich der Punkt in der Nähe des Dockstandorts befindet; andernfalls FALSE.

Hinweise

Der Punkt befindet sich in der Nähe des Dockstandorts, wenn er sich in der Vertraulichkeit befindet, die im Docking-Manager festgelegt ist. Die Standardempfindlichkeit beträgt 15 Pixel.

CMDIChildWndEx::IsReadOnly

Gibt an, ob das Dokument, das im untergeordneten Fenster angezeigt wird, schreibgeschützt ist.

virtual BOOL IsReadOnly();

Rückgabewert

TRUE, wenn das Dokument schreibgeschützt ist; andernfalls FALSE.

Hinweise

Diese Funktion wird verwendet, um das Speichern schreibgeschützter Dokumente zu verhindern.

Beispiel

Das folgende Beispiel veranschaulicht das Überschreiben der IsReadOnly Methode. Dieser Codeausschnitt stammt aus dem VisualStudioDemo-Beispiel: MFC Visual Studio-Anwendung.

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

CMDIChildWndEx::IsTabbedPane

Gibt an, ob das untergeordnete MDI-Fenster einen Andockbereich enthält.

BOOL IsTabbedPane() const;

Rückgabewert

TRUE, wenn das untergeordnete MDI-Fenster einen Andockbereich enthält, der in ein Dokument mit Registerkartenformat konvertiert wurde; andernfalls FALSE.

CMDIChildWndEx::OnMoveMiniFrame

Vom Framework aufgerufen, um ein Miniframefenster zu verschieben.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameter

pFrame
[in] Ein Zeiger auf ein Miniframefenster.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist, andernfalls FALSE.

CMDIChildWndEx::OnSetPreviewMode

Vom Framework aufgerufen, um in den Druckvorschaumodus zu wechseln oder zu beenden.

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

Parameter

bPreview
[in] Wenn WAHR, geben Sie den Druckvorschaumodus ein. Wenn FALSE, beenden Sie den Druckvorschaumodus.

pState
[in] Ein Zeiger auf die Struktur des Druckvorschauzustands.

CMDIChildWndEx::OnUpdateFrameTitle

Vom Framework aufgerufen, um den Frametitel zu aktualisieren.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameter

bAddToTitle
[in] Wenn WAHR, fügen Sie den Dokumentnamen zum Titel hinzu.

CMDIChildWndEx::P aneFromPoint

Gibt den Bereich zurück, der den angegebenen Punkt enthält.

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

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

Parameter

Punkt
[in] Gibt den zu überprüfenden Punkt in Bildschirmkoordinaten an.

nSensitivität
[in] Erhöhen Sie den Suchbereich um diesen Betrag. Ein Bereich erfüllt die Suchkriterien, wenn der angegebene Punkt in den erweiterten Bereich fällt.

bExactBar
[in] TRUE, um den nSensitivity-Parameter zu ignorieren; andernfalls FALSE.

pRTCBarType
[in] Wenn nicht NULL, durchsucht die Methode nur Bereiche des angegebenen Typs.

dwAlignment
[in] Wenn an dem angegebenen Punkt ein Bereich gefunden wird, enthält dieser Parameter die Seite des Bereichs, der dem angegebenen Punkt am nächsten liegt. Weitere Informationen finden Sie im Abschnitt Hinweise.

Rückgabewert

Ein Zeiger auf das CBasePane-abgeleitete Objekt, das den angegebenen Punkt enthält, oder NULL, wenn kein Bereich gefunden wurde.

Hinweise

Rufen Sie diese Methode auf, um zu bestimmen, ob ein Bereich den angegebenen Punkt gemäß den angegebenen Bedingungen enthält, z. B. Laufzeitklasse und Sichtbarkeit.

Wenn die Funktion zurückgegeben und ein Bereich gefunden wurde, enthält dwAlignment die Ausrichtung des angegebenen Punkts. Wenn der Punkt beispielsweise am oberen Rand des Bereichs am nächsten ist, wird dwAlignment auf CBRS_ALIGN_TOP festgelegt.

CMDIChildWndEx::RecalcLayout

Berechnet das Layout des Fensters neu.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[in] Wenn TRUE, erhält das aktive direkte Element für das Fenster Benachrichtigungen über die Layoutänderung.

CMDIChildWndEx::RemovePaneFromDockManager

Entfernt einen Bereich aus dem Docking-Manager.

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

Parameter

pControlBar
[in] Ein Zeiger auf den zu entfernenden Bereich.

bDestroy
[in] Wenn TRUE, wird der entfernte Bereich zerstört.

bAdjustLayout
[in] Wenn TRUE, passen Sie das Andocklayout sofort an.

bAutoHide
[in] Wenn TRUE, ist das Andocklayout mit der Liste der Autohidebalken verknüpft. Wenn FALSE, ist das Andocklayout mit der Liste der regulären Bereiche verknüpft.

pBarReplacement
[in] Ein Zeiger auf einen Bereich, der den entfernten Bereich ersetzt.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parameter

[in] p

Hinweise

CMDIChildWndEx::ShowPane

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

Parameter

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Hinweise

CMDIChildWndEx::UpdateTaskbarTabIcon

Aktualisiert das Registerkartensymbol der Windows 7-Taskleiste.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parameter

hIcon
Ein Handle zu einem Symbol, das auf der Windows 7-Taskleistenregisterkarte angezeigt werden soll.

Hinweise

CMDIChildWndEx::UnregisterTaskbarTab

Entfernt das untergeordnete MDI-Element aus den Registerkarten der Windows 7-Taskleiste.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parameter

bCheckRegisteredMDIChildCount
Gibt an, ob diese Funktion die Anzahl der MDI-untergeordneten Elemente überprüfen muss, die mit MDI-Registerkarten registriert sind. Wenn diese Zahl 0 ist, entfernt diese Funktion das Beschneidungsrechteck aus der Miniaturansicht der Taskleiste der Anwendung.

Hinweise

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Wird vom Framework aufgerufen, um das Beschneidungsrechteck festzulegen, um einen Teil des Clientbereichs eines Fensters auszuwählen, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parameter

rect
Gibt das neue Beschneidungsrechteck an. Wenn das Rechteck leer oder NULL ist, wird der Clipping entfernt.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

CMDIChildWndEx::SetTaskbarTabProperties

Legt Eigenschaften für eine Registerkarte der Windows 7-Taskleiste fest.

void SetTaskbarTabProperties(DWORD dwFlags);

Parameter

dwFlags
Eine Kombination von STPFLAG-Werten. Weitere Informationen finden Sie unter "ITaskbarList4::SetTabProperties".

Hinweise

CMDIChildWndEx::SetTaskbarTabOrder

Fügt das untergeordnete MDI-Element vor dem angegebenen Fenster auf Windows 7-Taskleistenregisterkarten ein.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parameter

pWndBefore
Ein Zeiger auf das untergeordnete MDI-Fenster, dessen Miniaturansicht links eingefügt wird. Dieses Fenster muss bereits über RegisterTaskbarTab. Wenn dieser Wert NULL ist, wird die neue Miniaturansicht am Ende der Liste hinzugefügt.

Hinweise

CMDIChildWndEx::SetTaskbarTabActive

Aktiviert die entsprechende Windows 7-Taskleistenregisterkarte.

void SetTaskbarTabActive();

Hinweise

CMDIChildWndEx::RegisterTaskbarTab

Registriert das untergeordnete MDI-Element mit Windows 7-Taskleistenregisterkarten.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parameter

Hinweise

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Wird vom Framework aufgerufen, wenn eine Bitmap für eine Windows 7-Taskleistenminiaturansicht des untergeordneten MDI-Elements gestreckt werden muss.

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

Parameter

hBmpDst
Ein Handle zu einer Zielbitmap.

rectDst
Gibt das Zielrechteck an.

hBmpSrc
Ein Handle zu einer Quellbitmap.

rectSrc
Gibt das Quellrechteck an.

Hinweise

Anforderung: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Wird vom Framework aufgerufen, wenn die Miniaturansicht der Taskleiste die WM_MOUSEACTIVATE Nachricht verarbeiten soll.

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

Parameter

pDesktopWnd
Gibt einen Zeiger auf das übergeordnete Fenster der obersten Ebene des zu aktivierenden Fensters an. Der Zeiger kann temporär sein und sollte nicht gespeichert werden.

nHitTest
Gibt die Treffertestbereichsfunktion an. Ein Treffertest ist ein Test, der die Position des Cursors bestimmt.

message
Gibt die Mausnachrichtennummer an.

Hinweise

Die Standardimplementierung aktiviert den zugehörigen untergeordneten MDI-Frame.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Wird vom Framework aufgerufen, wenn die Miniaturansicht der Taskleiste die WM_ACTIVATE Nachricht verarbeiten soll.

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

Parameter

nState
Gibt an, ob die CWnd Aktivierung oder Deaktivierung erfolgt.

pWndOther
Zeiger auf das CWnd aktivierte oder deaktivierte Element. Der Zeiger kann NULL sein und kann temporär sein.

bMinimized
Gibt den minimierten Zustand der CWnd Aktivierung oder Deaktivierung an. Ein Wert von TRUE gibt an, dass das Fenster minimiert ist.

Hinweise

Die Standardimplementierung aktiviert den zugehörigen untergeordneten MDI-Frame.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Wird vom Framework aufgerufen, wenn der Benutzer die Schaltfläche "Schließen" auf der Miniaturansicht der Taskleiste drückt.

virtual void OnPressTaskbarThmbnailCloseButton();

Hinweise

CMDIChildWndEx::OnGetIconicThumbnail

Wird vom Framework aufgerufen, wenn eine Bitmap für die iconic-Miniaturansicht des untergeordneten MDI-Elements abgerufen werden muss.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parameter

nWidth
Gibt die Breite der erforderlichen Bitmap an.

nHeight
Gibt die Höhe der erforderlichen Bitmap an.

Hinweise

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Wird vom Framework aufgerufen, wenn eine Bitmap für die Livevorschau des untergeordneten MDI-Elements abgerufen werden muss.

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

Parameter

bIsMDIChildActive
Dieser Parameter ist TRUE, wenn die Bitmap für das untergeordnete MDI-Element angefordert wird, das derzeit aktiv ist und das Hauptfenster nicht minimiert wird. Die Standardverarbeitung in diesem Fall erstellt eine Momentaufnahme des Hauptfensters.

ptLocation
Gibt die Position der Bitmap in den Clientkoordinaten des Hauptfensters (oberster Ebene) an. Dieser Punkt sollte vom Angerufenen bereitgestellt werden.

Rückgabewert

Wenn die Verarbeitung erfolgt, wird ein Handle an eine gültige 32bpp-Bitmap zurückgegeben, andernfalls NULL.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und geben Sie eine gültige 32-Bit-Bitmap für die Livevorschau untergeordneter MDI-Elemente zurück. Diese Methode wird nur aufgerufen, wenn das untergeordnete MDI-Element auf Windows 7-Taskleistenregisterkarten angezeigt wird. Wenn Sie NULL zurückgeben, ruft MFC die Standardhandler auf und ruft Bitmaps mit PrintClient oder PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Eine Kombination von Flags, die vom Framework an die SetTaskbarTabProperties Methode übergeben wird, wenn eine Registerkarte (untergeordnete MDI) mit Windows 7-Taskleistenregistern registriert wird.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Hinweise

Die Standardkombination lautet STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Gibt an, ob die automatische Auswahl eines Teils des Clientbereichs eines Fensters angezeigt werden soll, wenn die Miniaturansicht dieses Fensters in der Taskleiste aktiviert oder deaktiviert ist.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Rückgabewert

Gibt TRUE zurück, wenn die automatische Auswahl eines Teils des anzuzeigenden Clientbereichs eines Fensters aktiviert ist; andernfalls FALSE.

Hinweise

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Gibt an, ob das untergeordnete MDI-Element auf Windows 7-Taskleistenregisterkarten angezeigt werden kann.

BOOL IsTaskbarTabsSupportEnabled();

Rückgabewert

TRUE, wenn das untergeordnete MDI-Element auf Windows 7-Taskleistenregistern angezeigt werden kann; FALSE, wenn das untergeordnete MDI-Element nicht auf Windows 7-Taskleistenregistern angezeigt werden kann.

Hinweise

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Gibt TRUE zurück, wenn das untergeordnete MDI-Element erfolgreich mit Windows 7-Taskleistenregisterkarten registriert wurde.

BOOL IsRegisteredWithTaskbarTabs();

Rückgabewert

TRUE, wenn das untergeordnete MDI-Element mit Windows 7-Taskleistenregistern registriert ist; andernfalls FALSE.

Hinweise

CMDIChildWndEx::InvalidateIconicBitmaps

Ungültige Bitmapdarstellung eines untergeordneten MDI-Elements.

BOOL InvalidateIconicBitmaps();

Rückgabewert

Gibt FALSE zurück, wenn die Windows 7-Taskleistenunterstützung deaktiviert ist oder das untergeordnete MDI-Element bei Windows 7-Taskleistenregisterkarten nicht registriert ist; andernfalls wird TRUE zurückgegeben.

Hinweise

Sollte aufgerufen werden, wenn sich der Liveinhalt oder die Größe eines untergeordneten MDI-Elements geändert hat.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Wird vom Framework aufgerufen, wenn ein Teil des Clientbereichs eines Fensters ausgewählt werden muss, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.

virtual CRect GetTaskbarThumbnailClipRect() const;

Rückgabewert

Ein Rechteck in Fensterkoordinaten. Dieses Rechteck wird dem Clientbereich des Frame der obersten Ebene zugeordnet. Das Rechteck sollte leer sein, um das Beschneidungsrechteck zu löschen.

Hinweise

CMDIChildWndEx::GetTaskbarPreviewWnd

Wird vom Framework aufgerufen, wenn es ein untergeordnetes Fenster (in der Regel ein Ansichts- oder Teilerfenster) abrufen muss, das auf einer Miniaturansicht der Windows 7-Taskleiste angezeigt werden soll.

virtual CWnd* GetTaskbarPreviewWnd();

Rückgabewert

Gibt einen gültigen Zeiger auf ein CWnd Objekt zurück, dessen Vorschau auf einer Windows 7-Taskleistenregisterkarte im Zusammenhang mit diesem untergeordneten MDI-Element angezeigt werden soll. Die Standardimplementierung gibt ein untergeordnetes Fenster dieses untergeordneten MDI-Elements mit AFX_IDW_PANE_FIRST Steuerelement-ID zurück (normalerweise eine CViewabgeleitete Klasse).

Hinweise

CMDIChildWndEx::GetTabProxyWnd

Gibt das Registerkartenproxyfenster zurück, das mit Windows 7-Taskleistenregistern registriert ist.

CMDITabProxyWnd* GetTabProxyWnd();

Rückgabewert

Ein Zeiger auf ein CMDITabProxyWnd Objekt, das mit Windows 7-Taskleistenregistern registriert ist.

Hinweise

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Aktiviert oder deaktiviert die automatische Auswahl eines Teils des Clientbereichs eines Fensters, der als Miniaturansicht dieses Fensters in der Taskleiste angezeigt werden soll.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parameter

bEnable
Gibt an, ob die automatische Auswahl eines Teils des anzuzeigenden Clientbereichs eines Fensters (TRUE) oder deaktivieren (FALSE) aktiviert werden soll.

Hinweise

CMDIChildWndEx::CanShowOnTaskBarTabs

Teilt dem Framework mit, ob dieses untergeordnete MDI-Element auf Windows 7-Taskleistenregistern angezeigt werden kann.

virtual BOOL CanShowOnTaskBarTabs();

Rückgabewert

TRUE, wenn der Inhalt des untergeordneten MDI-Elements auf Windows 7-Taskleistenminiaturansichten angezeigt werden kann.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und geben Sie FALSE zurück, um die Darstellung dieses untergeordneten MDI-Elements auf Windows 7-Taskleistenregisterkarten zu deaktivieren.

CMDIChildWndEx::ActivateTopLevelFrame

Wird vom Framework aufgerufen, um den Frame der obersten Ebene zu aktivieren, wenn die Anwendung über eine Taskleistenregisterkarte aktiviert wird.

virtual void ActivateTopLevelFrame();

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CMDIChildWnd-Klasse
CMFCWindowsManagerDialog-Klasse
CMDIFrameWndEx-Klasse

Freigeben über

CMDIChildWndEx-Klasse

Syntax

Member

Öffentliche Methoden

Hinweise

Beispiel

Vererbungshierarchie

Anforderungen

CMDIChildWndEx::AddPane

Parameter

Rückgabewert

CMDIChildWndEx::AddTabbedPane

Parameter

CMDIChildWndEx::AdjustDockingLayout

Parameter

CMDIChildWndEx::CanShowOnMDITabs

Rückgabewert

Bemerkungen

CMDIChildWndEx::CanShowOnWindowsList

Rückgabewert

Hinweise

CMDIChildWndEx::D ockPane

Parameter

Hinweise

CMDIChildWndEx::D ockPaneLeftOf

Parameter

Rückgabewert

Hinweise

CMDIChildWndEx::EnableAutoHidePanes

Parameter

Rückgabewert

CMDIChildWndEx::EnableDocking

Parameter

Rückgabewert

Hinweise

CMDIChildWndEx::GetDockingManager

Rückgabewert

Bemerkungen

CMDIChildWndEx::GetDocumentName

Rückgabewert

Hinweise

Beispiel

CMDIChildWndEx::GetFrameIcon

Rückgabewert

Hinweise

CMDIChildWndEx::GetFrameText

Rückgabewert

Hinweise

CMDIChildWndEx::GetPane

Parameter

Rückgabewert

CMDIChildWndEx::GetRelatedTabGroup

Rückgabewert

Bemerkungen

CMDIChildWndEx::GetTabbedPane

Rückgabewert

CMDIChildWndEx::GetToolbarButtonToolTipText

Rückgabewert

Hinweise

CMDIChildWndEx::InsertPane

Parameter

Rückgabewert

CMDIChildWndEx::IsPointNearDockSite

Parameter

Rückgabewert

Hinweise

CMDIChildWndEx::IsReadOnly

Rückgabewert

Hinweise

Beispiel

CMDIChildWndEx::IsTabbedPane

Rückgabewert

CMDIChildWndEx::OnMoveMiniFrame

Parameter

Rückgabewert

CMDIChildWndEx::OnSetPreviewMode

Parameter

CMDIChildWndEx::OnUpdateFrameTitle

Parameter