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 ドキュメント エラー」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
pageDimensions、 partUri、または page が NULL です。 |
|
language に有効な言語文字列が含まれていません。 |
|
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 |