CreatePatternBrush

函數功能：該函數可以創建具有指定點陣圖模式的邏輯刷子，該點陣圖不能是DIB類型的點陣圖，DIB點陣圖是由CreateDIBSection函數創建的。

函數原型：HBRUSH CreatePatternBrush(HBITMAP hbmp)；

參數：

hbmp：指向用於創建邏輯刷子的點陣圖。

對於Windows 95和Windows 98，不支持從大於8＊8像素規模的點陣圖或DIB中創建刷子。如果指定的點陣圖比較大，那麼只使用該點陣圖中的一部分。

返回值：如果該函數執行成功，那麼返回值標識為一個邏輯刷子，如果該函數執行失敗，那麼返回值為NULL。對Windows NT，若想獲得更多錯誤信息，可調用GetLastError函數。

備註：具有某種模式的刷子實際上就是指系統用來繪製要填充圖形的內部區域的點陣圖。

在應用程序調用Create Patterm Brush創建刷子之後，可以通過調用SelectObject函數把該刷子選入到任何設備環境中。也可以使用DeleteObject函數刪除該刷子，這並不影響有關的點陣圖。因此，可以使用該點陣圖來創建任意數目的模式刷子。

使用單點陣圖（每像素佔1位）創建的刷子具有它繪製的設備環境中的文本和背景顏色。像素位為0表示使用當前文本顏色繪製像素，為1則表示使用當前背景顏色繪製像素點。

hbmp參數標識的點陣圖不能是DIB類型的點陣圖。DIB點陣圖是由函數CreateDIBSection創建的點陣圖。如果該點陣圖是DIB類型，那麼函數CreatePattemBrush將失敗。

ICM：在創建刷子時沒有顏色。然而，當該刷子被選入到一個ICM許可的設備環境中時，將進行顏色管理。

Windows CE：Windows CE象NT一樣，支持任意的刷子大小。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；頭文件：wingdi.h：庫文件：gdi32.lib。