jameshooo的专栏

WLW_BLOGAPI是网上最流行的BLOGAPI模块，用于取代DRUPAL自带的BLOGAPI，使用这个模块，可以方便地使用桌面工具（比如 Windows Live Writer）离线编写博客文章。但在我的使用过程中，我发现了一些BUG和不足，于是尝试以它为基础重新制作一个模块 blogapi_ex，并尽可能修改掉已发现的错误，也添加了自己想要的功能。

REDirectUI 是雨寒工作室推出的 DirectUI 渲染引擎，作为一个尚在完善期的作品，第一次推出并不容易。为了让大家能更直观地了解 REDirectUI 的特性，雨寒工作室特地制作了 DuiBrowser 工具，这个工具是一个 DirectUI 观察器（本来应该取名叫浏览器，但是很容易被误解为WEB浏览器），可以直接输入XML代码，或者拖放XML文件到管理窗口，然后在演示窗口查看渲染效果。随时修改随时看，所以它也是一个很好的代码测试工具。

一个线程委托库的实现源码，最大的优点是实现多线程不再困难，线程同步和管理不再头疼，同时内置了浏览器线程的实现。 线程委托的概念主要是在任意线程中委托其他线程执行代码，例如调用一个API函数，或者调用一个对象的成员函数。 源码使用了C++模板库，内部采用ATL实现。使用时只需关注压缩文件中的Raptor.h文件，这是封装好的类，易于使用。

相对1.02做了两处小改动：<br>1、当对话框打开关闭后再打开，在DEBUG版本下会断言失败，原因在于对话框窗口销毁时没有销毁WebBrowser控件窗口。<br>2、删除了对atlsafe.h的包含引用，这个文件在VC6的ATL3.0版本中是不存在的。<br>3、下载此资源不再需要资源分。

ATL发展到现在，从未提供像MFC中的CDHtmlDialog一样的HTML页面布局且方便开发者使用的窗口基类，虽然也有DHtml Control可供使用，但并不能像MFC那样通过宏映射来方便地让开发者与页面元素之间进行任意的双向交互，尤其是需要响应页面元素事件的时候，ATL/WTL爱好者必须自己编写相应的代码来完成这些工作。基于这个原因，通过理解分析MFC中CDHtmlDialog类的功能和实现行为，这里完全使用ATL一样的实现机制来模仿MFC中实现的功能编写了一个头文件，使ATL爱好者在无需MFC庞大的支持库的情形下实现跟CDHtmlDialog一样的功能，并且扩展了其能力。下载的压缩包中只有一个头文件 atldhtmldlg.h，头文件的开始部分是一段开发者使用示例的注释，以方便开发者容易地上手。这个文件提供了若干个类和模板类，开发者只需关注其中两个模板类：CDHtmlDialogImpl和CMultiPageDHtmlDialogImpl，第一个模板类实现了WEB页面布局的对话框，第二个模板类以第一个类为基础，扩展成了在一个对话框中支持多个页面。使用方式非常简单，从上述两个模板类之一继承实现一个对话框类，然后添加相应的映射宏，实现宏映射中的方法即可构造一个完美、表现能力强、控制方便的对话框窗口，例子代码像下面这样：class CMainDlg : public CDHtmlDialogImpl{ ...... // 实现页面元素事件的处理 // 请注意响应函数原型定义：HRESULT Foo(IHTMLElement*) BEGIN_DHTML_EVENT_MAP(CMainDlg) DHTML_EVENT_ONCLICK(_T("elementid1"), OnClick) DHTML_EVENT_ONMOUSEMOVE(_T("elementid2"), OnMouseMove) DHTML_EVENT_ELEMENT(DISPID_HTMLELEMENTEVENTS_ONMOUSEOVER, _T("elementid"), OnMouseOver) // id为elementid的元素事件响应 DHTML_EVENT_CLASS(DISPID_HTMLELEMENTEVENTS_ONMOUSEOVER, _T("myclass"), OnMouseOver) // class为myclass的元素事件响应 DHTML_EVENT_TAG(DISPID_HTMLELEMENTEVENTS_ONMOUSEOVER, _T("div"), OnMouseOver) // 所有DIV元素的onmouseover事件响应 DHTML_EVENT_AXCONTROL(controlMethodDISPID, _T("objectid"), OnControlMethod) // ActiveX控件事件响应 END_DHTML_EVENT_MAP() // 实现外部DISPATCH方法，能在这里添加任意的方法供页面中的脚本调用 // 调用方式如下：window.external.about(123, "abc") // 请注意响应函数的原型定义：void Foo(VARIANT*,VARIANT*,VARIANT*) // 目前仅仅定义了三个参数，一般也足够使用了。如果脚本实际调用中只提供了2个参数，则第三个指针参数是NULL。以此类推 BEGIN_EXTERNAL_METHOD_MAP(CMainDlg) EXTERNAL_METHOD(_T("about"), OnAbout) END_EXTERNAL_METHOD_MAP() void OnAbout(VARIANT* para1, VARIANT* para2, VARIANT* para3) { // your code is here. } HRESULT OnClick(IHTMLElement *pElement) { // your code is here. return S_OK; } HRESULT OnMouseMove(IHTMLElement *pElement) { // your code is here. return S_OK; } ......}除了上面的例子，还有CMultiPageDHtmlDialogImpl中的一些映射宏，以及还有一些虚函数可供重载。对话框设计好后，调用方法也很简单，例子如下： CMainDlg dlg; dlg.m_nHtmlResID = IDR_YOUR_HTML_RESOURCE_ID; // open your resource or dlg.m_szHtmlResID = _T("C:\\yourname.html"); // open your resource or dlg.m_strCurrentUrl = _T("www.microsoft.com"); // open local html file or external URL dlg.Create(NULL); // or dlg.DoModal(NULL);好了，介绍就到这里，如果有更多疑问，请下载头文件查看源代码以及注释，本次下载的文件版本是 1.02。当前版本的一个缺憾是尚未支持DDX/DDV，原因是ATL并未提供DDX机制，下个版本将完全仿照WTL的方式实现该类的DDX/DDV。另外为了通用性以及减少依赖，代码中完全未使用CString或CAtlString，主要是MFC、ATL、WTL各自提供了自己的CString实现。版权特别声明：本软件源码完全属作者James（胡柏华）自创，作者拥有修改和变更代码特性的权利，任何团体或个人均可以自由下载并免费使用。如用于商业用途，请在所属商业软件的版权声明中加注本声明。使用者使用本源码的过程中产生的任何错误，作者并无义务提供技术支持，由此导致的任何损失，作者概不负责。2007-11-7