(xpsobjectmodel.h) IXpsOMPackage 介面

發行項
03/13/2024

提供 XPS 物件模型樹狀結構的最上層專案。

雖然這個介面未對應到任何 XPS 標記，但它會對應至 XPS 檔，而且需要將 XPS 物件模型樹狀結構的元件儲存為 XPS 檔。

繼承

IXpsOMPackage 介面繼承自 IUnknown 介面。 IXpsOMPackage 也有下列類型的成員：

方法

IXpsOMPackage 介面具有這些方法。


IXpsOMPackage：：GetCoreProperties 取得 XPS 套件之 IXpsOMCoreProperties 介面的指標。
IXpsOMPackage：：GetDiscardControlPartName 取得 XPS 封裝中捨棄控件元件的名稱。
IXpsOMPackage：：GetDocumentSequence 取得IXpsOMDocumentSequence 介面的指標，其中包含 XPS 封裝的文件順序。
IXpsOMPackage：：GetThumbnailResource 取得與 XPS 套件相關聯之縮圖資源的 IXpsOMImageResource 介面指標。
IXpsOMPackage：：SetCoreProperties 設定 XPS 套件的 IXpsOMCoreProperties 介面。
IXpsOMPackage：：SetDiscardControlPartName 設定 XPS 套件中捨棄控件元件的名稱。
IXpsOMPackage：：SetDocumentSequence 設定 XPS 套件的 IXpsOMDocumentSequence 介面。
IXpsOMPackage：：SetThumbnailResource 設定 XPS 檔的縮圖影像。
IXpsOMPackage：：WriteToFile 將 XPS 套件寫入指定的檔案。
IXpsOMPackage：：WriteToStream 將 XPS 套件寫入指定的數據流。

備註

下列程式代碼範例說明如何建立此介面的實例。


IXpsOMPackage    *newInterface;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
      __uuidof(XpsOMObjectFactory),
      NULL, 
      CLSCTX_INPROC_SERVER,
      __uuidof(IXpsOMObjectFactory),
      reinterpret_cast<LPVOID*>(&xpsFactory)
      );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreatePackage (&newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }

    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

如需在程式中使用此介面的相關信息，請參閱建立空白 XPS OM。

規格需求

需求	值
最低支援的用戶端	適用於 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