L_PaintDCOverlay

# include“l_bitmap.h”

L_LTDIS_APIL_INTL_PaintDCOverlay(hDC, pBitmap, nIndex, pSrc, pClipSrc, pDst, pclipst, uROP3);

在指定的索引处绘制覆盖。使用此函数绘制未自动绘制的覆盖层。

参数

L_HDChDC

设备上下文(如屏幕)的句柄,用作显示表面。设备上下文的映射模式必须为MM_TEXT。

pBITMAPHANDLEpBitmap

指向引用主位图句柄的指针。

L_INTnIndex

用于绘画的覆盖层的索引。覆盖层应该有位图。如果叠加被嵌入到位图位平面中,请确保在调用此函数之前创建了叠加位图。该索引从零开始。

L_RECT* pSrc

指向Windows RECT结构的指针,该结构指定要用作显示源的位图部分。

RECT结构中的坐标相对于主位图。您可以传递NULL来使用默认值,它与主位图匹配。

L_RECT* pClipSrc

指向指定要绘制的显示源的部分的Windows RECT结构的指针。通常,这用于在部分源位图发生更改时更新显示。

RECT结构中的坐标相对于主位图。您可以传递NULL来使用默认值,它与主位图匹配。

L_RECT* pDst

指向Windows RECT结构的指针,该结构确定源矩形如何缩放以及图像如何在设备上下文中定位。

RECT结构中的坐标是相对于设备上下文的。此参数没有默认值。必须指定RECT结构。

L_RECT* pClipDst

指向指定要绘制的显示矩形部分的Windows RECT结构的指针。一般来说,这用于更新显示表面的更改,例如当用户移动另一个窗口时,显示被覆盖的图像的一部分。

RECT结构中的坐标是相对于设备上下文的。您可以传递NULL来使用与设备上下文匹配的默认值。然而,在大多数情况下,您应该使用Windows WM_PAINT消息返回的矩形。

L_UINT32uROP3

确定如何更新目标矩形的Windows ROP代码。该参数的代码与Windows的BitBlt函数相同。对于普通绘画,使用SRCCOPY。

返回

价值 意义
成功 函数成功。
< 1 一个错误发生。指返回代码

评论

这个函数将绘制一个叠加位图。有关绘制矩形的更多信息,请参见L_PaintDC.L_PaintDC将绘制所有在OVERLAYATTRIBUTES结构的uFlags成员中设置了OVERLAY_AUTOPAINT的覆盖。覆盖层按升序索引绘制:覆盖层0先绘制,然后是覆盖层1,等等。

使用这个函数手动绘制覆盖层。例如,要改变覆盖的绘制顺序,从覆盖的uFlags成员中清除OVERLAY_AUTOPAINT标志OVERLAYATTRIBUTES结构并直接调用L_PaintDCOverlay。

要临时做一个覆盖顶部,调用L_PaintDCOverlay afterL_PaintDC.要永久地使覆盖最上,改变它的索引,并给它定义的最高索引。

叠加位图1像素的颜色设置在OVERLAYATTRIBUTES结构的crColor成员中。0像素的叠加位图被认为是透明的。

有关overlay属性的更多信息,包括OVERLAY_AUTOPAINT标志和crColor,请参考OVERLAYATTRIBUTES。

所需的dll和库

平台

x64 Win32。

另请参阅

功能

主题

例子

这个例子假设pBitmap包含覆盖。它会让它看起来好像覆盖0是最上面的
该示例还假设hDC和pDest已经在其他地方初始化

L_INT PaintDCOverlayExample (HDC HDC,pBITMAPHANDLE pBitmap,LPRECT pd)L_INT nRet;nRet = L_PaintDC(hDC, pBitmap, NULL, NULL, pDest, NULL, SRCCOPY);如果(nRet ! =成功)返回nRet;nRet = L_PaintDCOverlay(hDC, pBitmap, 0, NULL, NULL, pDest, NULL, SRCCOPY);如果(nRet ! =成功)返回nRet;/*现在覆盖0是最上面的(它覆盖了所有其他的覆盖)*/返回成功;

LEADTOOLS光栅成像C API帮助
188金宝搏的网址客服|支持|联系我们|知识产权的通知
©1991 - 2021领先的技术公司。保留所有权利。