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

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

イメージ、定義する四角形、およびイメージプロパティのセットに基づいて TextureBrush オブジェクトを作成します。

構文

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

パラメーター

[in] image

種類: イメージ*

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

[in, ref] dstRect

型: Rect

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

[in] imageAttributes

種類: ImageAttributes*

省略可能。イメージのプロパティを含む ImageAttributes オブジェクトへのポインター。既定値は NULL です。

戻り値

なし

解説

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

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

dstRect 四角形のサイズが、ブラシの基になっているイメージのサイズよりも小さい場合、ブラシのイメージはトリミングされます。これはイメージの一部です。 dstRect 四角形のサイズがイメージのサイズと等しい場合、ブラシのイメージはイメージと同じです。 dstRect 四角形には、画像の寸法外の領域を含めてはなりません。これにより、予期しない動作が発生するか、実行時エラーが生成されます。たとえば、256 ×256 ピクセルのイメージがあり、このイメージに基づいて TextureBrush オブジェクトを作成し、 dstRect パラメーターとしてを渡すとします。ブラシは画像の左下部分を使用します。この部分の左下隅も画像の左下隅です。次に、dstRect パラメーターとしてを渡して、同じイメージに基づいて別の TextureBrush オブジェクトを作成するとします。この四角形の上端の座標は 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