CMDIChildWndEx::GetDocumentName
Zwraca nazwę dokumentu, który jest wyświetlany w oknie podrzędnych MDI.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Wartość zwracana
Wskaźnik ciąg zawierający nazwę dokumentu.
Uwagi
Wyświetla okno podrzędnych MDI jest dokument.Ogólnie zostanie wyświetlone okno jest ładowany z lub zapisane w pliku danych.Dlatego nazwa dokumentu jest nazwa pliku.Domyślna implementacja z GetDocumentName zwraca ciąg uzyskanych z CDocument::GetPathName.
Jeśli zostanie wyświetlone okno dokumentu, który nie jest ładowany z pliku, zastąpienie tej metody w klasie pochodnej i zwraca identyfikator unikatowy dokumentu.
GetDocumentNamejest wywoływana przez ramy, gdy zapisuje stan wszystkich otwartych dokumentów.Zwrócony ciąg jest zapisywane w rejestrze.
Gdy ramach przywraca stan później, nazwa dokumentu jest odczytać z rejestru i przekazany do CMDIFrameWndEx::CreateDocumentWindow.Zastąpienie tej metody w CMDIFrameWndEx-klasy i Utwórz lub Otwórz dokument, który ma nazwę tej i odczytywać plik o tej nazwie.Jeśli dokument nie jest oparty na pliku, Utwórz dokument na podstawie samego identyfikatora dokumentu.Poprzedni akcje należy wykonać tylko, jeśli zamierzasz zapisać i przywracanie dokumentów.
Przykład
Poniższy przykład ilustruje użycie GetDocumentName metody.To urywek kodu pochodzi z VisualStudioDemo próbki: Aplikacja Visual Studio MFC.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Wymagania
Nagłówek: afxMDIChildWndEx.h