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对象的设置请参考其后相应章节。