iXpsOMPageReference 接口 (xpsobjectmodel.h)

项目
08/28/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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h