Windows-Mobile-和-Wince(Windows-Embedded-CE)-下的-WTL(Windows-Template-Library)-界面(UI)开发

Windows Mobile 和 Wince(Windows Embedded CE) 下的 WTL(Windows Template Library) 界面(UI)开发参考文档 WTL for MFC Programmers使用 WTL 开发， 有一个系列的文章需要重点推荐，这系列文章比较全面的描述了 WTL 开发的各个方面，属于不得不看的好文章，文章的链接如下：WTL for MFC Programmers, Part I - ATL GUI ClassesWTL for MFC Programmers, Part II - WTL GUI Base ClassesWTL for MFC Programmers, Part III - Toolbars and Status BarsWTL for MFC Programmers, Part IV - Dialogs and ControlsWTL for MFC Programmers, Part V - Advanced Dialog UI ClassesWTL for MFC Programmers, Part VI - Hosting ActiveX ControlsWTL for MFC Programmers, Part VII - Splitter WindowsWTL for MFC Programmers, Part VIII - Property Sheets and WizardsWTL for MFC Programmers, Part IX - GDI Classes, Common Dialogs, and Utility ClassesWTL for MFC Programmers, Part X - Implementing a Drag and Drop Source同时有好心的国人 Simon 把文章翻译成中文，链接如下：/wtl/Prologue.htm另外一个国人Dandy把 update 的文章也翻译了，链接如下:/blog/cns!3569FEA80C717FD4!2382.entry我写这篇文章不是全面的介绍 WTL 的界面开发，说实在，我不会比Michael Dunn的 WTL for MFC Programmers写的好，基于不要重复做轮子的原则，要学习 WTL 请看他的 WTL for MFC Programmers。要深入，请直接看源代码。在我自己开发中出现了问题，这个系列文章也找不到答案时，也只能看源代码去解决了。文章主要介绍本人在使用 WTL 进行界面开发是的一些经验。辅助工具 WTL Helper进行 WTL 开发另外一个不可多得的工具是 WTL Helper， WTL Helper 是Sergey Solozhentsev开发的辅助工具，使用 WTL Helper 可以快速的生成 控件映射 (Variables mapping) 和 消息映射 (Message mapping) 的代码。 WTL Helper 的使用可以参考这篇文章WTL Helper。由于 Sergey Solozhentsev 一直没有更新， WTL Helpler 不支持我常用的 Visual Studio 2008，所以使用 VS 2008 不能直接安装原有的 WTL Helper。 下面文章讲述如何在 VS 2008 下使用WTL Helper Installing WTL Helper in VS 2008。一个好心的国人free2000fly把 WTL Helper 升级并放到 SF 去了，可以参考他的文章支持 VS 2008 的 WTL Helper，需要的话请到这里下载/projects/wtlhelper9浅谈 MS 技术下的界面开发非 MS 的世界谈到 MS 技术，需要谈一下开山始祖 MS-DOS,可是本人不是做 MS-DOS 出身的，常常听到中断之类的也不知所云，我十分欣赏在 DOS 下写游戏的人。我做界面开发从 AS400 入手，一个基于 菜单 (Menu) 的操作系统，每次写界面都需要写一个 DSP 文件， 这个文件还是可见即可得，很不错的。 然后转入 UNIX 阵营，使用 Shell 编写菜单界面，简单。到后来使用了Curses 库 和 C 开发，所有界面都是自己使用程序一点点画的，效率很低，但是学了不少东西，还尝试像 MFC 那样封装界面。MFC后来开始做 MFC， 如果在 MFC 下进行 Dialog-based (就是对话框或者FormView) 的界面是基于资源文件的，所谓资源文件说白了就是一个文本文件，例如下面一个Dialog的例子IDD_MOBILERADIO_FORMDIALOG0,0,156,167STYLEDS_SETFONT|DS_FIXEDSYS|WS_CHILD|WS_VISIBLE|WS_CLIPSIBLINGSFONT8,MSShellDlgBEGINCOMBOBOXIDC_COMBO_CITY,38,9,64,30,CBS_DROPDOWN|CBS_SORT|WS_VSCROLL|WS_TABSTOPCOMBOBOXIDC_COMBO_STATION,38,25,64,30,CBS_DROPDOWN|CBS_SORT|WS_VSCROLL|WS_TABSTOPGROUPBOXStatic,IDC_WMP,5,132,145,31CONTROL,IDC_PIC,Static,SS_BITMAP,42,64,15,13LTEXTCity:,IDC_STATIC,19,9,16,8LTEXTStation:,IDC_STATIC,9,26,26,8END例子中描述了一个 ID 为 IDD_MOBILERADIO_FORM 的 Form View，他的风格为DS_SETFONT， DS_FIXEDSYS等等，包含 COMBOBOX， LTEXT等控件。 资源文件就是使用文本描述界面的布局，风格以及属性等信息，程序在运行时根据资源文件的信息，实时生成页面。使用资源文件的一个好处是容易进行全球化 (Globalization) 和地区化 (Localization)，也就是我们所说的英文界面和汉化。对使用资源文件的程序，进行汉化可以只是修改资源文件就可以了，不需要重新编译源代码。WinformWinform 已经把 UI 对象化，所有 UI 元素使用对象的方式进行描述，可以参考 MainForm.Designer.cs 文件，其中 MainForm 为 Form 的类名字，根据具体程序 Form 的类名字也不一样。下面展现 MainForm.Designer.cs 下的一段代码。#regionWindowsFormDesignergeneratedcode/RequiredmethodforDesignersupport-donotmodify/thecontentsofthismethodwiththecodeeditor./privatevoidInitializeComponent()this.connectionText=newSystem.Windows.Forms.TextBox();this.operationText=newSystem.Windows.Forms.TextBox();this.SuspendLayout();/connectionText/this.connectionText.BackColor=System.Drawing.SystemColors.Desktop;this.connectionText.Location=newSystem.Drawing.Point(3,3);this.connectionText.Name=connectionText;this.connectionText.ReadOnly=true;this.connectionText.Size=newSystem.Drawing.Size(261,23);this.connectionText.TabIndex=1;/operationText/this.operationText.BackColor=System.Drawing.SystemColors.Desktop;this.operationText.Location=newSystem.Drawing.Point(3,32);this.operationText.Name=operationText;this.operationText.ReadOnly=true;this.operationText.Size=newSystem.Drawing.Size(261,23);this.operationText.TabIndex=2;/MainForm/this.AutoScaleDimensions=newSystem.Drawing.SizeF(96F,96F);this.AutoScaleMode=System.Windows.Forms.AutoScaleMode.Dpi;this.AutoScroll=true;this.ClientSize=newSystem.Drawing.Size(271,63);this.Controls.Add(this.operationText);this.Controls.Add(this.connectionText);this.Location=newSystem.Drawing.Point(330,80);this.Name=MainForm;this.Text=MainForm;this.ResumeLayout(false);#endregionprivateSystem.Windows.Forms.TextBoxconnectionText;privateSystem.Windows.Forms.TextBoxoperationText;段 #region Windows Form Designer generated code 为 VS winform 自动生成代码， 当我们在 Form 编辑器编辑完 Form 后 VS 会把编辑的 UI 转换成对象。 UI 的布局，属性等信息作为对象的属性保存起来。 因此我们完全可以通过手工编码的方式生成界面， 而不通过 Form 编辑器来完成。 可是 Winform 有一个缺点是位置信息是绝对位置而不是相对位置。ASP.NET WebformWebform 是在 HTML 的基础上，加入 ASP.NET 的服务端控件元素的 UI 呈现过程。 例如下面的一段 ASP.NET 代码：0Vehicles,0Glassesand0Events.Refreshin10Seconds.table，tr 和 td 等等为标准的 HTML 元素，asp:Label 和 asp:Button 为 ASP.NET 的服务端控件。由于借助了 HTML 的方式表现，给 Webform 带来了很多的灵活性， 控件可以以相对位置的方式呈现。 虽然借助了 HTML ，其实 Webform 的本质和Winform一样，最终都是以对象的方式来保存 信息，当ASP.NET 的 Webform 页面第一次被访问时， IIS 会把该 *.aspx 页面翻译成一个 *.aspx.cs 文件然后进行编译。 像上面例子 ButtonRefresh 会生成一个 Button 的对象， ButtonRefresh_Click 变成该对象的一个事件处理 (EventHandler) 函数。WPF(XAML)MS 为了统一 Web 和 Desktop 的 UI 开发， 推出了 XAML。 在 WPF 之前，进行 Winform 开发 UI 的描述是通过对象属性的赋值，没有直观的描述语言。 Webform 可以通过 ASP.NET 服务控件插入 HTML 的方式描述 UI， 可是这种模式不能用于 Winform。 MS 推出 XAML，使用统一的描述语言描述 UI 的布局等信息。OK这是 Desktop 的一个 WPF 应用， 所有元素都可以通过 XAML 自描述，例子里描述了一个窗口包含了一个名字叫做 OK 的按钮，按钮的事件处理函数为 button1_Click。OK这是一个 Web 的 WPF 应用， 同样使用 XAML 来描述， 一个名字叫做 OK 的按钮被包含在一个 Page里面。WTL从上面各种技术看，除了 MFC 以外，其他技术就是都是使用对象的方式来描述 UI。 把 UI 元素映射成各个对象，把布局等信息保存在该对象的属性里，把事件处理函数注册到该对象的事件处理 (EventHandler) 里。 在 OO 的世界， 一切都那么直观明了。 那么 WTL 又是怎样做的呢？ 不幸的告诉大家， WTL 和 MFC 一样也不是使用对象的方式描述 UI 的。 WTL 可以使用资源文件来设计和描述界面。 可是资源文件只是一个文本文件，只能简单的描述布局等信息，程序如何控制这些界面元素呢？ 答案是 对话框数据交换 (DDX, dialog data exchange) 和 消息映射 (MSG_MAP, Message Mapping)。 从使用的角度看， WTL 对 UI 的处理和 MFC 类似，他们都是使用 DDX 和 MSG_MAP 来绑定资源文件和 C+ 代码。DDX 和 MSG_MAP 分别在 WTL for MFC Programmers 的第四和第五部分进行了详细讲述，可以参考这两篇文章。下面我会用一个例子来讲述如何使用 DDX 和 MSG_MAP。DDX - 控件映射 (Variables mapping)DDX 就是把资源的 UI 元素绑定到 C+ 的对象的过程。 在项目中有一个 form view 叫做 IDD_MOBILERADIO_FORM， 描述可以看上面 MFC 中的资源文件， 图如下：图1 现在需要对下拉框 (COMBOBOX) IDC_COMBO_CITY 和 IDC_COMBO_STATION 进行 DDX 和 MSG_MAP 的绑定。 可以使用 WTLHelper 的帮助， 右键 IDD_MOBILERADIO_FORM 选择 WTL Helper - Add DDX entry。图2图3DDX Type 选择 Control handle， Member Type 选择 CComboBox， 那样把 IDC_COMBO_CITY 绑定到 CComboBox 的对象 m_wndCity 上了。 下面为 WTL Helper 在 MobileRadioView.h 生成的代码。classCMobileRadioView:publicCAxDialogImpl,publicCWinDataExchangepublic:CComboBoxm_wndCity;CComboBoxm_wndStation;BEGIN_DDX_MAP(CMobileRadioView)DDX_CONTROL_HANDLE(IDC_COMBO_CITY,m_wndCity)DDX_CONTROL_HANDLE(IDC_COMBO_STATION,m_wndStation)END_DDX_MAP()进行 DDX 的类需要继承 CWinDataExchange类，如果绑定到控件 DDX Type 需要选择 Control handle，不能选择 Control，否则编译出错。如果需要选择 Control 也就是使用 DDX_CONTROL， 那么需要自己封装下拉框的类。 当选择 Control handle 时，WTL Helpler 会使用 DDX_CONTROL_HANDLE 进行绑定。LRESULTCMobileRadioView:OnInitDialog(UINTuMsg,WPARAMwParam,LPARAMlParam,BOOL&bHandled)/TODO:Addyourmessagehandlercodehereand/orcalldefaultDoDataExchange(FALSE);m_wndCity.AddString(_T(Sydeny);m_wndCity.AddString(_T(Melbourne);在 OnInitDialog 函数加入初始化下拉框的代码。 MSG_MAP - 消息映射 (Message mapping)MSG_MAP 就是把 Windows 消息绑定到对象处理函数的映射。 在 Windows 编程的世界，任何都是消息触发。 控件的生成，显示，重画，消失，点击，输入等等都表现为消息事件。 下面讲述如何绑定事件。图4打开 WTL Helper 的 Add handler图5图6双击选择 ComboBox 的 CBN_SELCHANGE 事件，当下拉框选项发生改变的时候会触发这个事件。 在 Handler Use 选择 ID， Identifier 选择下拉框 IDC_COMBO_CITY。 WTL Helper 会增加 COMMAND_HANDLER_EX 映射和新增事件处理函数 OnComboCityCbnSelChange。BEGIN_MSG_MAP(CMobileRadioView)COMMAND_HANDLER_EX(IDC_COMBO_CITY,CBN_SELCHANGE,OnComboCityCbnSelChange)END_MSG_MAP()修改 OnComboCityCbnSelChange 函数，增加处理逻辑。LRESULTCMobileRadioView:OnComboCityCbnSelChange(WORDwNotifyCode,WORDwID,HWNDhWndCtl)CStringstr;intsel=m_wndCity.GetCurSel();m_wndCity.GetLBText(sel,str);m_wndStation.ResetContent();if(str=Sydney)m_wndStation.AddString(_T(2DayFM);m_wndStation.AddString(_T(2UETalkbackRadio);elsem_wndStation.AddString(_T(101.9THEFOX);m_wndStation.AddString(_T(Magic1278);return0;当城市下拉框发生改变的时候，电台下拉框呈现不同的内容。图7查找帮助的方法由于 WTL 没有官方帮助文档，所以很多时候有问题只能查看源代码，同时我发现一个方法也是挺有效的，当发生问题时，可以查找 MFC 的文档，例如 CComboBox 的CBN_SELCHANGE 事件和GetLBText函数，我就是查 MFC 来解决的，CComboBox Class 的 MFC 文档见/en-us/library/12h9x0ch(VS.80).aspx。 通过该文档对 ON_CBN_SELCHANGE 的描述， 程序只能使用 GetLBText 而不能使用 GetWindowText 来取选中的值。由于 WTL 开始为了重新 MFC 的重要功能，所以有