IXpsOMTileBrush：：GetViewbox 方法 (xpsobjectmodel.h)
获取磁贴要使用的源图像部分。
语法
HRESULT GetViewbox(
[out, retval] XPS_RECT *viewbox
);
参数
[out, retval] viewbox
描述磁贴要使用的源内容区域的 XPS_RECT 结构。
返回值
如果 方法成功，则返回S_OK;否则，它将返回 HRESULT 错误代码。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
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 |