勇芳软件工作室.汉化:  Bitmaps > Bitmap Functions >

SetStretchBltMode

Previous pageReturn to chapter overviewNext page

描述

 

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)