IXpsOMTileBrush：：GetViewbox 方法 (xpsobjectmodel.h)

获取磁贴要使用的源图像部分。

语法

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

[out, retval] viewbox

描述磁贴要使用的源内容区域的 XPS_RECT 结构。

如果方法成功，则返回S_OK;否则，它将返回 HRESULT 错误代码。

返回代码	说明
S_OK	方法成功。
E_POINTER	viewbox 为 NULL。

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

画笔视图框的坐标相对于源内容，因此 (0,0) 指定源内容的左上角。对于图像，画笔的视图框指定的尺寸以 1/96“的单位表示。源图像中的相应像素坐标的计算方式如下：

在下图中，左侧的图像是源图像的示例，中间的图像显示所选的视图框，右侧的图像显示生成的画笔。

如果源图像分辨率为每英寸 96 x 96 点，图像尺寸为 96 x 96 像素，则 viewbox 参数中的字段值将为：

上述参数值对应于源图像，如下所示：

SourceLeft = 96 × 48 / 96 = 48 像素

SourceTop = 96 × 4 / 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