IXpsOMObjectFactory1::CreatePackageWriterOnStream1 方法 (xpsobjectmodel_1.h)
開啟資料流,以將 XPS OM 的內容寫入指定類型的 XPS 套件。
語法
HRESULT CreatePackageWriterOnStream1(
ISequentialStream *outputStream,
BOOL optimizeMarkupSize,
XPS_INTERLEAVING interleaving,
IOpcPartUri *documentSequencePartName,
IXpsOMCoreProperties *coreProperties,
IXpsOMImageResource *packageThumbnail,
IXpsOMPrintTicketResource *documentSequencePrintTicket,
IOpcPartUri *discardControlPartName,
XPS_DOCUMENT_TYPE documentType,
IXpsOMPackageWriter **packageWriter
);
參數
outputStream
[in]要用於寫入的數據流。
optimizeMarkupSize
布爾值,指出當檔寫入數據流時,文件標記是否會針對大小進行優化。
值 | 意義 |
---|---|
|
寫入數據流時,封裝寫入器會嘗試優化標記的大小下限。 |
|
寫入封裝時,封裝寫入器不會嘗試任何優化。 |
interleaving
[in]指定當 XPS OM 的內容寫入資料流時,是否要交錯。
documentSequencePartName
[in] IOpcPartUri 介面,其中包含新檔案中文件順序的部分名稱。
coreProperties
[in] IXpsOMCoreProperties 介面,其中包含要提供給新檔案的核心文件屬性。 此參數可以設定為 NULL。
packageThumbnail
[in] IXpsOMImageResource 介面,其中包含要指派給新檔案的縮圖影像。 此參數可以設定為 NULL。
documentSequencePrintTicket
[in] IXpsOMPrintTicketResource 介面,其中包含要指派給新檔案的套件層級列印票證。 此參數可以設定為 NULL。
discardControlPartName
[in] IOpcPartUri 介面,其中包含捨棄控件元件的名稱。 此參數可以設定為 NULL。
documentType
[in]封裝寫入器的檔案類型。 此參數的值不能XPS_DOCUMENT_TYPE_UNSPECIFIED。
packageWriter
[out, retval]這個方法所建立之新 IXpsOMPackageWriter 介面的指標。
傳回值
可能的值包括,但不限於下列各項。 如需此處未列出的 XPS 檔 API 傳回值的相關信息,請參閱 XPS 檔錯誤。
S_OK:方法成功且 packageWriter 已正確設定。
E_INVALIDARG:檔案類型不是有效的 XPS 檔案格式。
備註
使用這個方法來產生 MSXPS 檔或 OpenXPS 檔的套件寫入器。 CreatePackageWriterOnStream 在 Windows 7 中發行,只會以 MSXPS 格式建立 XPS 文件檔。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | xpsobjectmodel_1.h |
程式庫 | 無 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應