IXpsOMPageReference 介面 (xpsobjectmodel.h)

發行項
12/22/2023

啟用 XPS 檔中頁面的虛擬化。

頁面參考會延遲載入頁面的完整物件模型，直到要求頁面為止。如果頁面尚未變更，也可以在要求時卸載。

繼承

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

方法

IXpsOMPageReference介面具有這些方法。


IXpsOMPageReference：：Clone 製作介面的深層複本。 (IXpsOMPageReference.Clone)
IXpsOMPageReference：：CollectLinkTargets 取得 IXpsOMNameCollection 介面，其中包含 IsHyperlinkTarget 屬性設定為 TRUE 之所有檔子樹物件的名稱。
IXpsOMPageReference：：CollectPartResources 建立與頁面相關聯的所有元件型資源清單。
IXpsOMPageReference：:D iscardPage 捨棄記憶體中的頁面。
IXpsOMPageReference：：GetAdvisoryPageDimensions 取得頁面的建議維度。
IXpsOMPageReference：：GetOwner 取得包含頁面參考的 IXpsOMDocument 介面指標。
IXpsOMPageReference：：GetPage 取得包含頁面之 IXpsOMPage 介面的指標。
IXpsOMPageReference：：GetPrintTicketResource 取得與頁面相關聯之頁面層級列印票證資源的 IXpsOMPrintTicketResource 介面指標。
IXpsOMPageReference：：GetStoryFragmentsResource 取得與頁面相關聯之 StoryFragments 元件資源的 IXpsOMStoryFragmentsResource 介面指標。
IXpsOMPageReference：：GetThumbnailResource 取得與頁面相關聯之縮圖影像資源的 IXpsOMImageResource 介面指標。
IXpsOMPageReference：：HasRestrictedFonts 取得布林值，這個值表示參考頁面的檔子樹狀結構是否包含任何字型資源的字元，其 EmbeddingOption 屬性設定為 XPS_FONT_EMBEDDING_RESTRICTED。
IXpsOMPageReference：：IsPageLoaded 取得參考的頁面狀態，指出是否載入頁面。
IXpsOMPageReference：：SetAdvisoryPageDimensions 設定頁面的建議維度。
IXpsOMPageReference：：SetPage 設定頁面參考的 IXpsOMPage 介面。
IXpsOMPageReference：：SetPrintTicketResource 設定要指派給頁面之頁面層級列印票證資源的 IXpsOMPrintTicketResource 介面指標。
IXpsOMPageReference：：SetStoryFragmentsResource 設定要指派給頁面之 StoryFragments 資源的 IXpsOMStoryFragmentsResource 介面指標。
IXpsOMPageReference：：SetThumbnailResource 設定要指派給頁面之縮圖影像資源的 IXpsOMImageResource 介面指標。

備註

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


IXpsOMPageReference    *newInterface;
// The following value is defined outside of 
// this example.
XPS_SIZE        advisoryPageDimensions;

// 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->CreatePageReference (
        &advisoryPageDimensions,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

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

如需在程式中使用此介面的資訊，請參閱建立空白 XPS OM 和巡覽 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