//========================================================================
//TITLE:
// MiniUtilityFramework(十):CButton和BUTTON
//AUTHOR:
// norains
//DATE:
// Wednesday 26-March-2009
//Environment:
// VISUAL STUDIO 2005 + WINDOWS CE 5.0
//========================================================================
如果说别的控件可能不一定用上,但对于CButton来说,基本上每个程序都可能存在其身影。想想看,程序你想点击后退出,通用做法是啥?加个按钮,然后在该按钮按下的时候处理退出信息。由此可见,CButton可是控件中必不可少的一个成员。只是,重要归重要,但实际上却一点都不复杂。
我们先来看看头文件声明:
和其它控件一样,很多函数我们完全可以无视。和别的控件不同,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