CreateSolidBrush 関数 (wingdi.h)

[アーティクル]
03/04/2024

CreateSolidBrush 関数は、指定された純色を持つ論理ブラシを作成します。

構文

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

パラメーター

[in] color

ブラシの色。 COLORREF カラー値を作成するには、RGB マクロを使用します。

戻り値

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

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

注釈

HBRUSH オブジェクトが不要になったら、DeleteObject 関数を呼び出して削除します。

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

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

システムカラーブラシを使用して描画するには、GetSysColorBrush は新しいブラシをCreateSolidBrush(GetSysColor(nIndex))割り当てる代わりにキャッシュされたブラシを返すので、アプリケーションではではなくを使用GetSysColorBrush (nIndex)する必要があります。

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

例

例については、「色付きペンとブラシの作成」を参照してください。

要件

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