IXpsOMTileBrush::SetViewbox 方法 (xpsobjectmodel.h)
设置要用作磁贴图像的源内容部分。
语法
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
参数
[in] viewbox
描述要用作磁贴图像的源内容部分的 XPS_RECT 结构。
返回值
该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
viewbox 为 NULL。 |
|
视图框中描述的矩形无效。 |
注解
画笔的视图框指定要用作磁贴图像的源图像或视觉对象的部分。
画笔视图框的坐标相对于源内容,因此 (0,0) 指定源内容的左上角。 对于图像,画笔的视图框指定的尺寸以 1/96“的单位表示。 源图像中的相应像素坐标的计算方式如下:
在下图中,左侧的图像是源图像的示例,右侧是源图像,其中画笔的选定视图框显示为红色矩形。 在此示例中,用作磁贴画笔内容的源图像部分是红色矩形内的区域。 画笔不使用图像的阴影区域。
如果源图像分辨率为每英寸 96 x 96 点,图像尺寸为 96 x 96 像素,则 viewbox 参数中的字段值将为:上述参数值对应于源图像,如下所示:
- SourceLeft = 96 * 48 / 96 = 48 像素(从左侧)
- SourceTop = 96 * 24 / 96 = 24 像素(距顶部)
- SourceWidth = 96 * 24 / 96 = 24 像素宽
- SourceHeight = 96 * 48 / 96 = 48 像素高
要求
最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | xpsobjectmodel.h |