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,以及以下内容:
返回代码 | 说明 |
---|---|
|
已成功呈现图片。 |
|
当 hdc 包含图元文件设备上下文时,prcWBounds 中的地址无效。 |
|
参数 cx、 cy、 cxSrc 或 cySrc 的值为零。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |