IXpsOMPageReference インターフェイス (xpsobjectmodel.h)

[アーティクル]
08/28/2023

XPS ドキュメント内のページの仮想化を有効にします。

ページ参照は、ページが要求されるまで、ページの完全なオブジェクトモデルの読み込みを延期します。ページが変更されていない場合は、要求に応じてアンロードすることもできます。

継承

IXpsOMPageReference インターフェイスは、IUnknown インターフェイスから継承します。 IXpsOMPageReference には、次の種類のメンバーもあります。

メソッド

IXpsOMPageReference インターフェイスには、これらのメソッドがあります。


IXpsOMPageReference::Clone インターフェイスのディープコピーを作成します。 (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets IsHyperlinkTarget プロパティが TRUE に設定されているすべてのドキュメントサブツリーオブジェクトの名前を含む IXpsOMNameCollection インターフェイスを取得します。
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 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h