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

Метод IViewObjectEx::GetRect (ocidl.h)

  • Статья

Извлекает прямоугольник, описывающий запрошенный аспект рисования.

Синтаксис

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

Параметры

[in] dwAspect

Запрошенный аспект рисования.

[out] pRect

Указатель на прямоугольник, описывающий запрошенный аспект рисования.

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

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

Код возврата Описание
DV_E_DVASPECT
 Метод не поддерживает указанный аспект. Либо объект не поддерживает запрошенный аспект, либо аспект не является прямоугольным.

Комментарии

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

Аспект рисования Описание
DVASPECT_CONTENT Объекты должны возвращать ограничивающий прямоугольник всего объекта. Верхний левый угол находится в источнике объекта, а размер равен экстенту, возвращаемого IViewObject2::GetExtent.
DVASPECT_OPAQUE Объекты с прямоугольной непрозрачной областью должны возвращать этот прямоугольник. Другие должны завершиться ошибкой и вернуть код ошибки DV_E_DVASPECT.

Если возвращается прямоугольник, он гарантированно будет полностью скрыт путем вызова IViewObject::D raw для этого аспекта. Контейнер должен использовать этот прямоугольник, чтобы вырезать непрозрачные части объекта перед рисованием какого-либо объекта за ним во время прохода назад к переднему. Если этот метод завершается сбоем для объекта с непрямоугольной непрозрачной областью, контейнер должен нарисовать весь объект в обратной и передней части с помощью DVASPECT_CONTENT аспекта.
DVASPECT_TRANSPARENT Объекты должны возвращать прямоугольник, охватывающий все прозрачные или нестандартные части. Если у объекта нет прозрачных или нестандартных частей, он может вернуть DV_E_ASPECT. Контейнер может использовать этот прямоугольник для определения наличия других объектов, перекрывающих прозрачные части данного объекта.

Требования

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

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

IViewObjectEx