MiniUtilityFramework(五)：CUserWnd

//========================================================================
//TITLE:
// MiniUtilityFramework(五)：CUserWnd
//AUTHOR:
// norains
//DATE:
// Tuesday 24-February-2009
//Environment:
// VISUAL STUDIO 2005 + WINDOWS CE 5.0
//========================================================================

CUserWnd的子类是客户能掌控的唯一和MUF交流的途径。也就是说，如果客户需要定义相应的窗口功能，那么唯一的方法就是继派生于CUserWnd类，并且在CDominatorBase子类的CreateWndObj函数中创建。

CUserWnd的函数虽多，但在实际运用中，子类真正需要的却没几个。以SetXXXInfo形式的函数，完全可以视其而不见；所关注的，或是说，可以安全拿来调用的，无非是如下一些函数：

1. virtual void RefreshWindow()

刷新窗口的界面。


2. CXXX* GetXXX(const TSTRING &strName)

获取相应控件对象的指针。strName为控件的名字，该名字定义于配置文件的SECTION段。

例如，获取命为BTN_EXIT的按钮：

CButton *pBtn = GetButton(TEXT("BTN_EXIT"));

配置文件如下：

[BTN_EXIT]
TYPE = BUTTON


3. virtual BOOL HandleCommand(const TSTRING &strName,const TSTRING &strCmd,const TSTRING &strParam)

BUTTON的回调处理函数。

strName为BUTTON的名字，strCmd为按钮的命令，strParam为命令的形参。

配置文件有内容如下：

[BTN_SETTING]
TYPE = BUTTON
COMMAND=CMD_WND
PARAMETER=WND_SETTING

在该回调函数中可以捕获到该BUTTON按下时的通知：

if(strName == TEXT("BTN_SETTING"))
{
RETAILMSG(TRUE,(TEXT("Command:%s,Parameter:%s/r/n"),strCmd.c_str(),strParam.c_str()));

pBtn = GetButton(strName); //获取当前BUTTON的实例
}

如果捕获到BTN_SETTING点击的状态，则会在调试台中输出以下信息：

Command:CMD_WND,Parameter:WND_SETTING

BUTTON对象的设置请参考其后相应章节。


4. virtual BOOL HandleSliderScroll(const TSTRING &strName,int iValue)

SLIDER的回调处理函数。当SLIDER数值变更时，会自动调用该函数。

strName为控件的名称，iValue是当前滑动时的数值。

strName为在配置文件中定义的SECTION值：

[SLD_VOLUME]
TYPE=SLIDER

示范代码如下：

if(strName == TEXT("SLD_VOLUME"))
{
RETAILMSG(TRUE,(TEXT("Value:%d/r/n"),iValue));

pSld = GetSlider(strName); //获取当前SLIDER的实例
}

SLIDER对象的设置请参考其后相应章节。


5. virtual BOOL HandleListClick(const TSTRING &strName,unsigned int uiIndex)

LIST控件的回调处理函数。当LIST的ITEM项被点击时，则会自动调用该函数。

strName为LIST的名称。

strName为在配置文件中定义的SECTION值：

[LST_VOLUME]
TYPE=LIST

示范代码如下：

if(strName == TEXT("LST_VOLUME"))
{
RETAILMSG(TRUE,(TEXT("Value:%d/r/n"),uiIndex));

pLst = GetList(strName); //获取当前LIST的实例
}

LIST对象的设置请参考其后相应章节。