以 DirectUI 方式实现的ImageButton

原文链接: http://www.cnblogs.com/hoodlum1980/archive/2011/02/15/1954779.html

这是一篇比较简单的文章，主要讲解的是用 DirectUI 方式实现的对话框上的按钮。例如，QQ界面上的按钮。我在前一篇文章中讲解的 PS 油画滤镜的参数对话框中使用这种方式实现了放大缩小按钮。界面截图如下所示：

　　　　

　　　　这种实现在早期我是直接写在窗口过程中的，这样的话是面向过程的方式，代码不容易移植复用。因此现在我在以前实现的基础上，把代码逻辑提取出来，放到一个类中，这样就会很方便在不同项目和场合使用。当然，由于窗口过程和考虑到代码效率的关系，实际上我封装的并不彻底，对于使用者来说依然需要做一些工作。

　　　　按钮通常有三种状态：普通，悬浮，按下，如果再加上禁用（灰化），则一共是四种状态，这里简称其为四态按钮。为此，我们需要为每种状态准备一个图片，这里我们把四副图片横向拼合成一副位图（宽度是高度的四倍）。同时，考虑到和背景融合的关系，简单的话，我们可以采用 TransparentBlt 做透明色贴图，但这样和背景的融合会有锯齿感。因此我使用的是 AlphaBlend 函数，这样就要求提供的图片是 32 BPP 且已经预先应用了 Alpha 通道的位图（预应用Alpha 这一部是我用之前的 DEMO 程序完成的）。

　　　　按钮的四个状态图片的内容和按钮的大小，都可以由用户随意定制。这里我采用的制作方法是：其他三种状态以普通状态位图为基准进行制作。悬浮状态比其他状态向左上角各移动1个像素距离（这样鼠标移动到上面和移开时，按钮产生一种浮起动画效果），灰色状态的位图是普通状态的去色结果。制作好的位图资源如下所示：

　　　　

　　　　

　　　　这样我们在项目中添加一个类，取名为CImgButton。其实现代码如下：

　　　　（1）头文件：

ImgButton.h

#pragma once
#include <windows.h>

enum BUTTON_STATES
{
STATE_NORMAL = 0,
STATE_HOVER = 1,
STATE_DOWN = 2,
STATE_GRAY = 3,
};

class CImgButton
{
public:
CImgButton(void);
~CImgButton(void);

private:
int m_left;
int m_top;
int m_width;
int m_height;
int m_state; //当前所处的状态：0-正常；1-鼠标悬浮；2-按下；3-禁止；
int m_buttonId; //点击时，发送给父窗口的消息
RECT m_bounds;
HWND m_hwndParent;
BOOL m_bIsTracking; //是否正在被跟踪（鼠标按下时）
BOOL m_bMouseDown; //鼠标是否按下
BOOL m_bEnabled;
HBITMAP m_hBitmap; //四个状态的位图

public:
void SetParentWnd(HWND hParent);
void SetBitmap(HBITMAP hBitmap);
void SetBitmap(HINSTANCE hInst, LPCTSTR lpBitmapName);
void SetBounds(int left, int top, int width, int height);
void SetButtonID(int buttonId);
void EnableWindow(BOOL bEnabled);
void OnMouseDown(int x, int y);
void OnMouseUp(int x, int y);
void OnMouseMove(int x, int y);
void OnMouseLeave();
void OnPaint(HDC hdc);
void OnPaint(HDC hdc, HDC hMemDC);

//下面的GET函数有用
BOOL IsTracking() const { return m_bIsTracking; };

//下面这些是一些用处不大的GET函数
HWND GetParentWnd() const { return m_hwndParent; };
HBITMAP GetBitmap() const { return m_hBitmap; };
int GetLeft() const { return m_left; };
int GetTop() const { return m_top; };
int GetWidth() const { return m_width; };
int GetHeight() const { return m_height; };
int GetButtonID() const { return m_buttonId; };
BOOL GetEnabled() const { return m_bEnabled; };
};

　　　　（2）代码文件：

ImgButton.cpp

#include "StdAfx.h"
#include "ImgButton.h"

#pragma comment(lib, "Msimg32.lib")

CImgButton::CImgButton(void)
{
this->m_bIsTracking = FALSE;
this->m_bMouseDown = FALSE;

this->m_hBitmap = NULL;
this->m_hwndParent = NULL;

this->m_bEnabled = TRUE;
this->m_state = STATE_NORMAL;

this->m_buttonId = 0;
}

CImgButton::~CImgButton(void)
{
if(this->m_hBitmap != NULL)
{
DeleteObject(this->m_hBitmap);
this->m_hBitmap = NULL;
}
}

void CImgButton::SetParentWnd(HWND hParent)
{
this->m_hwndParent = hParent;
}

void CImgButton::SetBitmap(HBITMAP hBitmap)
{
if(this->m_hBitmap != NULL)
{
DeleteObject(this->m_hBitmap);
}
this->m_hBitmap = hBitmap;
}

void CImgButton::SetBitmap(HINSTANCE hInst, LPCTSTR lpBitmapName)
{
if(this->m_hBitmap != NULL)
{
DeleteObject(this->m_hBitmap);
}
this->m_hBitmap = LoadBitmap(hInst, lpBitmapName);
}

void CImgButton::SetBounds(int left, int top, int width, int height)
{
this->m_left = left;
this->m_top = top;
this->m_width = width;
this->m_height = height;

this->m_bounds.left = left;
this->m_bounds.top = top;
this->m_bounds.right = left + width;
this->m_bounds.bottom = top + height;
}

void CImgButton::SetButtonID(int buttonId)
{
this->m_buttonId = buttonId;
}

void CImgButton::EnableWindow(BOOL bEnabled)
{
if(this->m_bEnabled != bEnabled)
{
this->m_bEnabled = bEnabled;
this->m_state = bEnabled ? STATE_NORMAL : STATE_GRAY;

InvalidateRect(this->m_hwndParent, &this->m_bounds, TRUE);
}
}

void CImgButton::OnMouseDown(int x, int y)
{
POINT pt;
pt.x = x;
pt.y = y;

int tmpState = this->m_state;
this->m_bMouseDown = TRUE;

if(this->m_bEnabled)
{
if(PtInRect(&this->m_bounds, pt))
{
this->m_bIsTracking = TRUE;
tmpState = STATE_DOWN; //按下
SetCapture(this->m_hwndParent);
}
else
{
this->m_bIsTracking = FALSE;
}
}
else
{
tmpState = STATE_GRAY;
}

if(this->m_state != tmpState)
{
this->m_state = tmpState;
InvalidateRect(this->m_hwndParent, &this->m_bounds, TRUE);
}
}

void CImgButton::OnMouseUp(int x, int y)
{
POINT pt;
pt.x = x;
pt.y = y;

int tmpState = this->m_state;
this->m_bMouseDown = FALSE;

if(this->m_bEnabled)
{
ReleaseCapture(); //释放鼠标
if(PtInRect(&this->m_bounds, pt))
{
tmpState = STATE_HOVER; //悬浮；

//在按钮内抬起，发送消息给父窗口！
if(this->m_bIsTracking && this->m_buttonId != 0)
{
SendMessage(this->m_hwndParent, WM_COMMAND, MAKELONG(this->m_buttonId, 0), 0);
}
}
else
{
tmpState = STATE_NORMAL;
}
}
else
{
tmpState = STATE_GRAY;
}

this->m_bIsTracking = FALSE;
if(this->m_state != tmpState)
{
this->m_state = tmpState;
InvalidateRect(this->m_hwndParent, &this->m_bounds, TRUE);
}
}

void CImgButton::OnMouseMove(int x, int y)
{
POINT pt;
pt.x = x;
pt.y = y;

BOOL bMouseOnButton = PtInRect(&this->m_bounds, pt);

int tmpState = this->m_state;
if(this->m_bEnabled)
{
if(this->m_bMouseDown)
{
if(this->m_bIsTracking)
{
tmpState = bMouseOnButton? STATE_DOWN : STATE_HOVER;
}
}
else
{
//鼠标在抬起状态下的，普通热点跟踪
tmpState = bMouseOnButton? STATE_HOVER : STATE_NORMAL;
}
}
else
{
tmpState = STATE_GRAY;
}

if(this->m_state != tmpState)
{
this->m_state = tmpState;
InvalidateRect(this->m_hwndParent, &this->m_bounds, TRUE);
}
}

//鼠标离开窗口（仅仅在悬浮状态下需要处理）
void CImgButton::OnMouseLeave()
{
if(this->m_state == STATE_HOVER)
{
this->m_state = STATE_NORMAL;
InvalidateRect(this->m_hwndParent, &this->m_bounds, TRUE);
}
}

void CImgButton::OnPaint(HDC hdc)
{
if(this->m_hBitmap == NULL)
return;

HDC hMemDC = CreateCompatibleDC(hdc);
HGDIOBJ hOldBitmap = SelectObject(hMemDC, this->m_hBitmap);

BLENDFUNCTION blendFunc;
blendFunc.BlendOp = AC_SRC_OVER;
blendFunc.BlendFlags = 0;
blendFunc.SourceConstantAlpha = 255; //整体的不透明度
blendFunc.AlphaFormat = AC_SRC_ALPHA;
AlphaBlend(hdc, this->m_left, this->m_top, this->m_width, this->m_height,
hMemDC, this->m_width * this->m_state, 0, this->m_width, this->m_height, blendFunc);

SelectObject(hMemDC, hOldBitmap);
DeleteDC(hMemDC);
}

void CImgButton::OnPaint(HDC hdc, HDC hMemDC)
{
if(this->m_hBitmap == NULL)
return;

HGDIOBJ hOldBitmap = SelectObject(hMemDC, this->m_hBitmap);

BLENDFUNCTION blendFunc;
blendFunc.BlendOp = AC_SRC_OVER;
blendFunc.BlendFlags = 0;
blendFunc.SourceConstantAlpha = 255; //整体的不透明度
blendFunc.AlphaFormat = AC_SRC_ALPHA;
AlphaBlend(hdc, this->m_left, this->m_top, this->m_width, this->m_height,
hMemDC, this->m_width * this->m_state, 0, this->m_width, this->m_height, blendFunc);

SelectObject(hMemDC, hOldBitmap);
}

　　　　注意，这个类我们主要需要做的工作如下，处理以下消息：WM_PAINT, WM_LBUTTONDOWN / WM_LBUTTONDBLCLK, WM_MOUSEMOVE, WM_LBUTTONUP,  WM_MOUSELEAVE。需要说明的是以下几点：

　　　　（A）关于 WM_MOUSELEAVE 消息。

　　　　该消息在鼠标离开窗口时发送给窗口，我们需要处理这个消息主要是基于鼠标移动时间的“离散性”。即鼠标事件有以下特点，当鼠标移动的速度很快时，相邻的鼠标移动消息的跨距就会比较大。通常我们是用鼠标移动消息去更新按钮的状态的，如果按钮正处于热点跟踪的悬浮状态时，当鼠标快速离开时，很可能无法恢复成正常状态（因为未能收到后续鼠标移动消息），因此我们需要处理鼠标离开的消息。在这个消息里我们主要是把悬浮状态的按钮复原成正常状态。

　　　　另外必须注意的是，处于效率考虑，系统默认不会给窗口发送该消息。因此我们必须用 TrackMouseEvent 函数请求系统为我们发送该消息，且该函数是一次性的，即消息收到一次以后，TrackMouseEvent 就会失效。所以我们需要在鼠标移动事件中重复调用该函数。

　　　　（B）关于 WM_LBUTTONDBLCLK 消息。

　　　　这是鼠标双击事件，当鼠标以很快频率在对话框窗口上双击时，窗口过程就会收到这个消息（因为窗口类中含有 CS_DBLCLK 样式）。这样可能和点击按钮的预期不符（用户希望的是连续快速的点击按钮），即我们不希望系统把快速点击转换成双击事件。考虑双击事件的消息顺序是：按下，抬起，双击，抬起。因此我们在这里只要把双击消息等效的看着鼠标按下事件处理即可。

　　　　（C）按钮在按下时的追踪（m_bIsTracking）

　　　　在上面的类中有这样一个成员变量：m_bIsTracking。这个变量是干什么用的呢，我需要更多的解释以下。观察 windows 操作系统的按钮的交互方式可知，用户在按钮上按下鼠标并保持按下状态，这时不要放开鼠标并移动鼠标时，按钮的外观就会根据鼠标是否停留在按钮上而发生变化。如果用户在按钮以外抬起鼠标，按钮事件不会触发。如果在按钮之内抬起鼠标，就会触发按钮事件。注意，这是 windows 系统中按钮的用户交互的一个小细节（我在之前写的文章中提到过），这样做的主要好处是给用户提供了一种“撤销点击按钮事件”的选择，即按下按钮以后如果不希望点击按钮，则把鼠标从按钮上滑开再放开鼠标按键即可。

　　　　注意，我们通常说的热点跟踪通常是指鼠标在没有按下时进行移动。这时对话框上所有按钮都会对鼠标移动进行外观反馈，我把这种情况（普通热点跟踪）称为当前没有需要跟踪外观反馈的对象。如果鼠标在某个按钮上按下然后保持，这时该按钮就成为一个被跟踪外观反馈的对象，这时只有该对象会对鼠标移动进行外观上的响应，所有其他非跟踪对象一律不对鼠标移动做任何反馈。因此，这是该按钮的 m_bIsTracking 变量就会为 TRUE，表示该按钮是一个被跟踪反馈的对象（鼠标按下时期），该对象应该是具有排他性的，即鼠标按下时，任何时刻至多只有一个按钮被跟踪。这里的 Tracking 专指鼠标按下时期的跟踪对象。同时这个变量也有另一个含义，即表示鼠标按下时是否在该按钮内部按下，如果该变量为 TRUE，则表示鼠标一定是在该按钮上按下的。如果是这样，则只要鼠标抬起时仍然处于按钮内部，即触发按钮事件。

　　　　有了以上代码以后，我们把它加入已有项目就会很方便了。但是我们依然需要在窗口过程中做一些手工工作。主要有以下步骤：

　　　　（1）把ImgButton代码添加到项目。

　　　　（2）用图像处理软件制作一个预先应用了Alpha通道的位图资源，添加到项目中。

　　　　（2）按照如下方式修改窗口过程（假设我们添加一个放大按钮到对话框上）：

wndproc

#include <windowsx.h> //for GET_X_LPARAM

BOOL WINAPI MyWndProc(HWND hDlg, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
static CImgButton *pBtnZoomIn;
static TRACKMOUSEEVENT tme;

switch(wMsg)
{
case WM_INITDIALOG:
{
//Direct UI （ImgButton）
tme.cbSize = sizeof(TRACKMOUSEEVENT);
tme.dwFlags = TME_LEAVE; //我们需要WM_LEAVE;
tme.hwndTrack = hDlg;

pBtnZoomIn = new CImgButton();
pBtnZoomIn->SetParentWnd(hDlg);
pBtnZoomIn->SetButtonID(IDC_BT_ZOOMIN);
pBtnZoomIn->SetBounds(100, 20, 24, 24);
pBtnZoomIn->SetBitmap(hInst, MAKEINTRESOURCE(IDB_ZOOMIN));
}
return TRUE;

case WM_COMMAND:
{
WORD ctlid = LOWORD(wParam);
switch(ctlid)
{
case IDC_BT_ZOOMIN: //放大
{
//在这里处理按钮事件
}
return TRUE;
}
}
break;

case WM_PAINT:
{
PAINTSTRUCT ps;
HDC hdc, hMemDC;
hdc = BeginPaint(hDlg, &ps);
hMemDC = CreateCompatibleDC(hdc);
pBtnZoomIn->OnPaint(hdc, hMemDC);
DeleteDC(hMemDC);
EndPaint(hDlg, &ps);
}
return TRUE;

case WM_LBUTTONDBLCLK:
case WM_LBUTTONDOWN:
{
int x = GET_X_LPARAM(lParam);
int y = GET_Y_LPARAM(lParam);
pBtnZoomIn->OnMouseDown(x, y);
}
return TRUE;

case WM_LBUTTONUP:
{
int x = GET_X_LPARAM(lParam);
int y = GET_Y_LPARAM(lParam);
pBtnZoomIn->OnMouseUp(x, y);
}
return TRUE;

case WM_MOUSEMOVE:
{
int x = GET_X_LPARAM(lParam);
int y = GET_Y_LPARAM(lParam);
pBtnZoomIn->OnMouseMove(x, y);
TrackMouseEvent(&tme);
}
return TRUE;

case WM_MOUSELEAVE:
{
pBtnZoomIn->OnMouseLeave();
}
return TRUE;

case WM_DESTROY:
{
delete pBtnZoomIn;
}
return TRUE;
}
return FALSE;
}

　　　　在上面的使用过程中，主要是初始化工作，即设置按钮的坐标位置，图片资源。以及按钮的ID（相当于普通控件的ID，通过这个数字，向所在窗口发送 WM_COMMAND 消息）。在WM_PAINT消息中，我主动创建了一个内存DC，目的是当有多个这样的 ImageButton 时，可以重复使用该内存DC，而不必每次都再次创建。

　　　　当修改窗口过程时，原窗口过程中没有列出的消息可以简单的添加到窗口过程里，而有的消息可能在窗口过程中已经列出，这就需要和已有代码进行合并。这里可能需要一些和现有代码逻辑的配合，但总体来讲这个融合过程依然是比较容易的。

　　　　通过以上步骤，我们就用 DirectUI 方式实现了标准四态按钮。以上代码原理并不复杂，这里再提供一个很小的DEMO程序：

　　　　http://files.cnblogs.com/hoodlum1980/ImgButtonDemo.rar

　　　　【补充--by hoodlum1980；on 2011年5月15日】

　　　　上面的代码中仅仅是一个比较简单的演示，后续过程中我又在代码中增加了对 Toggle Button（行为类似CheckBox），ShowWindow， EnableWindow 等方法的支持，增加了从 PNG 文件加载按钮图片的支持，增加了 ApplyAlpha 方法（这样就不必对图片资源预先应用alpha通道，只要是 32 bpp的图片即可）。

　　　　改进后的 CImgButton 代码和使用说明请从下面下载：

　　　　http://files.cnblogs.com/hoodlum1980/CImgButton.rar

补充下：在现有代码中存在的一个瑕疵。在CImgButton类的 OnLButtonUp 函数里，应该使用 PostMessage 而不是 SendMessage。（因为SendMessage的处理中如果用编码方式改变了按钮状态，SendMessage 因为必须处理结束才能返回，这可能导致按钮的视图不能得到正确的更新）。用PostMessage时，由于处理 posted message 的时机晚于 OnLButtonUp，因此按钮的外观可以在随后的消息处理中得到正确更新。
----
这段话说得有点绕，由于改动很小，所以用评论补充，源文件就暂时先不更新了。