GradientFill是一個計算機函式，hdc為指向目標設備環境的句柄，功能為填充矩形和三角形結構。
基本介紹
- 外文名：GradientFill
- 函式功能：該函式填充矩形和三角形結構
- hdc：指向目標設備環境的句柄
- dwNumVertex：頂點數目
函式原型,參數,返回值,更多信息,速查,
函式原型
BOOL GradientFill(HDC hdc, CONST PTRIVERTEX pVertex, DWORD dwNumVertex, CONST PVOID pMesh, DWORD dwNumMesh, DWORD dwMode)；
參數
hdc：指向目標設備環境的句柄。
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。
更多信息
Windows NT
若想獲得更多錯誤信息，請調用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中。
