CreatePatternBrush 関数 (wingdi.h)

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

CreatePatternBrush 関数は、指定されたビットマップパターンを使用して論理ブラシを作成します。ビットマップには、 CreateDIBSection 関数によって作成される DIB セクションビットマップを指定することも、デバイスに依存するビットマップにすることもできます。

構文

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

パラメーター

[in] hbm

論理ブラシの作成に使用するビットマップのハンドル。

戻り値

関数が成功した場合、戻り値は論理ブラシを識別します。

関数が失敗した場合は、返される値は NULL です。

注釈

パターンブラシは、塗りつぶされた図形の内部を描画するためにシステムが使用するビットマップです。

アプリケーションは、 CreatePatternBrush を呼び出してブラシを作成した後、 SelectObject 関数を呼び出すことによって、そのブラシを任意のデバイスコンテキストに選択できます。

DeleteObject 関数を使用すると、関連付けられたビットマップに影響を与えずにパターンブラシを削除できます。したがって、このビットマップを使用して、任意の数のパターンブラシを作成できます。

モノクロ (ピクセルあたり 1 ビット) ビットマップを使用して作成されたブラシには、描画先のデバイスコンテキストのテキストと背景色が含まれます。 0 ビットで表されるピクセルは、現在のテキストの色で描画されます。1 ビットで表されるピクセルは、現在の背景色で描画されます。

Icm： ブラシの作成時に色は行われません。ただし、カラー管理は、ブラシが ICM 対応デバイスコンテキストに選択されたときに実行されます。

例

例については、「ブラシの使用」を参照してください。

要件

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