CreateDIBPatternBrush 関数 (wingdi.h)

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

CreateDIBPatternBrush 関数は、指定されたデバイスに依存しないビットマップ (DIB) で指定されたパターンを持つ論理ブラシを作成します。ブラシは、その後、ラスター操作をサポートするデバイスに関連付けられている任意のデバイスコンテキストで選択できます。

メモこの関数は、16 ビットバージョンの Windows との互換性のためにのみ提供されます。アプリケーションでは、 CreateDIBPatternBrushPt 関数を使用する必要があります。

構文

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

パラメーター

[in] h

ビットマップのピクセルを定義するバイト配列の直後に BITMAPINFO 構造体で構成される、パックされた DIB を含むグローバルメモリオブジェクトへのハンドル。

[in] iUsage

BITMAPINFO 構造体の bmiColors メンバーを初期化するかどうかを指定し、初期化されている場合は、このメンバーに明示的な赤、緑、青 (RGB) の値またはインデックスを論理パレットに含めるかどうかを指定します。 fuColorSpec パラメーターは、次のいずれかの値である必要があります。

値	意味
DIB_PAL_COLORS	カラーテーブルが提供され、ブラシを選択するデバイスコンテキストの論理パレットに 16 ビットインデックスの配列で構成されます。
DIB_RGB_COLORS	カラーテーブルが提供され、リテラル RGB 値が含まれています。

戻り値

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

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

注釈

アプリケーションが 2 色の DIB パターンブラシをモノクロデバイスコンテキストに選択した場合、システムは DIB で指定された色を認識しません。代わりに、デバイスコンテキストの現在の背景と前景色を使用してパターンブラシが表示されます。 DIB の最初の色 (DIB カラーテーブルのオフセット 0) にマップされたピクセルは、前景色を使用して表示されます。2 番目の色 (カラーテーブルのオフセット 1) にマップされたピクセルは、背景色を使用して表示されます。

ブラシが不要になったら、 DeleteObject 関数を呼び出して削除します。

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

要件

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