TextureBrush::TextureBrush(Image*,WrapMode,constRect&) メソッド (gdiplusbrush.h)

[アーティクル]
08/24/2023

イメージ、ラップモード、および定義する四角形に基づいて TextureBrush オブジェクトを作成します。

構文

void TextureBrush(
  [in]      Image        *image,
  [in]      WrapMode     wrapMode,
  [in, ref] const Rect & dstRect
);

パラメーター

[in] image

種類: イメージ*

使用するイメージのビットマップを含む Image オブジェクトへのポインター。

[in] wrapMode

種類: WrapMode

このテクスチャブラシを使用して領域を描画するときに、イメージの繰り返しコピーを使用して領域をタイル化する方法を指定する WrapMode 列挙体の要素。

[in, ref] dstRect

型: const Rect

このテクスチャブラシのサイズと、このテクスチャブラシで使用するイメージの部分を定義する四角形への参照。 Image オブジェクトがメタファイルから作成された場合、ブラシはイメージ全体を使用し、ブラシのサイズに合わせて拡大縮小されます。

戻り値

なし

解説

テクスチャブラシの幅と高さは、 dstRect 四角形の幅と高さで定義されます。テクスチャブラシは常に (0,0) に向かいます。四角形の左上のポイント、幅、高さは、テクスチャブラシで使用するイメージの部分の開始点、幅、および高さを指定します。

このコンストラクターで dstRect 四角形と非メタファイルイメージを使用する方法

dstRect 四角形のサイズが、ブラシの基になっているイメージの寸法よりも小さい場合、ブラシのイメージはトリミングされます。これはイメージの一部です。 dstRect 四角形のサイズがイメージの寸法と等しい場合、ブラシのイメージはイメージと同じです。 dstRect 四角形には、画像の寸法外の領域を含めてはいけません。これにより、予期しない動作が生成されるか、実行時エラーが生成されます。たとえば、256 ×256 ピクセルのイメージがあり、このイメージに基づいて TextureBrush オブジェクトを作成し、 dstRect パラメーターとして渡すとします。ブラシは画像の左下部分を使用します。この部分の左下隅は、画像の左下隅でもあります。次に、同じイメージに基づいて別の TextureBrush オブジェクトを作成し、 dstRect パラメーターとして渡すとします。この四角形は、156 ではなく 157 で最も上の座標を持つ点に注意してください。この四角形は、画像の高さを超えて 1 つの単位を拡張し、アクセス違反が発生する可能性が高くなります。

このコンストラクターがメタファイルイメージと共に dstRect 四角形を使用する方法

dstRect 四角形の寸法がイメージの寸法と異なる場合、ブラシのイメージは、四角形に合わせて必要に応じて小さくまたは大きくスケーリングされます。たとえば、256 ×256 ピクセルのメタファイルイメージがあり、dstRect パラメーターとして渡して TextureBrush オブジェクトを作成するとします。ブラシのイメージにはすべてのメタファイルイメージが含まれますが、ブラシに合わせてスケーリングされます。垂直に波線が引き伸ばされ、水平方向に引き伸ばされます。四角形の寸法が画像の寸法と等しい場合、ブラシのイメージはイメージと同じです。

このコンストラクターでラップモードを使用する方法

ブラシの境界を越えて延びる領域は、ブラシの繰り返しコピーでタイル化されます。テクスチャブラシでは、折り返しモードで指定されているように、代替タイルが特定の方向に反転されている場合があります。反転は、ブラシの画像を反転させる効果があります。

要件


サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusbrush.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll