Метод IOleDocument::CreateView (docobj.h)

Статья
08/23/2023

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

Синтаксис

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

Параметры

[in] pIPSite

Указатель на интерфейс IOleInPlaceSite , представляющий объект сайта представления, связанный с новым объектом представления документа. Этот параметр может иметь значение NULL, например, если представление содержится в новом неинициализированном объекте документа. В этом случае вызывающий объект должен инициализировать представление с последующим вызовом IOleDocumentView::SetInPlaceSite.

[in] pstm

Указатель на поток, содержащий данные, из которых должен инициализироваться новый объект представления документа. Если значение РАВНО NULL, объект документа инициализирует новый объект представления документа с состоянием по умолчанию.

[in] dwReserved

Этот параметр зарезервирован и должен быть равен нулю.

[out] ppView

Указатель на переменную указателя IOleDocumentView , которая получает указатель интерфейса на новый объект представления документа. При успешном выполнении вызывающий объект отвечает за вызов IUnknown::Release для указателя ppview , когда объект представления больше не нужен.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
E_FAIL	Операция не удалась.
E_OUTOFMEMORY	Недостаточно памяти, доступной для операции.
E_UNEXPECTED	Произошла непредвиденная ошибка.
E_POINTER	Адрес в ppView имеет значение NULL.

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

Вызов CreateView не приводит к отображению нового представления. Для этого необходимо вызвать IOleDocumentView::Show или IOleDocumentView::UIActivate.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	docobj.h