Класс CDocTemplate

Статья
06/10/2015

Абстрактный базовый класс, который определяет базовые функциональные возможности шаблонов документов.

class CDocTemplate : public CCmdTarget

Члены

Защищенные конструкторы

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

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

Имя	Описание
CDocTemplate::AddDocument	Добавляет документ с шаблоном.
CDocTemplate::CloseAllDocuments	Закрывает все документы, связанные с этим шаблоном.
CDocTemplate::CreateNewDocument	Создает новый документ.
CDocTemplate::CreateNewFrame	Создает новое фреймовое окно, в котором содержится документ и представление.
CDocTemplate::CreateOleFrame	Создает OLE- разрешенный фреймовое окно.
CDocTemplate::CreatePreviewFrame	Создает кадр дочернего элемента, используемый для богатого предварительного просмотра.
CDocTemplate::GetDocString	Извлекает строку, связанную с типом документа.
CDocTemplate::GetFirstDocPosition	Получает положение первого документа, связанного с этим шаблоном.
CDocTemplate::GetNextDoc	Извлекает документ и позиция следующего.
CDocTemplate::InitialUpdateFrame	Инициализирует фреймовое окно, а также делает его видимым.
CDocTemplate::LoadTemplate	Загружает ресурсы для заданного CDocTemplate или производного класса.
CDocTemplate::MatchDocType	Определяет степень уверенности в найденном соответствии между типами документов и этим шаблоном.
CDocTemplate::OpenDocumentFile	Открывает файл, указанный по имени пути.
CDocTemplate::RemoveDocument	Удаляет документ из шаблона.
CDocTemplate::SaveAllModified	Сохранение всех документов, связанные с этим шаблоном, которые были изменены.
CDocTemplate::SetContainerInfo	Определяет ресурсы для редактирования OLE-контейнер элемент OLE в- размещения.
CDocTemplate::SetDefaultTitle	Отображается по умолчанию заголовок в строке заголовка окна документа.
CDocTemplate::SetPreviewInfo	Установки из процесса обработки предварительного просмотра.
CDocTemplate::SetServerInfo	Определяет ресурсы и классы, когда внедрить документ сервера или изменянное в- размещение.

Заметки

Обычно создать один или несколько шаблонов в реализации функции InitInstance приложения. Шаблон документа определяет связи между 3 типов классов:

Класс документа, который наследуется от CDocument.
Класс представления, отображающий данные из класса документа, перечисленные выше. Можно наследовать этот класс CView, CScrollView, CFormView или CEditView. (Можно также использовать CEditView напрямую).
Класс фреймового окна, который содержит представление. Для приложения одинарного интерфейса (SDI), необходимо создать производный класс от этого CFrameWnd. Для приложения интерфейса MDI, необходимо создать производный класс от этого CMDIChildWnd. Если не нужно настраивать функциональности фреймового окна, можно использовать CFrameWnd или CMDIChildWnd непосредственно без наследования в класс.

Приложение имеет один шаблон документа для каждого типа документа, он поддерживает. Например, если приложение поддерживает и электронные таблицы и текстовые документы, то приложение имеет 2 объекта шаблона документа. Каждый шаблон документа отвечает за создание и управление все документы этого типа.

Шаблон документа содержит указатели на объекты CRuntimeClass для документа, представления и классов фреймового окна. Задание этих объектов CRuntimeClass при построении шаблон документа.

Шаблон документа содержит идентификатор ресурсов, используемых с типом документа (например, меню, значок или ресурсы в таблице сочетаний клавиш). Шаблон документа также содержит строки, содержащие дополнительные сведения о своем типе документа. Они включают имя типа документа (например, "лист") и расширения файлов (например, ".xls"). Дополнительно он может содержать другие строки, используемые пользовательским интерфейсом приложения, файловым менеджером Windows и объектом (выделение содержит поддержка OLE).

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

Поскольку CDocTemplate абстрактный класс, нельзя использовать класс напрямую. Типичное приложение использует один из 2 CDocTemplate- производные классы, предоставляемые библиотеки Microsoft Foundation Class. CSingleDocTemplate, который реализует интерфейс SDI и CMultiDocTemplate, который реализует интерфейс MDI. См. раздел эти классы дополнительные сведения об использовании шаблонов документов.

Если приложение требует парадигмы, то интерфейса пользователя, принципиально иной из SDI или MDI можно создать собственный класс, производный от CDocTemplate.

Дополнительные сведения о CDocTemplate см. в разделе Шаблоны документов и процесс создания документов и представлений.