Метод IOleDocumentView::Clone (docobj.h)

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

Синтаксис

HRESULT Clone(
  [in]  IOleInPlaceSite  *pIPSiteNew,
  [out] IOleDocumentView **ppViewNew
);

Параметры

[in] pIPSiteNew

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

[out] ppViewNew

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

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

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

Код возврата	Описание
E_FAIL	Операция не удалась.
E_POINTER	Значение в ppViewNew равно NULL.
E_NOTIMPL	Объект представления не реализует этот интерфейс.

Комментарии

Этот метод полезен для создания нового представления с другим окном просмотра и сайтом представления, но с тем же контекстом представления, что и клонируется представление. Как правило, контейнеры, в котором размещено приложение MDI, вызывают этот метод для предоставления возможности "Окно/Новое окно".

Требования

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

См. также раздел

IOleDocumentView

IOleDocumentView::SetInPlaceSite