IPicture：：Render 方法 (ocidl.h)

  • 项目

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

语法

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
 参数 cx、 cy、 cxSrc 或 cySrc 的值为零。

要求

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

另请参阅

IPicture