CreateDIBPatternBrush 函式 (wingdi.h)

發行項
03/04/2024

CreateDIBPatternBrush 函式會建立邏輯筆刷，該筆刷具有由指定的裝置獨立位圖指定的模式， (DIB) 。筆刷隨後可以選取到任何與支援點陣作業之裝置相關聯的裝置內容中。

注意此函式僅適用於與16位版本的Windows相容。應用程式應該使用 CreateDIBPatternBrushPt 函式。

語法

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

參數

[in] h

全域記憶體物件的句柄，其中包含已封裝的 DIB，其中包含 BITMAPINFO 結構，後面緊接著定義點陣圖圖圖元的位元組陣列。

[in] iUsage

指定是否初始化 BITMAPINFO 結構的 bmiColors 成員，如果是的話，這個成員是否包含明確的紅色、綠色、藍色 (RGB) 值或索引到邏輯調色盤中。 fuColorSpec 參數必須是下列其中一個值。

值	意義
DIB_PAL_COLORS	會提供色彩表格，並將16位索引的陣列組成要選取筆刷之裝置內容的邏輯調色盤。
DIB_RGB_COLORS	會提供色彩表格，並包含常值 RGB 值。

傳回值

如果函式成功，則傳回值會識別邏輯筆刷。

如果函式失敗，傳回值為 NULL。

備註

當應用程式將雙色 DIB 圖樣筆刷選取為單色裝置內容時，系統不會認可 DIB 中指定的色彩;相反地，它會使用裝置內容的目前背景和前景色彩來顯示圖樣筆刷。使用前景色彩來顯示對應至 DIB 色彩表格中 DIB (位移 0 之第一個色彩的圖元) ;對應至色彩表格中第二個色彩 (位移 1 的圖元，) 會使用背景色彩來顯示。

當您不再需要筆刷時，請呼叫 DeleteObject 函式加以刪除。

Icm： 筆刷建立時不會執行任何色彩。不過，當筆刷選取為啟用ICM的裝置內容時，就會執行色彩管理。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll