描述
SetStretchBltMode功能设置指定设备上下文中的位图拉伸模式。
C++ 语法
int SetStretchBltMode( __in HDC hdc, __in int iStretchMode ); |
PowerBASIC 语法
FUNCTION SetStretchBltMode( _ BYVAL hdc AS DWORD, _ BYVAL iStretchMode AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
iStretchMode
[in]指定拉伸模式。此参数可以是以下值之一。
值 |
描述 |
BLACKONWHITE |
使用已消除和现有像素的颜色值执行布尔AND运算。如果位图是单色位图,则此模式以牺牲白色像素为单位保留黑色像素。 |
COLORONCOLOR |
删除像素。此模式删除所有已删除的像素行,而不尝试保留其信息。 |
HALFTONE |
将源矩形中的像素映射到目标矩形中的像素块。目标像素块上的平均颜色近似于源像素的颜色。
Windows 95/98 / Me不支持此选项。 |
STRETCH_ANDSCANS |
和BLACKONWHITE一样。 |
STRETCH_DELETESCANS |
同COLORONCOLOR。 |
STRETCH_HALFTONE |
与HALFTONE相同。 |
STRETCH_ORSCANS |
和WHITEONBLACK一样。 |
WHITEONBLACK |
使用已消除和已存在的像素的颜色值执行布尔OR运算。如果位图是单色位图,则此模式将以黑色像素为代价来保留白色像素。 |
返回值
如果功能成功,则返回值为先前的拉伸模式。
如果函数失败,返回值为零。
Windows NT / 2000 / XPVista / Windows 7:要获取扩展错误信息,请调用GetLastError.这可以是以下值。
值 |
含义 |
ERROR_INVALID_PARAMETER |
一个或多个输入参数无效。 |
备注
拉伸模式定义当应用程序调用{??989796140}函数时,系统将位图的行或列与显示设备上的现有像素组合。
BLACKONWHITE(STRETCH_ANDSCANS)和WHITEONBLACK(STRETCH_ORSCANS)模式通常用于保留单色位图中的前景像素。COLORONCOLOR(STRETCH_DELETESCANS)模式通常用于保留彩色位图中的颜色。
HALFTONE模式比其他三种模式更慢,需要更多的源图像处理;但产生更高质量的图像。另请注意,在设置HALFTONE模式后,必须调用SetBrushOrgEx以避免刷不对齐。
根据设备驱动程序的功能,还可以使用其他扩展模式。
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)