IXpsOMPageReference::SetAdvisoryPageDimensions メソッド (xpsobjectmodel.h)
ページの推奨ディメンションを設定します。
構文
HRESULT SetAdvisoryPageDimensions(
[in] const XPS_SIZE *pageDimensions
);
パラメーター
[in] pageDimensions
ページに対して設定する推奨ディメンション。
height メンバーと width メンバーの値は –1.0 であるか、+1.0 以上の値である必要があります。
サイズについては、XPS 単位で説明します。 1 インチあたり 96 個の XPS ユニットがあります。 たとえば、8.5" x 11.0" ページのディメンションは 816 x 1,056 XPS 単位です。
戻り値
メソッドが成功すると、S_OKが返されます。それ以外の場合は、 HRESULT エラー コードが返されます。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
pageDimensions が NULL であるか、pageDimensions によって参照されるXPS_SIZE構造体のフィールドに無効な値が含まれています。 |
|
pageDimensions で説明されているアドバイザリ ページ サイズが無効でした。 pageDimensions の高さと幅のメンバーには、-1.0 の値または +1.0 以上の値が必要です。 |
注釈
pageDimensions によって参照されるXPS_SIZE構造体の高さと幅のメンバーには、+1.0 以上の値が必要です。これらのフィールドの値を設定する場合は -1.0 にする必要があります。 たとえば、アドバイザリ ディメンションをページ幅のみに設定する場合、 pageDimensions.width には目的の値が設定され、 pageDimensions.height の値は -1.0 になります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |