Класс COleServerDoc

Статья
06/10/2015

Базовый класс для документов OLE-сервер.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Члены

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

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

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

Имя	Описание
COleServerDoc::ActivateDocObject	Активировать связанный документ DocObject.
COleServerDoc::ActivateInPlace	Активировать документ для редактирования на локальном компьютере.
COleServerDoc::DeactivateAndUndo	Деактивирует пользовательский интерфейс сервера.
COleServerDoc::DiscardUndoState	Данные состояния откат- сбрасываний.
COleServerDoc::GetClientSite	Извлекает указатель на базовый интерфейс IOleClientSite.
COleServerDoc::GetEmbeddedItem	Возвращает указатель на элемент, представляющий весь документ.
COleServerDoc::GetItemClipRect	Возвращает текущий прямоугольник отсечения для редактирования на локальном компьютере.
COleServerDoc::GetItemPosition	Возвращает прямоугольник текущего положения относительно клиентской области контейнерного приложения для редактирования на локальном компьютере.
COleServerDoc::GetZoomFactor	Возвращает коэффициент масштабирования в пикселях.
COleServerDoc::IsDocObject	Определяет, находится ли документ DocObject.
COleServerDoc::IsEmbedded	Указывает, включать ли документ в документе или ходе контейнера изолированных.
COleServerDoc::IsInPlaceActive	Возвращает TRUE если элемент в настоящий момент активировать на месте.
COleServerDoc::NotifyChanged	Уведомляет контейнеры, что пользователь изменил документ.
COleServerDoc::NotifyClosed	Уведомляет контейнеры, что пользователь закрыл документ.
COleServerDoc::NotifyRename	Уведомляет контейнеры, что пользователь переименовал документ.
COleServerDoc::NotifySaved	Уведомляет контейнеры, что пользователь сохранил документ.
COleServerDoc::OnDeactivate	Вызываемый платформой, когда пользователь отключает элемент, который был активирован на месте.
COleServerDoc::OnDeactivateUI	Вызываемый платформой для уничтожения элементы управления и другие элементы интерфейса пользователя создать для встроенной активации.
COleServerDoc::OnDocWindowActivate	Вызываемый платформой, когда будет активировано или деактивации фреймовое окно документа контейнера.
COleServerDoc::OnResizeBorder	Вызывается инфраструктурой при изменении размеров фреймовое окно или окна документа контейнерного приложения.
COleServerDoc::OnShowControlBars	Вызываемый платформой, чтобы показать или скрыть панель элементов управления для редактирования на локальном компьютере.
COleServerDoc::OnUpdateDocument	Вызываемый платформой, если документ сервера, внедренный элемент сохранения при обновлении копия контейнера элемента.
COleServerDoc::RequestPositionChange	Изменяет положение фрейма редактирования локально.
COleServerDoc::SaveEmbedding	Контейнерное приложение инициирует сохранение документа.
COleServerDoc::ScrollContainerBy	Документ прокручивается контейнера.
COleServerDoc::UpdateAllItems	Уведомляет контейнеры, что пользователь изменил документ.

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

Имя	Описание
COleServerDoc::CreateInPlaceFrame	Вызываемый платформой для создания фреймовое окно для редактирования на локальном компьютере.
COleServerDoc::DestroyInPlaceFrame	Вызываемый платформой для уничтожения фреймовое окно для редактирования на локальном компьютере.
COleServerDoc::GetDocObjectServer	Переопределить эту функцию для создания нового объекта CDocObjectServer и показать, что этот документ контейнер DocObject.
COleServerDoc::OnClose	Вызываемый платформой, когда запросы контейнера, чтобы закрыть документ.
COleServerDoc::OnExecOleCmd	Выполняет указанную команду или отображает справку для этой команды.
COleServerDoc::OnFrameWindowActivate	Вызываемый платформой, когда будет активировано или деактивации фреймовое окно контейнера.
COleServerDoc::OnGetEmbeddedItem	Вызываемый для получения COleServerItem, представляющий весь документ; используемый для получения внедренный элемент. Требуемая реализация.
COleServerDoc::OnReactivateAndUndo	Вызываемый платформой, чтобы отменить изменения, внесенные во время редактирования локально.
COleServerDoc::OnSetHostNames	Вызываемый платформой, когда контейнер установит заголовок окна для внедренного объекта.
COleServerDoc::OnSetItemRects	Вызываемый платформой для размещения фреймовое окно редактированием локально в окне контейнерного приложения.
COleServerDoc::OnShowDocument	Вызываемый платформой, чтобы отображать или скрывать документ.

Заметки

Документ сервера может содержать объекты COleServerItem, которые представляют встроенные или связанные элементы интерфейса сервера. Если серверное приложение запущено контейнером изменить внедренный элемент загружается как свой документ сервера; объект COleServerDoc содержит только один объект COleServerItem, состоящее из всего документа. Если серверное приложение запущено контейнером редактирования, связанный элемент, существующий документ загружен с диска; часть содержимого документа выделена для указания связанный элемент.

Объекты COleServerDoc могут также содержать элементы класса COleClientItem. Это позволяет создавать приложения контейнер- сервера. Платформа предоставляет функции для правильного хранения элементов COleClientItem пока обслуживающ COleServerItem возражает.

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

Для использования COleServerDoc, унаследуйте класс от него и реализуйте функции-члена OnGetEmbeddedItem, который позволяет сервер к элементам внедренным поддержкой. Создайте класс, наследуемый от COleServerItem чтобы реализовать элементы в документах и возвращают объекты этого класса из OnGetEmbeddedItem.

Для поддержки связывают элементы, COleServerDoc содержит функцию-член OnGetLinkedItem. Можно использовать реализацию по умолчанию или переопределить его если имеется собственный способ управления элементы документа.

Требуется один COleServerDoc- производный класс для каждого типа документа сервера свои поддержки приложения. Например, если приложение поддерживает серверного приложения и листы диаграмм требуется 2 COleServerDoc- производные классы.

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