IPicture::Render 方法 (ocidl.h)

呈现 (绘制) 由源图片的偏移量 (xSrcySrc) 定义的指定部分以及要复制 (cxSrc、xySrc) 的尺寸。 此图片呈现到指定的设备上下文中,定位在 x,y) (点,并缩放cx,cy) (尺寸。 如果目标设备上下文本身是图元文件, 则 prcWBounds 参数指定此呈现的位置。 需要此类信息才能将一个图元文件放入另一个图元文件。 有关详细信息,请参阅 IViewObject2::D rawprcWBounds 参数。

语法

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 是图元文件 DC)的矩形的指针。 在这种情况下,不能为 NULL

返回值

此方法支持标准返回值E_FAIL、E_INVALIDARG和E_OUTOFMEMORY,以及以下内容:

返回代码 说明
S_OK
已成功呈现图片。
E_POINTER
hdc 包含图元文件设备上下文时,prcWBounds 中的地址无效。
CTL_E_INVALIDPROPERTYVALUE
参数 cxcycxSrccySrc 的值为零。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IPicture