SetSTretchBltMode

int SetStretchBltMode(HDC hdc, int iStretchMode)；

hdc：設備環境句柄。

iStretchMode：指定拉伸模式。它可以取下列值，這些值的含義如下：

BLACKONWHITE：使用消除和現在的像素顏色值進行邏輯AND（與）操作運算。如果該位圖是單色位圖，那麼該模式以犧牲白色像素為代價，保留黑色像素點。

COLORONCOLOR：刪除像素。該模式刪除所有消除的像素行，不保留其信息。

HALFTONE：將源矩形區中的像素映射到目標矩形區的像素塊中，覆蓋目標像素塊的一般顏色與源像素的顏色接近。在設置完HALFTONE拉伸模之後，應用程序必須調用SetBrushOrgEx函數來設置刷子的起始點。如果沒有成功，那麼會出現刷子沒對準的情況。

STRETCH_ANDSCANS：與BLACKONWHITE一樣。

STRETCH_DELETESCANS：與COLORONCOLOR一樣。

STRETCH_HALFTONE：與HALFTONE相同。

STRETCH_ORSCANS：與WHITEONBLACK相同。

WHITEONBLACK：使用顏色值進行邏輯OR（或）操作，如果該位圖為單色位圖，那麼該模式以犧牲黑色像素為代價，保留白色像素點。

返回值：如果函數執行成功，那麼返回值就是先前的拉伸模式，如果函數執行失敗，那麼返回值為0。

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

備註：拉伸模式在應用程序調用StretchBit函數時定義系統如何將位圖的行或列與顯示設備上的現有像素點進行組合。

BLACKONWHITE(STRETCH_ANDSCANS)和WHITEONBLACK(STRETCH_ORSCANS)模式典型地用來保留單色位圖中的前景像素。COLORONCOLOR(STRETCH_DELETESCANS)模式則典型地用於保留彩色位圖中的顏色。

HALFTONE模式比其他三種模式需要對源圖像進行更多的處理，也比其他模式慢，但它能產生高質量圖像，也應注意在設置HALFTONE模式之後，應調用SetBrushOrgEx函數以避免出現刷子沒對準現象。

根據設備驅動程序的功能不同，其他一些拉伸模式也可能有效。