Windows GDI函式，功能為該函式可以設定指定設備環境中的點陣圖拉伸模式。
基本介紹
- 外文名：SetSTretchBltMode
- 原型：int 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函式以避免出現刷子沒對準現象。
根據設備驅動程式的功能不同，其他一些拉伸模式也可能有效。
