CreatePatternBrush 函式 (wingdi.h)

CreatePatternBrush 函式會使用指定的點陣圖模式建立邏輯筆刷。 位圖可以是 DIB 區段位圖,這是 CreateDIBSection 函式所建立,也可以是裝置相依位圖。

語法

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

參數

[in] hbm

要用來建立邏輯筆刷之位圖的句柄。

傳回值

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

如果函式失敗,則傳回值為 NULL

備註

圖樣筆刷是系統用來繪製填滿圖案內部的點陣圖。

應用程式藉由呼叫 CreatePatternBrush 來建立筆刷之後,就可以藉由呼叫 SelectObject 函式,將該筆刷選取到任何裝置內容中。

您可以使用 DeleteObject 函式來刪除圖樣筆刷,而不會影響相關聯的點陣圖。 因此,您可以使用這個點陣圖來建立任意數目的圖樣筆刷。

使用單色 (每圖元 1 位) 位陣圖所建立的筆刷,具有所繪製裝置內容的文字和背景色彩。 以 0 位表示的圖元會以目前的文字色彩繪製;以 1 位表示的圖元會以目前的背景色彩繪製。

Icm: 筆刷建立時沒有色彩。 不過,當筆刷選取為啟用ICM的裝置內容時,就會執行色彩管理。

範例

如需範例,請參閱 使用筆刷

規格需求

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

另請參閱

筆刷函式

筆刷概觀

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

SelectObject

SetBrushOrgEx