GradientFill

BOOL GradientFill(HDC hdc, CONST PTRIVERTEX pVertex, DWORD dwNumVertex, CONST PVOID pMesh, DWORD dwNumMesh, DWORD dwMode)；

hdc：指向目標設備環境的句柄。

pVertex：指向TRIVERTEX結構數組的指針，該數組中的每項定義了三角形頂點。

dwNumVertex：頂點數目。

pMesh：三角形模式下的GRADIENT_TRIANGLE結構數組，或矩形模式下的GRADIENT_RECT結構數組。

dwNumMesh：參數pMesh中的成員數目（這些成員是三角形或矩形）。

dwMode：指定傾斜填充模式。該參數可以包含下列值，這些值的含義為：

GRADIENT_FILL_RECT_H：在該模式下，兩個端點表示一個矩形。該矩形被定義成左右邊界具有固定顏色（由TRIVERTEX結構指定）。GDI從上至下插入顏色，並填充內部區域。

GRADIENT_FILL_RECT_V：在該模式下，兩個端點表示一個矩形。該矩形定義其頂部和底部邊界的顏色為固定值（通過TRIVERTEX結構指定），GDI從頂至底部邊界插入顏色，並填充內部區域。

GRADIENT_FILL_TRIANGLE：在該模式下，TRIVERTEX結構數組以及描述單個三角形的數組索引序列被傳給GDI。GDI在三角形頂點之間進行線性插值，並填充內部區域。在24和32位/像素模式下，繪圖是直接進行。在16、8、4和1位/像素模式中進行抖動處理。

如果函數執行成功，那麼返回值為TRUE；如果函數執行失敗，則返回值為FALSE。

若想獲得更多錯誤信息，請調用GetLastError函數。

備註：若想在矩形區域中加入一些平滑的陰影（底紋），請用三角形的三個頂點調用GradientFill函數。GDI將進行線性插值，並填充矩形區域。在繪製矩形時可能使用兩種陰影模式在水平模式中，矩形從左至右開始變暗，在垂直模式中則是從上至下進行。

GradientFill函數使用網眼法（mesh method）來表示要繪製對象的端點。所有傳給GradientFill的頂點都存儲在pVertex數組中。參數pMesh指定了這些頂點如何連接形成一個對象。當填充矩形時，pMesh指向一個GRADIENT_RECT結構數組。每一個GRADIENT_RECT結構指定了pVertex數組中兩個頂點的索引值，這兩個頂點形成一個矩形的左上角和右下角座標。

在填充三角形情況下，pMesh指向的是GRADIENT_TRIANGLE結構數組。每一個GRADIENT_TRIANGLE結構指定了pVertex數組中的3個頂點，這三個頂點形成一個三角形。

為了簡化硬件加速，無需要求該例程在三角形內部具有像素完善特性。

若想了解更多信息，參考平滑成影、繪製帶陰影三角形和矩形等方面的內容。

Windows NT：5.0及以上版本；Windows：98及以上版本；Windows CE 5.0以上：支持；頭文件：wingdi.h；庫文件：作為一個資源包含在msimg32.dll中。