Share via

IXpsOMObjectFactory::CreatePage メソッド (xpsobjectmodel.h)

  • [アーティクル]

1 つのページの内容を表すオブジェクトのツリーのルート ノードを提供する IXpsOMPage インターフェイスを作成します。

構文

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

パラメーター

[in] pageDimensions

作成するページのサイズを指定する XPS_SIZE 構造体。

サイズは XPS 単位で説明されています。 1 インチあたり 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、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー xpsobjectmodel.h

こちらもご覧ください

IXpsOMObjectFactory

インターネット エンジニアリング タスク フォース (IETF) RFC 3066

XML Paper Specification

XPS ドキュメント エラー