Метод IOleDocumentView::SetRect (docobj.h)
Задает прямоугольные координаты окна просмотра, в котором должно быть активировано представление, или сбрасывает координаты окна просмотра, в котором в настоящее время активировано представление.
Синтаксис
HRESULT SetRect(
[in] LPRECT prcView
);
Параметры
[in] prcView
Указатель на структуру RECT , содержащую координаты окна просмотра.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Операция не удалась. |
Комментарии
Для приложения с одним интерфейсом документов (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 |