IXpsOMObjectFactory：：CreatePage 方法 (xpsobjectmodel.h)

  • 项目

创建 IXpsOMPage 接口，该接口提供表示单个页面内容的 对象的树的根节点。

语法

HRESULT CreatePage(
  [in]          const XPS_SIZE *pageDimensions,
  [in]          LPCWSTR        language,
  [in]          IOpcPartUri    *partUri,
  [out, retval] IXpsOMPage     **page
);

参数

[in] pageDimensions

XPS_SIZE结构，用于指定要创建的页面的大小。

大小以 XPS 单位描述。 每英寸有 96 个 XPS 单位。 例如，8.5“ x 11.0” 页的尺寸为 816 x 1,056 XPS 单位。

[in] language

指示所创建页面的默认语言的字符串。

重要 语言字符串必须遵循 RFC 3066 语法。
 

[in] partUri

包含要分配给此资源的部件名称的 IOpcPartUri 接口。

[out, retval] page

指向新 IXpsOMPage 接口的指针。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

返回代码 说明
S_OK
 方法成功。
E_POINTER
 pageDimensions、 partUri 或 page 为 NULL。
XPS_E_INVALID_LANGUAGE
 language 不包含有效的语言字符串。
XPS_E_INVALID_PAGE_SIZE
 pageDimensions 包含无效的页面大小或无效的页大小值。

注解

下面的代码示例演示了如何使用此方法创建新接口。


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
}

要求

要求 值
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMObjectFactory

(IETF) RFC 3066 的 Internet 工程任务组

XML 纸张规范

XPS 文档错误