共用方式為

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
 語言 不包含有效的語言字串。
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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 xpsobjectmodel.h

另請參閱

IXpsOMObjectFactory

Internet Engineering Task Force (IETF) RFC 3066

XML Paper Specification

XPS 檔案錯誤