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

Статья
08/23/2023

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

Синтаксис

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Параметры

[in] prcView

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

[in] prcHScroll

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

[in] prcVScroll

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

[in] prcSizeBox

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

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

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

Код возврата	Описание
E_FAIL	Операция не удалась.
E_NOTIMPL	Объект документа, которому принадлежит это представление, не поддерживает сложные прямоугольники.

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

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

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

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

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

Объекты документов, поддерживающие сложные прямоугольники, помечают себя с помощью DOCMISC_SUPPORTCOMPLEXRECTANGLES, как описано в разделах DOCMISC и IOleDocument::GetDocMiscStatus. Объекты документов, которые не поддерживают этот метод, могут возвращать E_NOTIMPL.

После получения вызова этого метода представление должно изменить размер в соответствии с координатами, указанными в prcView, и соответствовать его полосам прокрутки и размеру поля с областями, описанными в prcHScroll, prcVScroll и prcSizeBox.

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

Требования

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

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

IOleDocument::GetDocMiscStatus

IOleDocumentView

Поделиться через