DuiEngine2.0 消息响应更新与移植指南

"DUIEngine2.0 移植说明1" DUIEngine2.0 是一个用户界面引擎，主要用于创建图形用户界面。本移植说明主要关注如何将旧版本的DUIEngine更新到新版本2.0，并强调了更新过程中需要注意的关键变化。 在DUIEngine的老版本中，消息响应机制主要依赖于ID，而ID系统在实际使用中可能存在一定的复杂性。DUIEngine2.0对此进行了改进，将系统消息的响应方式从ID系统转变为使用name属性，使得消息处理更加直观和灵活。 1. 消息映射表的变化是这次移植的重要部分。在旧版本中，消息映射表通常如下所示： ```cpp DUI_NOTIFY_MAP(IDC_RICHVIEW_WIN) DUI_NOTIFY_ID_COMMAND(1,OnClose) DUI_NOTIFY_MAP_END() BEGIN_MSG_MAP_EX(CMainDlg) MSG_WM_CLOSE(OnClose) MSG_DUI_NOTIFY(IDC_RICHVIEW_WIN) CHAIN_MSG_MAP_MEMBER((*m_pUiHandler)) CHAIN_MSG_MAP(CDuiHostWnd) REFLECT_NOTIFICATIONS_EX() END_MSG_MAP() ``` 而在新版本中，消息映射表有所简化： ```cpp DUI_NOTIFY_MAP_BEGIN() DUI_NOTIFY_ID_COMMAND(1,OnClose) DUI_NOTIFY_MAP_END() BEGIN_MSG_MAP_EX(CMainDlg) MSG_WM_CLOSE(OnClose) MSG_DUI_NOTIFY() CHAIN_MSG_MAP_MEMBER((*m_pUiHandler)) CHAIN_MSG_MAP(CDuiHostWnd) REFLECT_NOTIFICATIONS_EX() END_MSG_MAP() ``` 请注意红色部分的差异，新版本去除了与ID相关的映射，并且`MSG_DUI_NOTIFY()`宏的参数已去除。 2. 新版本移除了对`res.h`的包含，改为直接包含`winres.h`文件，这可能涉及到资源文件处理方式的调整。 3. 为了适应name属性的引入，DUIEngine2.0新增了几个基于name的消息映射宏，如`DUI_NOTIFY_NAME_HANDLER`和`DUI_NOTIFY_NAME_COMMAND`，这些宏使得开发者可以根据控件的name属性来处理消息，而不是ID。 4. 消息发送机制也发生了变化。旧版本中，消息通常通过`WM_NOTIFY`发送，但新版本定义了一个自定义消息`UM_DUI_NOTIFY = WM_USER + 100`来替代。原因是新版本的消息数据结构不兼容`NMHDR`，而是采用了一个新的结构`DUINMHDR`，它包含消息源窗口的句柄（`hDuiWnd`）和消息代码（`code`）等信息。 在进行DUIEngine2.0的移植时，开发者需要按照上述变化更新代码，同时检查与消息处理、资源文件包含以及消息发送相关的部分。确保正确地使用新的消息映射宏和消息发送机制，以及适配新结构`DUINMHDR`，以保证代码的兼容性和功能的正常运行。