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

Задает прямоугольные координаты окна просмотра, в котором должно быть активировано представление, или сбрасывает координаты окна просмотра, в котором в настоящее время активировано представление.

Синтаксис

HRESULT SetRect(
  [in] LPRECT prcView
);

Параметры

[in] prcView

Указатель на структуру RECT , содержащую координаты окна просмотра.

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

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

Код возврата	Описание
E_FAIL	Операция не удалась.

Комментарии

Для приложения с одним интерфейсом документов (SDI) окно просмотра является клиентской областью окна фрейма за вычетом пространства, выделенного для панелей инструментов, строки состояния и т. п. Для окна многодокументного интерфейса (MDI) окно просмотра является клиентской областью окна документа MDI за исключением любых других элементов пользовательского интерфейса на уровне фрейма.

Примечания к вызывающим абонентам

Вызов IOleDocumentView::SetRect или IOleDocumentView::SetRectComplex является частью обычной последовательности активации для объектов документов, обычно после вызова IOleDocumentView::UIActivate и перед вызовом IOleDocumentView::Show.

При изменении размера окна, используемого для отображения объекта документа, контейнер должен вызывать IOleDocumentView::SetRect (или IOleDocumentView::SetRectComplex), чтобы указать объекту представления документа изменить размер до новых размеров окна.

Примечания для разработчиков

Координаты окна просмотра находятся в координатах окна представления, которое получается с помощью IOleWindow::GetWindow. Размер представления должен изменяться в соответствии с новыми координатами, переданными в prcView.

Этот метод определен с помощью атрибута [input_sync], что означает, что объект представления не может дать или выполнить другой вызов RPC, отличный от input_sync, при выполнении этого метода.

Представление документа должно полностью реализовать этот метод; E_NOTIMPL не является допустимым возвращаемым значением.

Требования

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

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

IOleDocumentView