CMDIChildWndEx-Klasse
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.
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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 Standard Frame. |
| 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 Standard Rahmenfensters 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 Standard Frame.
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 Standard Frame 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
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::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.
Nachricht
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 fenster Standard nicht minimiert wird. Bei der Standardverarbeitung in diesem Fall wird ein Momentaufnahme des Standard Fensters verwendet.
ptLocation
Gibt die Position der Bitmap in den Clientkoordinaten des Standard (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
Siehe auch
Hierarchiediagramm
Klassen
CMDIChildWnd-Klasse
CMFCWindowsManagerDialog-Klasse
CMDIFrameWndEx-Klasse
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für