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 ist, was das untergeordnete MDI-Fenster anzeigt. Im Allgemeinen wird das Fenster Daten an, die von geladen wird oder in einer Datei gespeichert. Daher ist der Name des Dokuments der Name der Datei. Die Standardimplementierung von GetDocumentName gibt eine Zeichenfolge von abgerufenen CDocument::GetPathName zurück.
Wenn das Fenster ein Dokument anzeigt, das nicht aus einer Datei geladen wird, überschreiben Sie diese Methode in einer abgeleiteten Klasse und geben Sie einen eindeutigen Dokumentenbezeichner zurück.
GetDocumentName wird vom Framework aufgerufen, wenn es den Zustand aller geöffneten Dokumente speichert. Die zurückgegebene Zeichenfolge ist in die Registrierung eingetragen.
Wenn das Framework Wiederherstellungsstatus höher ist, wird der Dokumentname aus der Registrierung gelesen und an übergeben CMDIFrameWndEx::CreateDocumentWindow. Überschreiben Sie diese Methode in CMDIFrameWndEx von abgeleitete Klasse und erstellen oder öffnen Sie ein Dokument, das diesen Namen aufweist und lesen Sie die Datei, die diesen Namen. Wenn das Dokument nicht auf Grundlage einer Datei ist, erstellen Sie das Dokument auf dem Dokumentenbezeichner selbst. Sie sollten die vorangehenden Aktionen ausführen, wenn Sie beabsichtigen, Dokumente zu speichern und wiederherzustellen.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der GetDocumentName-Methode. Dieser Codeausschnitt stammt VisualStudioDemo-Beispiel: MFC-Visual Studio-Anwendung.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Anforderungen
Header: afxMDIChildWndEx.h