IXpsOMTileBrush：：SetViewbox 方法 (xpsobjectmodel.h)

设置要用作磁贴图像的源内容部分。

语法

HRESULT SetViewbox(
  [in] const XPS_RECT *viewbox
);

[in] viewbox

描述要用作磁贴图像的源内容部分的 XPS_RECT 结构。

该方法返回 HRESULT。可能的值包括但不限于后面的表中的值。有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

画笔的视图框指定要用作磁贴图像的源图像或视觉对象的部分。

画笔视图框的坐标相对于源内容，因此 (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