CreatePatternBrush 関数 (wingdi.h)
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 |