IXpsOMObjectFactory::CreateDocumentStructureResource 方法 (xpsobjectmodel.h)
建立 IXpsOMDocumentStructureResource 介面,以提供檔結構資源資料流的存取權。
語法
HRESULT CreateDocumentStructureResource(
[in] IStream *acquiredStream,
[in] IOpcPartUri *partUri,
[out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);
參數
[in] acquiredStream
要與此資源相關聯的唯讀 IStream 介面。 此參數不得為 Null。
重要 將此資料流程視為 Single-Threaded Apartment (STA) 物件;請勿重新輸入。
[in] partUri
IOpcPartUri介面,其中包含要指派給此資源的元件名稱。 此參數不得為 Null。
[out, retval] documentStructureResource
新 IXpsOMDocumentStructureResource 介面的指標。
傳回值
方法會傳回 HRESULT。 可能的值包括下列資料表中的值,但不限於這些值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關資訊,請參閱 XPS 檔錯誤。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
acquiredStream、 partUri或 documentStructureResource 為 Null。 |
備註
XPS 檔的 DocumentStructure 部分包含檔大綱,其中 StoryFragments 元件會定義出現在檔固定頁面中之每個元素的讀取順序。 這個介面可讓程式讀取 DocumentStructure 元件的 XML 內容,並取代 DocumentStructure 元件的 XML 內容。
DocumentStructure 元件包含檔架構和描述檔整體讀取順序的大綱。 讀取順序會組織成稱為劇本的語意區塊。 劇本是檔的邏輯單元,與文章在雜誌中的單位相同。 劇本是由一或多個 StoryFragment 元件所組成。
StoryFragments 元件包含內容結構標記,可定義本文的語意區塊,例如構成本文內容的段落和資料表。
DocumentStructure 和 StoryFragments 元件的內容會在 XML 紙張規格中說明。
規格需求
最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | xpsobjectmodel.h |