StretchBlt 函数 (wingdi.h)

项目
03/04/2024

StretchBlt 函数将位图从源矩形复制到目标矩形，并在必要时拉伸或压缩位图以适应目标矩形的尺寸。系统根据当前在目标设备上下文中设置的拉伸模式拉伸或压缩位图。

语法

BOOL StretchBlt(
  [in] HDC   hdcDest,
  [in] int   xDest,
  [in] int   yDest,
  [in] int   wDest,
  [in] int   hDest,
  [in] HDC   hdcSrc,
  [in] int   xSrc,
  [in] int   ySrc,
  [in] int   wSrc,
  [in] int   hSrc,
  [in] DWORD rop
);

参数

[in] hdcDest

目标设备上下文的句柄。

[in] xDest

目标矩形左上角的 x 坐标（以逻辑单位为单位）。

[in] yDest

目标矩形左上角的 y 坐标（以逻辑单位为单位）。

[in] wDest

目标矩形的宽度（以逻辑单元表示）。

[in] hDest

目标矩形的高度（以逻辑单元表示）。

[in] hdcSrc

源设备上下文的句柄。

[in] xSrc

源矩形左上角的 x 坐标（以逻辑单位为单位）。

[in] ySrc

源矩形左上角的 y 坐标（以逻辑单位为单位）。

[in] wSrc

源矩形的宽度（以逻辑单元表示）。

[in] hSrc

源矩形的高度（以逻辑单元表示）。

[in] rop

要执行的光栅操作。光栅操作代码定义系统如何在涉及画笔、源位图和目标位图的输出操作中组合颜色。

有关 IOPS) (常见光栅操作代码的列表，请参阅 BitBlt 。请注意，捕获BLT ROP 通常不能用于打印设备上下文。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注解

StretchBlt 在内存中拉伸或压缩源位图，然后将结果复制到目标矩形。此位图可以是兼容位图 (DDB) ，也可以是 CreateDIBSection 的输出。在拉伸或压缩发生后，将合并图案或目标像素的颜色数据。

记录增强型图元文件时， (发生错误，如果源设备上下文标识增强型图元文件设备上下文，则函数返回 FALSE) 。

如果指定的光栅操作需要画笔，系统会使用当前在目标设备上下文中选择的画笔。

通过使用当前为目标设备上下文指定的转换来转换目标坐标;通过使用当前为源设备上下文指定的转换来转换源坐标。

如果源转换具有旋转或剪切，则会发生错误。

如果目标位图、源位图和图案位图的颜色格式不同， StretchBlt 会将源位图和图案位图转换为与目标位图匹配。

如果 StretchBlt 必须将单色位图转换为彩色位图，则会将白色位 (1) 设置为背景色，将黑色位设置为 (0) 前景色。若要将颜色位图转换为单色位图，它将背景色匹配的像素设置为白色 (1) ，并将所有其他像素设置为黑色 (0) 。在转换中将使用彩色设备上下文的前景色和背景色。

如果 nWidthSrc 和 nWidthDest 参数的符号或者 nHeightSrc 和nHeightDest 参数不同，StretchBlt 将创建位图的镜像图像。如果 nWidthSrc 和 nWidthDest 具有不同的符号，则函数会沿 x 轴创建位图的镜像图像。如果 nHeightSrc 和 nHeightDest 具有不同的符号，则函数将沿 y 轴创建位图的镜像图像。

并非所有设备都支持 StretchBlt 函数。有关详细信息，请参阅 GetDeviceCaps。

Icm： 发生 blit 操作时，不执行颜色管理。

在多监视器系统中使用时， hdcSrc 和 hdcDest 必须引用同一设备，否则函数将失败。若要在不同设备的 DC 之间传输数据，请通过调用 GetDIBits 将内存位图转换为 DIB。若要向第二台设备显示 DIB，请调用 SetDIBits 或 StretchDIBits。

示例

有关示例，请参阅缩放图像。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll