设置由单个磁贴覆盖的目标几何部分。
语法
HRESULT SetViewport(
[in] const XPS_RECT *viewport
);
参数
[in] viewport
描述单个磁贴覆盖的目标几何部分的 XPS_RECT 结构。
返回值
该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
视区 为 NULL。 |
|
视区中描述的矩形无效。 |
注解
视区是绘制磁贴的输出区域部分。 在下图中，视区以红色虚线矩形内的蓝色矩形为轮廓。 画笔的平铺模式确定如何在输出区域中绘制其他磁贴。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | xpsobjectmodel.h |