Поделиться через


CMDIChildWndEx::GetDocumentName

Возвращает имя документа, отображаемое в дочернем окне интерфейса MDI.

virtual LPCTSTR GetDocumentName(
   CObject** pObj 
);

Возвращаемое значение

Указатель на строку, содержащую имя документа.

Заметки

Документ, что дочернее окно MDI. Как правило, окно отображает данные которых загружает из сохранение в файл. Поэтому имя документа совпадает с именем файла. Реализация по умолчанию GetDocumentName возвращает полученную строку из CDocument::GetPathName.

Если окно отображает документ не загружен из файла, переопределите этот метод в производном классе, возвращает уникальный идентификатор документа.

GetDocumentName вызываются платформой, когда они сохраняются состояние всех открытых документов. Возвращаемая строка записана в реестр.

Когда границы получают состояние более поздних версиях имя документа считывается из реестра и передается CMDIFrameWndEx::CreateDocumentWindow. Переопределите этот метод в CMDIFrameWndEx- производный класс и создать или открыть документ, имеющий это имя и чтение в файл, имеющий это имя. Если документ не основан на файле, создайте документ, основанный на идентификаторе самого документа. Необходимо выполнить предыдущие действия, только если требуется сохранить и получать документы.

Пример

В следующем примере демонстрируется использование метода GetDocumentName. Этот фрагмент кода извлекается из Образец VisualStudioDemo: приложение Visual Studio MFC.

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

Требования

заголовок: afxMDIChildWndEx.h

См. также

Ссылки

Класс CMDIChildWndEx

Диаграмма иерархии