iXpsOMPageReference 接口 (xpsobjectmodel.h)

启用 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

另请参阅

创建空白 XPS OM

IXpsOMDocumentStructureResource

IXpsOMImageResource

IXpsOMNameCollection

IXpsOMObjectFactory::CreatePageReference

IXpsOMPage

IXpsOMPrintTicketResource

IXpsOMStoryFragmentsResource

接口

导航 XPS OM

XML 纸张规范