IXpsOMTileBrush::SetViewbox メソッド (xpsobjectmodel.h)
タイル イメージとして使用するソース コンテンツの部分を設定します。
構文
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
パラメーター
[in] viewbox
タイル イメージとして使用するソース コンテンツの部分を記述する XPS_RECT 構造。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
viewbox が NULL です。 |
|
viewbox で説明されている四角形が無効でした。 |
注釈
ブラシのビューボックスは、タイル イメージとして使用するソース イメージまたはビジュアルの部分を指定します。
ブラシのビュー ボックスの座標はソース コンテンツに対する相対座標であり、(0,0) はソース コンテンツの左上隅を指定します。 画像の場合、ブラシのビューボックスで指定された寸法は、1/96 の単位で表されます。 ソース イメージ内の対応するピクセル座標は、次のように計算されます。
次の図では、左側の画像はソース イメージの例ですが、右側には、ブラシの選択されたビュー ボックスが赤い四角形として表示されているソース イメージがあります。 この例では、タイル ブラシのコンテンツとして使用されるソース イメージの部分は、赤い四角形内の領域です。 イメージの網掛けされた領域は、ブラシでは使用されません。
ソース イメージの解像度が 1 インチあたり 96 x 96 ドットで、画像のサイズが 96 x 96 ピクセルの場合、 viewbox パラメーターのフィールドの値は次のようになります。上記のパラメーター値は、ソース イメージに次のように対応しています。
- SourceLeft = 96 * 48 / 96 = 左側から 48 ピクセル
- SourceTop = 96 * 24 / 96 = 上から 24 ピクセル
- SourceWidth = 96 * 24 / 96 = 24 ピクセル幅
- SourceHeight = 96 * 48 / 96 = 48 ピクセルの高さ
要件
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |