Метод IPicture::Render (ocidl.h)

Статья
02/29/2024

Отрисовывает (рисует) указанную часть рисунка, определяемую смещением (xSrc,ySrc) исходного рисунка и размерами для копирования (cxSrc,xySrc). Этот рисунок отображается в указанном контексте устройства, расположен в точке (x,y) и масштабируется до размеров (cx,cy). Параметр prcWBounds указывает положение этой отрисовки, если контекст целевого устройства сам по себе является метафайлом. Такие сведения необходимы для размещения одного метафайла в другом. Дополнительные сведения см. в параметре prcWBoundsобъекта IViewObject2::D raw.

Синтаксис

HRESULT Render(
  [in] HDC                hDC,
  [in] LONG               x,
  [in] LONG               y,
  [in] LONG               cx,
  [in] LONG               cy,
  [in] OLE_XPOS_HIMETRIC  xSrc,
  [in] OLE_YPOS_HIMETRIC  ySrc,
  [in] OLE_XSIZE_HIMETRIC cxSrc,
  [in] OLE_YSIZE_HIMETRIC cySrc,
  [in] LPCRECT            pRcWBounds
);

Параметры

[in] hDC

Дескриптор контекста устройства для отрисовки изображения.

[in] x

Горизонтальная координата в hdc , по которой размещается отрисованное изображение.

[in] y

Вертикальная координата в hdc , по которой размещается отрисованное изображение.

[in] cx

Горизонтальное измерение (ширина) прямоугольника назначения.

[in] cy

Вертикальное измерение (высота) прямоугольника назначения

[in] xSrc

Горизонтальное смещение исходного рисунка, с которого начинается копирование.

[in] ySrc

Вертикальное смещение исходного рисунка, с которого начинается копирование.

[in] cxSrc

Горизонтальный экстент для копирования из исходного рисунка.

[in] cySrc

Вертикальный экстент для копирования из исходного рисунка.

[in] pRcWBounds

Указатель на прямоугольник, содержащий позицию назначения в контексте устройства метафайла, если hdc является контроллером домена метафайла. В таких случаях не может иметь значение NULL .

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

Этот метод поддерживает стандартные возвращаемые значения E_FAIL, E_INVALIDARG и E_OUTOFMEMORY, а также следующие:

Код возврата	Описание
S_OK	Рисунок успешно отрисован.
E_POINTER	Адрес в prcWBounds недопустим , если hdc содержит контекст устройства метафайла.
CTL_E_INVALIDPROPERTYVALUE	Параметр cx, cy, cxSrc или cySrc имеет нулевое значение.

Требования

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

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

IPicture

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