IXpsOMPage 接口 (xpsobjectmodel.h)

项目
08/28/2023

提供保存单个页面内容的对象的树的根节点。

IXpsOMPage 接口对应于 XPS 文档标记中的 FixedPage 元素。

继承

IXpsOMPage 接口继承自 IXpsOMPart。 IXpsOMPage 还具有以下类型的成员：

方法

IXpsOMPage 接口具有这些方法。


IXpsOMPage：：Clone 创建接口的深层副本。 (IXpsOMPage.Clone)
IXpsOMPage：：GenerateUnusedLookupKey 生成一个唯一名称，该名称可由资源字典中的资源用作查找键。
IXpsOMPage：：GetBleedBox 获取页面出血框的尺寸。
IXpsOMPage：：GetContentBox 获取页面内容框的尺寸。
IXpsOMPage：：GetDictionary 获取指向与此页关联的已解析 IXpsOMDictionary 接口的指针。
IXpsOMPage：：GetDictionaryLocal 获取指向与此页关联的本地非共享字典的 IXpsOMDictionary 接口的指针。
IXpsOMPage：：GetDictionaryResource 获取指向此页使用的共享字典资源的 IXpsOMRemoteDictionaryResource 接口的指针。
IXpsOMPage：：GetIsHyperlinkTarget 获取一个布尔值，该值指示页面是否是超链接的目标。
IXpsOMPage：：GetLanguage 获取页面的 Language 属性。
IXpsOMPage：：GetName 获取页面的 Name 属性。
IXpsOMPage：：GetOwner 获取指向包含该页的 IXpsOMPageReference 接口的指针。
IXpsOMPage：：GetPageDimensions 获取页面维度。
IXpsOMPage：：GetVisuals 获取指向 IXpsOMVisualCollection 接口的指针，该接口包含页面可视对象的集合。
IXpsOMPage：：SetBleedBox 设置页面出血框的尺寸。
IXpsOMPage：：SetContentBox 设置页面内容框的尺寸。
IXpsOMPage：：SetDictionaryLocal 设置页面本地字典资源的 IXpsOMDictionary 接口指针。
IXpsOMPage：：SetDictionaryResource 设置页面远程字典资源的 IXpsOMRemoteDictionaryResource 接口指针。
IXpsOMPage：：SetIsHyperlinkTarget 指定页面是否是超链接的目标。
IXpsOMPage：：SetLanguage 设置页面的 Language 属性。
IXpsOMPage：：SetName 设置此页面的 Name 属性。
IXpsOMPage：：SetPageDimensions 设置页面的尺寸。
IXpsOMPage：：Write 将页面写入指定的流。

注解

下面的代码示例演示了如何创建此接口的实例。


IXpsOMPage        *newInterface;
// The following values are defined outside of 
// this example.
//  LPWSTR        language;
//  XPS_SIZE      pageDimensions;

// 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->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreatePage (
            &pageDimensions,
            language,
            partUri,
            &newInterface);

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

            newInterface->Release();
        }
        partUri->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