IXpsOMObjectFactory::CreateDocumentStructureResource 方法 (xpsobjectmodel.h)

创建 IXpsOMDocumentStructureResource 接口,该接口提供对文档结构资源流的访问。

语法

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

参数

[in] acquiredStream

要与此资源关联的只读 IStream 接口。 此参数不得为 NULL

重要 将此流视为 Single-Threaded 单元 (STA) 对象;请勿重新输入。
 

[in] partUri

IOpcPartUri 接口,其中包含要分配给此资源的部件名称。 此参数不得为 NULL

[out, retval] documentStructureResource

指向新 IXpsOMDocumentStructureResource 接口的 指针。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
acquiredStreampartUridocumentStructureResourceNULL

注解

XPS 文档的 DocumentStructure 部分包含文档大纲,该大纲与 StoryFragments 部分一起定义文档固定页中显示的每个元素的阅读顺序。 此接口使程序能够读取 DocumentStructure 部件的 XML 内容,并替换 DocumentStructure 部件的 XML 内容。

DocumentStructure 部件包含描述文档整体阅读顺序的文档框架和大纲。 阅读顺序组织成称为故事的语义块。 文章是文档的逻辑单元,其方式与文章是杂志中的单元相同。 故事由一个或多个 StoryFragments 部件组成。

StoryFragments 部件包含定义故事语义块的内容结构标记,例如构成故事内容的段落和表。

XML 纸张规范中介绍了 DocumentStructure 和 StoryFragments 部分的内容。

要求

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

另请参阅

IOpcPartUri

IXpsOMDocumentStructureResource

IXpsOMObjectFactory

IXpsOMStoryFragmentsResource

XML 纸张规范

XPS 文档错误