CSkinStatic::SetForegroundBitmap Method

C++

void SetForegroundBitmap(BITMAPOBJ hBmpForeground, int nXSrc, int nYSrc, COLORREF rcMask = RGB(255, 0, 255), BOOL bReDraw = TRUE, BOOL bDeleteOld = TRUE);

Description

设置控件的前景图.

Parameters

Parameters	Description
BITMAPOBJ hBmpForeground	指定控件的前景图.
int nXSrc	指定显示区域的左上角X轴方向的坐标. 单位: 像素.
int nYSrc	指定显示区域的左上角Y轴方向的坐标. 单位: 像素.
COLORREF rcMask = RGB(255, 0, 255)	指定显示前景图时, 需要透明掉的颜色, hBmpForeground中所有与rcMask相同颜色的像素, 都不会显示到控件上.
BOOL bReDraw = TRUE	指定是否在设置完前景图后, 立即刷新控件.
BOOL bDeleteOld = TRUE	指定是否在设置新的前景图时, 删除旧的前景图. 如果您不删除旧的前景图, 可能引起资源泄漏. 您也可以在调用本函数前, 调用GetForegroundBitmap来得到旧的前景图, 手动删除它.

Remarks

本控件支持在背景图上, 再显示一张前景图. 前景图显示的时候, 不进行缩放, 把hBmpForeground上水平方向从nXSrc, 垂直方向从nYSrc开始, 宽度为控件宽度, 高度为控件高度大小部分, 绘制到控件上, 并占满整个控件. 如果前景图的尺寸小于控件的尺寸, 那么显示不全的部分将透过前景图, 看到背景图. 指定为rcMask的部分也直接看到背景图. 通过指定rcMask, 本功能实现了在Static控件上显示一张不规则图形的能力.