IXpsOMPageReference::SetPage 方法 (xpsobjectmodel.h)

设置页面引用的 IXpsOMPage 接口。

语法

HRESULT SetPage(
  [in] IXpsOMPage *page
);

参数

[in] page

页面的 IXpsOMPage 接口指针。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
pageNULL
XPS_E_NO_CUSTOM_OBJECTS
page 不指向已识别的接口实现。 不支持 XPS 文档 API 接口的自定义实现。

注解

此方法添加的页面可以为空或完全构造。

如果传入页引用了远程字典对象,则此调用不会将这些对象导入文档对象。 必须在对 IXpsOMPage::SetDictionaryResource 或 IXpsOMCanvas::SetDictionaryResource 方法的单独调用中添加它们。

如果已设置页面,则调用方法必须先释放该页面,然后再使用新页面调用 SetPage 。 为了说明,使用新页面调用 SetPage 后,即使原始页面仍然存在于包中,也无法放弃该页面。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMPage

IXpsOMPageReference

IXpsOMPageReference::D iscardPage

IXpsOMPageReference::GetPage

XML 纸张规范