MiniUtilityFramework(十)：CButton和BUTTON

//========================================================================
//TITLE:
// MiniUtilityFramework(十)：CButton和BUTTON
//AUTHOR:
// norains
//DATE:
// Wednesday 26-March-2009
//Environment:
// VISUAL STUDIO 2005 + WINDOWS CE 5.0
//========================================================================

如果说别的控件可能不一定用上，但对于CButton来说，基本上每个程序都可能存在其身影。想想看，程序你想点击后退出，通用做法是啥？加个按钮，然后在该按钮按下的时候处理退出信息。由此可见，CButton可是控件中必不可少的一个成员。只是，重要归重要，但实际上却一点都不复杂。

我们先来看看头文件声明：

// Button.h: interface for the CButton class. // ////////////////////////////////////////////////////////////////////// #pragma once #include "..//Table//imageTabBase.h" #include "Text.h" namespace Button { enum DisplayStyle { STYLE_AUTO, STYLE_PUSH, STYLE_ENABLE, STYLE_DISABLE }; } class CButton { public: //Before using you must call the function //-------------------------------------------------------------------- //Description: // Set image table object // //------------------------------------------------------------------- void SetImgTab(CImageTabBase &imgTab); public: //-------------------------------------------------------------------- //Description: // Set the text face name // //------------------------------------------------------------------- void SetTextFaceName(const TSTRING &strFaceName); //-------------------------------------------------------------------- //Description: // Set the button position // //------------------------------------------------------------------- void SetPosition(const RECT &rcWnd); //-------------------------------------------------------------------- //Description: // Set the strikeOut // //--------------------------------------------------------------------- void SetTextStrikeOut(BOOL bStrikeOut); //-------------------------------------------------------------------- //Description: // Set the underline // //--------------------------------------------------------------------- void SetTextUnderline(BOOL bUnderline); //-------------------------------------------------------------------- //Description: // Set the italic // //--------------------------------------------------------------------- void SetTextItalic(BOOL bItalic); //-------------------------------------------------------------------- //Description: // Specifies the weight of the font in the range 0 through 1000. For example, //400 is normal and 700 is bold. If this value is zero, a default weight is used. // //--------------------------------------------------------------------- BOOL SetTextWeight(int iWeight); //-------------------------------------------------------------------- //Description: // Set the point size of text // //--------------------------------------------------------------------- void SetTextPointSize(int iPointSize); //-------------------------------------------------------------------- //Description: // Set Format. // //Parameters: // The value you should see the uFormat of DrawText() //-------------------------------------------------------------------- void SetTextFormat(UINT uFormat); //-------------------------------------------------------------------- //Description: // Set the text. If you want to display the text ,you should call the Display() // //-------------------------------------------------------------------- BOOL SetText(const TSTRING &strText); //-------------------------------------------------------------------- //Description: // Set the visible // //Parameters: // bVisible:[in] // TRUE - visible // FALSE - invisible // //-------------------------------------------------------------------- void SetVisible(BOOL bVisible); //-------------------------------------------------------------------- //Description: // Draw the button // //------------------------------------------------------------------- BOOL Draw(HDC hdc, Button::DisplayStyle btnDraw); //-------------------------------------------------------------------- //Description: // Set the button status // //------------------------------------------------------------------- void SetEnable(BOOL bEnable); //-------------------------------------------------------------------- //Description: // The button is enable or not // //------------------------------------------------------------------- BOOL GetEnable(); //-------------------------------------------------------------------- //Description: // Check tapped position in the area.If the button is disable, //it would return FALSE. // //------------------------------------------------------------------- BOOL CheckTap(const POINT &pt); //-------------------------------------------------------------------- //Description: // Set the text color of enable // //------------------------------------------------------------------- void SetTextColorEnable(COLORREF crVal); //-------------------------------------------------------------------- //Description: // Set the text color of disable // //------------------------------------------------------------------- void SetTextColorDisable(COLORREF crVal); //-------------------------------------------------------------------- //Description: // Set the text color of push // //------------------------------------------------------------------- void SetTextColorPush(COLORREF crVal); //-------------------------------------------------------------------- //Description: // Set the image index of enable // //------------------------------------------------------------------- void SetImgIndexEnable(TSTRING strIndex); //-------------------------------------------------------------------- //Description: // Set the image index of disable // //------------------------------------------------------------------- void SetImgIndexDisable(TSTRING strIndex); //-------------------------------------------------------------------- //Description: // Set the image index of push // //------------------------------------------------------------------- void SetImgIndexPush(TSTRING strIndex); //-------------------------------------------------------------------- //Description: // Set the transparent mode // //Parameters: // bTran:[in] // TRUE - Don't draw the transparent color // FALSE - Draw all the color // //------------------------------------------------------------------- void SetTransparent(BOOL bTran); //-------------------------------------------------------------------- //Description: // Get the image position // //------------------------------------------------------------------- RECT GetImgPosition(); public: CButton(); virtual ~CButton(); protected: //-------------------------------------------------------------------- //Description: // Draw the button // //------------------------------------------------------------------- BOOL Draw(HDC hdc, Button::DisplayStyle btnDraw,const RECT &rcWndImg,const RECT &rcText); private: BOOL m_bEnable; RECT m_rcWnd; BOOL m_bTran; BOOL m_bVisible; CText m_Text; TSTRING m_ImgIndexEnable; TSTRING m_ImgIndexDisable; TSTRING m_ImgIndexPush; CImageTabBase *m_pImgTab; COLORREF m_crTxtEnable; COLORREF m_crTxtDisable; COLORREF m_crTxtPush;

和其它控件一样，很多函数我们完全可以无视。和别的控件不同，CButton有一个专门处理点击消息的回调函数：
virtual BOOL HandleCommand(const TSTRING &strName,const TSTRING &strCmd,const TSTRING &strParam);

我们只要在CUserWnd的派生类中重载该函数，就能获取按钮的点击信息，如：

BOOL CWnd::HandleCommand(const TSTRING &strName,const TSTRING &strCmd,const TSTRING &strParam)
{
if(strCmd == Command::CMD_USER)
{
//To do sometingh
}

return CUserWnd::HandleCommand(strName,strCmd,strParam);
}

函数中各形参的意义如下：

strName：控件的名字。即在配置文件中的SECTION段名

strCmd：命令的类别。目前有如下命令可以判断：CMD_USER,CMD_WND,CMD_APP,CMD_EXIT,CMD_VOL_INC,CMD_VOL_DEC,CMD_BKLIGHT_INC,CMD_BKLIGHT_DEC,CMD_LANGUAGE_PRE,CMD_LANGUAGE_NEXT。这些命令的具体含义请参考本文的配置文件这部份。

strParam：命令的参数。

以上三个形参，都是字符串形式。


接下来我们来看看配置文件的可配置段：

TYPE：类型，该VALUE必须为BUTTON

RECT_POS：按钮的位置

IMG_ENABLE：正常状态的图片

IMG_DISABLE：无效状态的图片

IMG_PUSH：按下状态的图片

COMMAND：按钮的命令类型。可选的命令请见本文其后说明。

PARAMETER：命令的参数

TRANSPARENT_MODE：TRUE--不绘制图片的透明色。 FALSE--绘制图片的透明色

除此以外，还有如下字段：POINT_SIZE，WEIGHT，FORMAT，TXT_COLOR_ENABLE，TXT_COLOR_DISABLE，TXT_COLOR_PUSH，STRING，FONT_FACE_NAME。这些字段所代表的意义和CText的配置文件一致。如果需要在按钮显示相应的文字，请参考CText配置文件的用法。

在这里必须要重点说一下COMMAND这个KEY。COMMOND的VALUE是固定的，可选的数值只能为如下其一：

CMD_USER：用户自定义命令。

CMD_WND：窗口切换命令。该命令的PARAMETER必须为配置文件中某一个窗口名。

CMD_APP：执行外部程序。该命令的PARAMETER必须为有效的应用程序的绝对路径。

CMD_EXIT：退出应用程序。

CMD_VOL_INC,CMD_VOL_DEC：音量的增加和减少。

CMD_BKLIGHT_INC,CMD_BKLIGHT_DEC：背光亮度的增加很减少。该命令和底层有关，并不具备移植性。

CMD_LANGUAGE_PRE,CMD_LANGUAGE_NEXT：前一个和后一个语言设置。该命令的有效性和[LANGUAGE]有关。


如果我们想退出程序，借助已经封装好的命令，则配置文件可以简单如此：

[BTN_EXIT]
TYPE=BUTTON
RECT_POS=0,0,10,10
COMMAND=CMD_EXIT
TRANSPARENT_MODE=TRUE

调用外部程序，则可以如下书写：

[BTN_NAVI]
TYPE=BUTTON
RECT_POS=0,0,10,10
COMMAND=CMD_APP
TRANSPARENT_MODE="/NAND/navigation.exe"

类似，切换窗口仅仅是如下定义：

[BTN_NAVI]
TYPE=BUTTON
RECT_POS=0,0,10,10
COMMAND=CMD_WND
TRANSPARENT_MODE=WND_LANGUAGE

该配置文件意思是按下BTN_NAVI这个按钮，则会切换到WND_LANGUAGE窗口。

如上的三个配置样例，主要是为了说明相应的功能，所以没有将相应的图片序号配置。现在给出一个比较完整的，但不带文字的按钮配置文件样例：

[BTN_SECOND_DEC_WND_TIME_SETTING]
TYPE=BUTTON
RECT_POS=352,77,374,99
COMMAND=CMD_USER
PARAMETER=SECOND_DEC
IMG_ENABLE=IMG_FILE_DEC_ENABLE
IMG_PUSH=IMG_FILE_DEC_PUSH
TRANSPARENT_MODE=TRUE