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 |