Класс COleClientItem

Статья
06/10/2015

Определяет интерфейс контейнера к элементам OLE.

class COleClientItem : public CDocItem

Члены

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

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

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

Имя	Описание
COleClientItem::Activate	Открывает элемент OLE для операции, а затем выполняет указанную команду.
COleClientItem::ActivateAs	Активировать элемент как другой тип.
COleClientItem::AttachDataObject	Получает данные в объект OLE.
COleClientItem::CanCreateFromData	Указывает, является ли приложение контейнера может создать внедренный объект.
COleClientItem::CanCreateLinkFromData	Указывает, является ли приложение контейнера может создать связанный объект.
COleClientItem::CanPaste	Указывает, содержит ли буфер обмена embeddable или статический элемент OLE.
COleClientItem::CanPasteLink	Указывает, содержит ли буфер обмена linkable элемент OLE.
COleClientItem::Close	Закрывает соединение с сервером, но не удаляет элемент OLE.
COleClientItem::ConvertTo	Преобразовывает элемент в другой тип.
COleClientItem::CopyToClipboard	Копирует элемент OLE в буфер обмена.
COleClientItem::CreateCloneFrom	Создает дубликат существующего элемента.
COleClientItem::CreateFromClipboard	Создает встроенный элемент из буфера обмена.
COleClientItem::CreateFromData	Создает встроенный элемент из объекта данных.
COleClientItem::CreateFromFile	Создает встроенный элемент из файла.
COleClientItem::CreateLinkFromClipboard	Создает связанный элемент из буфера обмена.
COleClientItem::CreateLinkFromData	Создает связанный элемент из объекта данных.
COleClientItem::CreateLinkFromFile	Создает связанный элемент из файла.
COleClientItem::CreateNewItem	Создает новый внедренный элемент, запустив серверное приложение.
COleClientItem::CreateStaticFromClipboard	Создает статический элемент из буфера обмена.
COleClientItem::CreateStaticFromData	Создает статический элемент из объекта данных.
COleClientItem::Deactivate	Отключает элемент.
COleClientItem::DeactivateUI	Извлекает пользовательский интерфейс контейнерного приложения в исходное состояние.
COleClientItem::Delete	Удаляет или закрывает элемент OLE, если было связанным элементом.
COleClientItem::DoDragDrop	Выполняет операцию перетаскивания.
COleClientItem::DoVerb	Выполняет указанную команду.
COleClientItem::Draw	Рисует элемент OLE.
COleClientItem::GetActiveView	Возвращает представление, в котором элемент активировать на месте.
COleClientItem::GetCachedExtent	Возвращает границы прямоугольника OLE элемента.
COleClientItem::GetClassID	Получает идентификатор класса присутствующего элемента
COleClientItem::GetClipboardData	Возвращает данные, которые будут помещены в буфер обмена, вызвав функцию-член CopyToClipboard.
COleClientItem::GetDocument	Возвращает объект COleDocument, содержащий элемент, присутствующий.
COleClientItem::GetDrawAspect	Возвращает текущее представление элемента для отрисовки.
COleClientItem::GetExtent	Возвращает границы прямоугольника OLE элемента.
COleClientItem::GetIconFromRegistry	Retrives дескриптор для значка, связанный с сервером указанного идентификатора CLSID.
COleClientItem::GetIconicMetafile	Возвращает метафайл используемый для рисования значок элемента.
COleClientItem::GetInPlaceWindow	Возвращает указатель в окне редактирования локально элемента.
COleClientItem::GetItemState	Возвращает текущее состояние элемента.
COleClientItem::GetLastStatus	Возвращает состояние последней операции OLE.
COleClientItem::GetLinkUpdateOptions	Возвращает режим обновления для связанного элемента (продвинутой функций).
COleClientItem::GetType	Возвращает тип, связанный или внедренный (static) OLE элемента.
COleClientItem::GetUserType	Возвращает строку, описывающую тип элемента.
COleClientItem::IsInPlaceActive	Возвращает TRUE если элемент является активным в- размещения.
COleClientItem::IsLinkUpToDate	Возвращает TRUE если связанный элемент актуален со своим исходным документом.
COleClientItem::IsModified	Возвращает TRUE, если элемент был изменен с момента последнего сохранения.
COleClientItem::IsOpen	Возвращает TRUE если элемент в данный момент открыт в серверном приложении.
COleClientItem::IsRunning	Возвращает TRUE если приложение сервера запущено элемента.
COleClientItem::OnActivate	Вызываемый платформой для уведомления элемент, он активировать.
COleClientItem::OnActivateUI	Вызываемый платформой для уведомления элемент, он должен активировать и отобразить его пользовательский интерфейс.
COleClientItem::OnChange	Вызываемый, когда сервер изменяет элемент OLE. Требуемая реализация.
COleClientItem::OnDeactivate	Вызываемый платформой, когда элемент будет отключен.
COleClientItem::OnDeactivateUI	Вызываемый платформой, когда сервер удалит его пользовательский интерфейс в- размещения.
COleClientItem::OnGetClipboardData	Вызываемый платформой для получения данных необходимо скопировать в буфер обмена.
COleClientItem::OnInsertMenus	Вызываемый платформой для создания составного меню.
COleClientItem::OnRemoveMenus	Вызываемый платформой для удаления меню контейнера из составного меню.
COleClientItem::OnSetMenu	Вызываемый платформой для установки и удаления составное меню.
COleClientItem::OnShowControlBars	Вызываемый платформой, чтобы отображать и скрывать область элементов управления.
COleClientItem::OnUpdateFrameTitle	Вызываемый платформой для обновления заголовок окна фреймового окна.
COleClientItem::ReactivateAndUndo	Повторно активирует элемент и отменяет последнюю операцию редактирования локально.
COleClientItem::Release	Освобождает соединение к элементу связанному OLE и закрывает его, если он был открыт. Не удаляет элемент клиента.
COleClientItem::Reload	Перезапускает элемент после вызова метода ActivateAs.
COleClientItem::Run	Запускает приложение, связанное с элементом.
COleClientItem::SetDrawAspect	Задает текущее представление элемента для отрисовки.
COleClientItem::SetExtent	Задает прямоугольник OLE элемента.
COleClientItem::SetHostNames	Устанавливает имена редактирования сервер указывает элемент OLE.
COleClientItem::SetIconicMetafile	Кэширует метафайл в кэш, используемый для рисования значок элемента.
COleClientItem::SetItemRects	Устанавливает ограничивающий прямоугольник элемента.
COleClientItem::SetLinkUpdateOptions	Задает режим обновления для связанных элементов (продвинутой функций).
COleClientItem::SetPrintDevice	Задает модуль печат- целевого объекта для данного элемента клиента.
COleClientItem::UpdateLink	Обновляет кэш представления элемента.

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

Имя	Описание
COleClientItem::CanActivate	Вызываемый средой, чтобы определить, следует ли разрешена встроенной активации.
COleClientItem::OnChangeItemPosition	Вызываемый платформой, если позиция элемента изменится.
COleClientItem::OnDeactivateAndUndo	Вызываемый платформой, чтобы отменить после активации.
COleClientItem::OnDiscardUndoState	Вызываемый платформой для отмены отката сведения о состоянии элемента.
COleClientItem::OnGetClipRect	Вызываемый платформой, для которого необходимо получить диапазон звука- прямоугольник элемента координатах.
COleClientItem::OnGetItemPosition	Вызываемый платформой, чтобы получить позицию элемента по отношению к представлению.
COleClientItem::OnGetWindowContext	Вызываемый платформой, когда элемент будет активировать на месте.
COleClientItem::OnScrollBy	Вызываемый платформой, чтобы прокрутить элемент в представление.
COleClientItem::OnShowItem	Вызываемый платформой для отображения OLE элемента.

Заметки

Элемент OLE представляет данные, созданные и поддерживаемые серверным приложением, которое может быть "легко" включаемым в документ таким образом, чтобы он будет отображаться, что пользователю был одинарным документом. Результат - "составного документа" являются OLE элемента и содержащего документа.

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

COleClientItem определяет несколько функций переопределяемого метода, которые Вызываются в ответ на запросы из серверного приложения; эти переопределяемые методы, как правило, являются уведомления. Это позволяет серверное приложение сообщить контейнер изменений пользователь делает элемент OLE, редактирования или получать сведения, необходимые во время редактирования.

COleClientItem может быть использован с классом COleDocument, COleLinkingDoc или COleServerDoc. Для использования COleClientItem, унаследуйте класс от него и реализуйте функции-члена OnChange, который определяет, как контейнер, реагирует на сделанные изменения элемента. Для поддержки встроенной активации, следует переопределить функцию-член OnGetItemPosition. Эта функция предоставляет сведения об указанном положении OLE элемента.

Дополнительные сведения об использовании интерфейса контейнера см. статьи контейнеры: Реализация контейнера и активация.

Примечание

Windows SDK ссылается внедренные и связанные элементы, такие как "объекты" и относится к типам элементов, как "класс". Использование этой ссылки термин "элемент" отличить от соответствующего объекта OLE сущность C++ и термин "тип", чтобы отличить категории OLE из класса C++.