Класс CDocument

Статья
06/10/2015

Предоставляет базовую функциональность для определяемых пользователем классов документа.

class CDocument : public CCmdTarget

Члены

Открытые конструкторы

Имя	Описание
CDocument::CDocument	Создает объект CDocument.

Открытые методы

Имя	Описание
CDocument::AddView	Вложение представление в документ.
CDocument::BeginReadChunks	Инициализирует чтение блока.
CDocument::CanCloseFrame	Расширенный переопределяемый метод; прежде чем закрыть фреймовое окно, вызываемый при просмотре в этом документе.
CDocument::ClearChunkList	Очищает список блокировок.
CDocument::ClearPathName	Удаляет путь объекта документа.
CDocument::DeleteContents	Вызываемый для выполнения очистки документа.
CDocument::FindChunk	Ищет блок с указанным идентификатором GUID.
CDocument::GetAdapter	Возвращает указатель для возразить реализация интерфейса IDocument.
CDocument::GetDocTemplate	Возвращает указатель на шаблон документа, описывающий тип документа.
CDocument::GetFile	Возвращает указатель к необходимому объекту CFile.
CDocument::GetFirstViewPosition	Возвращает позицию первого списка представлений; используемый, чтобы начать итерацию.
CDocument::GetNextView	Просматривает список представлений, связанных с документом.
CDocument::GetPathName	Возвращает путь к файлу данных документа.
CDocument::GetThumbnail	Вызываемый для создания растровое изображение, которое должно использоваться поставщиком эскизов для отображения эскизов.
CDocument::GetTitle	Возвращает заголовок документа.
CDocument::InitializeSearchContent	Вызываемый для инициализации содержимое поиска для обработчика поиска.
CDocument::IsModified	Указывает, был ли изменен документ с момента последнего сохранения.
CDocument::IsSearchAndOrganizeHandler	Указывает, был ли создать этот экземпляр объекта CDocument для поиска и упорядочивает обработчик.
CDocument::LoadDocumentFromStream	Вызываемый для загрузки данные документа из потока.
CDocument::OnBeforeRichPreviewFontChanged	Вызываемый до широкий шрифт предварительного просмотра изменения.
CDocument::OnChangedViewList	Вызываемый после того, как представление добавлено или удалено из документа.
CDocument::OnCloseDocument	Вызванный, чтобы закрыть документ.
CDocument::OnCreatePreviewFrame	Вызываемый платформой, когда необходимо создать кадр предварительного просмотра для богатого предварительного просмотра.
CDocument::OnDocumentEvent	Вызываемый платформой в ответ на событие документа.
CDocument::OnDrawThumbnail	Переопределите этот метод в производном классе для рисования содержимое эскиза.
CDocument::OnLoadDocumentFromStream	Вызываемый платформой, когда необходимо загрузить данные документа из потока.
CDocument::OnNewDocument	Вызываемый для создания нового документа.
CDocument::OnOpenDocument	Вызываемый для открытия существующего документа.
CDocument::OnPreviewHandlerQueryFocus	Заставляет обработчик предварительного просмотра возвращает дескриптор HWND из вызова функции GetFocus.
CDocument::OnPreviewHandlerTranslateAccelerator	Заставляет обработчик предварительного просмотра обрабатывает нажатие клавиши переданное из насоса сообщения процесса, в котором выполняется модуль предварительного просмотра.
CDocument::OnRichPreviewBackColorChanged	Вызываемый при большой цвет фона предварительного просмотра.
CDocument::OnRichPreviewFontChanged	Вызываемый при большой шрифт предварительного просмотра.
CDocument::OnRichPreviewSiteChanged	Вызываемый при большой сайт предварительного просмотра.
CDocument::OnRichPreviewTextColorChanged	Вызываемый при большой цвет текста предварительного просмотра.
CDocument::OnSaveDocument	Вызываемый для сохранения документа на диск.
CDocument::OnUnloadHandler	Вызываемый платформой, когда обработчик предварительного просмотра расгрузится.
CDocument::PreCloseFrame	Вызываемый до фреймовым окном закрыть.
CDocument::ReadNextChunkValue	Считывает следующее значение блока.
CDocument::ReleaseFile	Освобождает файл, чтобы сделать его доступным для использования другими приложениями.
CDocument::RemoveChunk	Удаляет блокировку с указанным идентификатором GUID.
CDocument::RemoveView	Наконец удаляет представление из документа.
CDocument::ReportSaveLoadException	Расширенный переопределяемый метод; вызываемый, когда операция сохранения открытого или не может быть выполнена из-за исключения.
CDocument::SaveModified	Расширенный переопределяемый метод; вызываемый для запроса пользователя, должен ли документ быть сохранены.
CDocument::SetChunkValue	Устанавливает значение блока.
CDocument::SetModifiedFlag	Устанавливает пометить указывает, что измененный документ с момента последнего сохранения.
CDocument::SetPathName	Задает путь файла данных, используемого этим документом.
CDocument::SetTitle	Задает заголовок документа.
CDocument::UpdateAllViews	Уведомляет все представления, документ изменил.

Защищенные методы

Имя	Описание
CDocument::OnFileSendMail	Отправляет сообщение электронной почты с вложенный документ.
CDocument::OnUpdateFileSendMail	Включает команду почте отправляться если присутствует поддержка почты.

Открытые члены данных

Имя	Описание
CDocument::m_bGetThumbnailMode	Указывает, что объект был создание эскизов для CDocument dllhost. Должно быть вернутое CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Указывает, что объект был CDocument создать prevhost для Rich Preview. Должно быть вернутое CView::OnDraw.
CDocument::m_bSearchMode	Указывает, что объект был CDocument создать индексатором или другое приложение поиска.
CDocument::m_clrRichPreviewBackColor	Указывает цвет фона богатого окна предварительного просмотра. Этот цвет устанавливается узлом.
CDocument::m_clrRichPreviewTextColor	Определяет цвет богатого окна предварительного просмотра. Этот цвет устанавливается узлом.
CDocument::m_lfRichPreviewFont	Задает шрифт текста для богатого окна предварительного просмотра. Эти данные о шрифте установлены основным приложением.

Заметки

Документ представляет собой единицу данных, которые пользователь обычно открывается с помощью команды открыть файл и сохраняет с помощью команды сохранения файла.

CDocument поддерживает стандартные операции, как создать документ, загрузив его и сохранить ее. Границы обрабатывают документов с помощью интерфейса указанный CDocument.

Приложение может поддерживать несколько типов документа; например, приложение может поддерживать и электронные таблицы и текстовые документы. Каждый тип документа имеет соответствующий шаблон документа; шаблон документа определяет, какие ресурсы (например, меню значка или таблицы сочетаний клавиш) используйте для этого типа документа. Каждый документ содержит указатель на связанный объект CDocTemplate.

Пользователи взаимодействуют с документом через объекты CView, связанные с ними. Подготавливает образ представление документа в фреймовом окне ввод пользователем и интерпретирует как операции в документе. Документ может иметь несколько представлений, связанные с ним. Когда пользователь открывает окно в документе, платформа создает представление и вложат их к документу. Шаблон документа определяет, что тип представления и фреймовому окно используется для отображения каждого типа документа.

Документы часть инфраструктуры маршрутизации команд стандартной и, следовательно, получают команд из стандартных компонентов интерфейса пользователя (например, пункт меню сохранения файла). Получает активный документ команды переадресованные представлением. Если документ не выполняет заданную команду, он переадресует команда в шаблон документа, который управляет его.

Если данные документа изменены, каждое из его представлений должны отразить эти изменения. CDocument содержит функцию-член UpdateAllViews для уведомления представления таких изменений, поэтому представления могут обновлять по мере необходимости. Платформа также запрашивают пользователь сохранить измененный файл перед тем, как закрыть их.

Для реализации документы в типичном приложении, необходимо выполнить следующие действия:

Создайте класс, наследуемый от CDocument для каждого типа документа.
Добавьте переменные-члены для хранения данных каждого документа.
Реализуйте функции-члены для чтения и изменения данных документа. Представления документа наиболее важные пользователи этих функций-членов.
Переопределить функцию-член CObject::Serialize в классе документа для записи и чтения данные документа с диска.

CDocument поддерживает отправить документ по почте если поддержка почты (MAPI). См. статьи MAPI и поддержка MAPI в MFC.

Дополнительные сведения о CDocument см. в разделе сериализация, Разделы архитектуры документов и представлений и Создание документов и представлений.