TabBars代码解读之——Tabbar栏与其他窗口之间的关系

本文介绍了在Visual Studio集成开发环境(IDE)中,通过窗口子类化技术Hook窗口消息,使TabBars插件融入IDE的方法。阐述了子类化主框架、MDI子框架和文档窗口的目的,还说明了获取关键窗口句柄的技巧,让插件能响应消息调整标签栏。

Google

输入您的搜索字词 提交搜索表单

    集成开发环境中各个窗口的行为都是事先实现的,比如,文档编辑窗口对应着多文档类的视图窗口,负责对用户的输入进行响应,更新窗口的内容,主窗口负责调度各个视图窗口。Visual Studio的集成开发环境(IDE)没有给我们提供任何接口实现在IDE中添加一个窗口,并且这个窗口能够和IDE中其他窗口分享消息的功能,也就是说正常情况下插件无法干涉IDE环境中窗口的正常行为。但是,这并不意味着我们只能老老实实的作些本分工作,因为通过窗口的子类化技术(Subclassing),我们一样可以Hook窗口的消息。Visual Studio的插件是工作在IDE的进程空间的,这就给我们提供了Hook IDE内任何窗口的机会。从理论上讲,我们可以使用自己的窗口消息处理过程代替IDE中各个窗口的标准窗口消息处理过程,完成对特定消息的响应,甚至完全改变某个窗口的行为。著名的VC商业插件软件Visual Assist就是替换了文档编辑的视图窗口,从而使其比默认的文档编辑窗口提供更多的便利功能。
    Visual Studio的IDE环境有很多窗口,我们关心的只有三个(类)窗口,一个是主框架窗口,一个是MDI子框架窗口,一个是文档窗口。TabBars的标签栏其实并不依赖主框架窗口的消息约束自己的行为,子类化主框架窗口主要是为了处理WM_GETTEXT消息。当用户在不同的文档窗口之间切换时,主框架窗口就会相应的改变窗口标题栏上显示的文字,Hook WM_GETTEXT消息可以使Tabbars插件自己创建的窗口能够在第一时间获得这个消息并做出相应的处理。子类化MDI子框架窗口有两个主要目的,一个是截获窗口大小和位置变更的消息以便能够适时的调整标签栏的大小和位置;另一个是向文档窗口报告MDI子框架窗口新的客户区位置,新客户区排除了标签栏窗口占用的位置,如果不处理这个消息,框架窗口会将文档窗口会按照默认的位置摆放,这会遮挡标签栏窗口。子类化文档窗口是为了处理WM_DESTROY消息,以便能够在用户关闭文档窗口时有机会更新标签栏上的按钮。下图是TabBars插件的窗口类关系图:


图1. Tabbars窗口类关系图

    关系图中的核心是CTabManagerWindow类,这个类虽然名为TabManager,但是并不直接管理标签栏,它通过CTabBarsWnd管理标签栏。CTabBarsWnd是一个MFC的CWnd派生类,他的作用有两个,一个是周期的产生定时器事件,驱动TabBars插件完成文件自动保存之类的工作;另一个作用就是作为容器窗口承载一个Table控件。

    子类化窗口的关键是找到窗口的句柄,Visual Studio的内置插件接口没有提供获取这些窗口句柄的方法,TabBars使用了很多小的Trick来达到这个目的,首先是hook主框架窗口,先看下面的代码:

pApp->put_Active(VARIANT_FALSE);
pApp->put_Active(VARIANT_TRUE);
hWnd = ::GetActiveWindow();
while (hWnd  &&  hWnd != hDesktopWnd)
{
hDevStudioWnd = hWnd;
hWnd = ::GetParent(hWnd);
}
g_pDevStudioWnd = new CDevStudioWnd(hDevStudioWnd); //CWnd::FromHandle(hDevStudioWnd);

put_Active是操作IApplication接口的Active属性,确保Visual Studio的IDE窗口是当前活动窗口,紧跟着调用GetActiveWindow获得这个窗口。不过,GetActiveWindow通常得到的是IDE下的活动子窗口,所以通过向上查找父窗口最终可以得到真正的主框架窗口。

    得到主框架窗口之后就可以顺藤摸瓜得到MDI子框架窗口,MDI子框架窗口使用了固定的类名:MDIClient,所以遍历主框架窗口的所有子窗口就可以找到MDI客户区窗口:

char cClassName[256];

hMDIWnd = g_pDevStudioWnd->GetTopWindow()->m_hWnd;
::GetClassName(hMDIWnd, (LPTSTR)cClassName, sizeof(cClassName));
while (strcmp(cClassName, "MDIClient") != 0)
{
  hMDIWnd = ::GetNextWindow(hMDIWnd, GW_HWNDNEXT);
  ASSERT(hMDIWnd);
  GetClassName(hMDIWnd, (LPTSTR)cClassName, sizeof(cClassName));
}


子类化这些关键窗口,使得TabBars插件自己创建的窗口可以hook适当的消息,通过响应这些消息,TabBars插件可以调整标签栏的位置,更新标签栏并通知其他窗口MDI客户区的改变,从而使TabBars窗口能够融入到Visual Studio的集成开发环境(IDE)中。

Visual C++ 6.0的集成开发环境对项目文件的管理功能比前几个版本有了很大的增强,但是对打开文档窗口的管理和普通的MDI编辑软件一样,只能通过窗口菜单切换,使用起来很不方便。2001年的时候我在网上见到了一款名为“WndTab”的VC插件,它提供了一个集成在编辑窗口table标签,每个打开的文档对应一个标签的按钮,通过鼠标点击按钮可以在文件之间快速切换,大大方便了代码查看和编辑,除此之外,这个插件还提供了C++程序文件和头文件互相切换功能(注:2003年的时候“Wndtab”插件还在开发,功能更多,还支持二次插件开发,但同时不稳定的毛病加重了,且占用资源太多,内存太少使用起来很困难)。这个插件一下子就征服了我(sorry,那个时候我不知道VA),通过对“WndTab”的使用,我也发现了很多问题,比如,文件切换只能在同一个目录中进行,当程序文件和头文件分别放在不同的目录中时就不能切换。还有一个很大的问题就是“WndTab”提供了很多并不实用(仅仅是本人的看法,如有雷同,实属荣幸)而且繁琐、容易出错的功能,比如对标签的重组和编号功能,这个功能在频繁地打开和关闭文件时经常令VC的IDE崩溃。好在 “WndTab”的作者公开了源代码,于是我就开始研究“WndTab”的代码,于是便有了借鉴“WndTab”的成功经验,开发一个功能更实用且简单、稳定的插件的想法,于是“TabBars”便在2002年诞生了。 “TabBars”插件借鉴了“WndTab”插件的框架,大刀阔斧地去掉了标签重组和编号功能,简化了table标签的界面布局,使用Button 风格的自画table控件,重新设计了工具图标,界面更加美观。持此之外,TabBars还添加了很多实用的功能,比如自动保存文件,C++程序文件和头文件互相切换支持多目录搜索功能,注释选定的代码块,从注释的代码块中恢复代码,为函数添加格式化函数声明,注释代码时自动添加操作者信息,自动保存编译过程,自动保存文件等等,所有的功能都支持快捷键。“TabBars”坚持开源品质,2002年发布的同时也发布了源代码,当时在网上引起了很大的反响,很多朋友提出了宝贵意见,修改bug,于是便有了很多个版本,我一直根据朋友的意见修改并维护着一个自己的版本,并通过http://www.winmsg.com/cn/orbit.htm发布,随后由于工作的原因有一段时间不能接触网络,新版本“TabBars”的发布也受到了影响,但是对“TabBars”的改进一直没有停止。2003 年,我和Codeproject上的.dan.g.联系,征得他的同意后将“项目代码自动打包”和“OpenZip”两个功能添加到了 “TabBars”(注:请参考codeproject上的文章:Zip-up the source code for your latest CodeProject article),我同时对这两个功能进行了修改,原来的“项目代码自动打包”功能只能将dsp目录中的文件打包,但是考虑到很多软件项目的代码文件和头文件都是分布在不同的目录中,只打包当前目录有些不妥,于是添加了指定整个目录打包的选项。2004年,我又将.dan.g.的“在代码中添加 Visio-like diagrams的功能”集成到“TabBars”中(注:请参考codeproject上的文章:Add and edit diagrams in your code with this 'Visio-like')。这两次修改的版本都没有正式发布,只在朋友们中间小范围测试使用,并不断修改。2005年4月,“TabBars”的测试工作完成,正式定版发布,版本号为:1.0.17.3169,2005年6月,代码整理完成,同时发布源代码。 本文主要介绍TabBars插件的功能和使用方法,关于如何编译、调试“TabBars”源代码代码解读的问题,请参阅“http://blog.youkuaiyun.com/orbit/”上的“TabBars”系列文章。 说了这么多,你一定想知道“TabBars”到底什么样子?有什么功能?如何使用?下面就介绍“TabBars”的功能和使用方法。图(1) 就是“TabBars”集成到VC编辑环境后的界面,上面是一个工具条,下面是用于文件快速切换的table标签: 图1. 集成到VC编辑环境的“TabBars” 一 使用table标签窗口快速切换文件 在一个大的项目中浏览不同文件中的代码是一件痛苦的事情,VC所能够提供的帮助就是工作区中的“Files”窗口和菜单的“窗口”菜单,当项目中的文件很多时使用起来非常不方便。如果能够象属性页窗口那样通过一个Table控件在不同的窗口之间快速切换,就能够大大的提高工作效率。“TabBars”插件就实现了这个功能,“TabBars”插件采用子类化(subclass)技术,通过Hooker过滤工作窗口的消息维护了一个table标签,在新文档窗口创建的时候在table标签上创建对应的标签按钮,文档关闭时删除标签按钮。这样开发人员只需要在标签的按钮上点击鼠标就可以快速切换到这个文件。在标签按钮上点击鼠标右键会弹出属性菜单: 图2. 标签属性菜单 通过菜单的关闭窗口功能可以有选择的关闭窗口,通过系统菜单可以访问Windows的文件系统菜单,关于Windows文件系统菜单将在后面介绍。 用户可以在配置窗口设置标签的显示属性: 图3. TabBars 选项 在“TabBars 选项”窗口可以设置标签的位置,可以在编辑窗口的上面,也可以设置在编辑窗口的下面,满足不同习惯用户的要求。还可以选择是否在标签显示图标,是否支持系统菜单以及新打开窗口的位置,对于系统资源比较有限的用户还可以选择打开窗口的最大限制。 二 C++程序文件和头文件快速切换 对于一个管理良好的软件项目,函数的声明和实现通常是分开放在一对对应的程序文件和头文件中,C++更是推崇这种做法,于是在程序文件和对应的头文件之间切换,查看函数的定义和实现就成了一个频繁的操作,“TabBars”插件的C++程序文件和头文件快速切换功能就是为了方便C/C++程序员而设计的。很多插件都有这个功能,但是“TabBars”有自己的特色,那就是支持多目录搜索,使用户在浏览其它库的代码时也能够得心应手。 要切换到当前打开文件对应的程序文件或头文件,只需点击工具的图标就可以切换到对应的文件,如果文件没有打开“TabBars”会自动打开文件。通过插件配置窗口可以设置切换文件的搜索路径和文件匹配扩展名: 图4. 文件切换选项 “TabBars”最多支持64个搜索目录,根据软件项目的不同可以选择使用其中的部分搜索目录,“TabBars”只从目录前面有X选择标记的目录中搜索对应的文件。用户还可以指定文件搜索时对扩展名的匹配,图(4)中的配置适用于C/C++文件的切换。“TabBars”首先用指定的匹配扩展名在文件所在的目录搜索对应的程序文件或头文件,如果没有找到对应的文件就会依次搜索用户选择的搜索目录。 该功能的默认快捷键是:Ctrl+Shift+S 三 将当前打开的文件所在目录设为工作目录 有时候开发人员需要频繁地打开位于某个目录中的文件,比如浏览某个软件包代码的时候,可是VC集成环境的“当前目录”却在project文件所在的目录,每次打开文件时文件选择对话框都会自动定位到project文件所在的目录,还要手工换到软件包所在目录,非常不方便。“TabBars”提供的这个功能可以把当前打开的文件所在的目录设为“当前目录”,这样再打开这个目录中的文件时VC的文件选择对话框会自动定位到这个目录,省去很多麻烦。单击工具的按钮就可以轻松的改变集成环境的“当前目录”。 四 以文本方式打开资源文件 VC的class wizard在管理资源的时候经常会出错,有时候两个控件被设置为相同的ID,这会导致程序运行过程中存在潜在的错误,另外,有时候开发人员希望几个控件拥有连续的的ID(通常用在一组相同类型的控件消息处理),这就需要手工编辑资源文件。“TabBars”给开发人员提供了不离开集成开发环境就能够以文本方式编辑资源文件的功能。这个功能的使用很简单,首先打开某个资源,资源编辑窗口就成为当前窗口,此时单击工具的按钮就可以以文本的方式打开资源文件。 五 为选定的代码添加C风格的注释 这个功能就不多说了,就是使用一对/**/ 将选择的代码编程C风格的注释,如果用户还设置了“自动添加注释信息”,则会在开始位置添加注释信息。使用方法是首先在编辑窗口选择一块代码,然后单击工具的按钮,代码注释的效果如下图所示: 图5. C风格代码注释效果 该功能的默认快捷键是:Ctrl+Shift+B 六 为选定的代码添加C++风格的注释 嵌套的/**/注释是不允许的,当选择的代码块中已经有/**/注释的代码块时,使用C++风格的注释就是唯一的选择了。使用的方法是首先在编辑窗口选择一块代码,然后单击工具的按钮,代码注释的效果如下图所示: 图6. C++风格代码注释效果 该功能的默认快捷键是:Ctrl+Shift+R 七 从注释代码中恢复代码 这个功能也不用多说了,使用方法是首先在编辑窗口选择一块注释代码,对于C风格的代码块要选择完整的/**/对,然后单击工具的按钮。 该功能的默认快捷键是:Ctrl+Shift+U 八 添加格式化函数说明 这个功能就是在函数前面添加具有一定格式的说明,使用方法是首先选择完整的函数声明,下图所示的就是两种正确的选择: 图7. 选择完整的函数声明 然后单击工具的按钮,在弹出的对话框中输入对函数的说明和参数解释: 图8. 输入函数说明 下图是生成的说明块的效果: 图9. 格式化函数说明的效果 该功能的默认快捷键是:Ctrl+Shift+F 九 添加Visio-like diagrams 在你的代码中添加几个简单的模块关系图是不是很酷?感谢Codeproject上的.dan.g.为我们完成了这个工作。这个功能的使用很简单,首先在编辑窗口内将编辑光标定位到需要插入图表的位置,然后单击工具的按钮,就会弹出diagrams编辑窗口: 图10. diagrams编辑窗口 下图是生成的代码: 图11. 生成的ASCII图表 如果要修改ASCII图表,只需选择完整的ASCII图表代码块,然后单击工具的按钮。 十 VC工程代码自动打包 直接在集成开发环境中将整个项目的源代码打包压缩成zip文件是一个很实用的功能,“TabBars”对此功能进入了深度开发,使其功能更为完善。当你要打包一个项目的代码时,单击工具的按钮就可以了。“TabBars”插件会自动搜索整个工作区的所有项目,然后定位到工作区的根目录,用户也可以根据代码组织的实际情况选择需要打包的代码所在目录,整个界面如图(12)所示: 图12. 打包整个工作区 选择压缩文件的输出位置,单击“确定”按钮就可以了。由于代码所在目录通常还有VC编译生成的临时文件,用户还可以选择打包过程中排除这些文件,在“打包压缩设置”窗口中可以设置文件选择方式: 图13. 打包压缩选项设置窗口 如果选择了“压缩完成后打开文件确认”选项,“TabBars”会在打包完成后自动调用zip文件的关联软件打开生成的压缩包,以确认是否正确生成了压缩文件。 十一 从zip压缩文件中打开VC工程 通常从网上下载的例子代码都是压缩在zip文件中的,查看zip文件中的项目通常要将代码解压缩到临时目录中然后用VC打开项目,“TabBars”提供了不离开VC的集成开发环境就能够查看zip压缩文件中的VC项目的功能。单击工具的按钮,在弹出的文件选择窗口中选择VC项目所在的zip压缩文件,“TabBars”会自动在指定的临时目录中展开压缩文件,然后定位到工作区文件并打开。如果一个zip文件中没有工作区(dsw)文件,“TabBars”会弹出窗口让用户选择具体的项目文件(dsp)。如果zip文件中有多个工作区文件,“TabBars”会弹出如下窗口让用户选择一个工作区: 图14. 选择工作区 用户可以通过图(13)所示的“打包压缩选项设置窗口”设置临时文件存放目录,默认的临时文件存放位置是:C:\unzipped 十二 自动保存文件 “TabBars”提供定时自动保存文件功能。在图(15)所示的设置窗口中可以选择启用或关闭自动保存功能。 图15. 一般设置窗口 十三 自动添加注释信息 “TabBars”提供在注释代码时梓潼添加注释信息的功能,目前的版本支持添加注释人名称和时间戳。可以在图(15)所示的设置窗口中选择自动添加的注释信息。 十四 自动生成工程编译日志 “TabBars”提供生成编译日志的功能,会在dsp文件所在目录生成一个同名的log文件,内部记载项目的编译次数和每次编译的情况,记录编译次数可以为你的软件定版本提供依据。以下时日志文件的部分内容示例: /本日志文件由 "Tabbar Add-in(1.17.3169) For Visual C++ 6.0" 创建 //项目文件:C:\unzipped\CustDlg\CustDlg.dsp //如果文件增长的很大请删除除本节之外的其他信息 [MAIN] nBuildNumber = 49 [Build00000001] sStartTime = 2005-08-18 16:17:53 sCompileUser = orbit nErrors = 0 nWarns = 0 sEndTime = 2005-08-18 16:17:57 [Build00000002] sStartTime = 2005-08-18 16:19:32 sCompileUser = orbit nErrors = 0 nWarns = 0 sEndTime = 2005-08-18 16:19:33 可以在图(15)所示的设置窗口中选择是否记录日志以及日志记录的内容。 十五 在table标签使用Windows系统菜单 在table标签单击鼠标右键会弹出文件属性菜单,如果你在“TabBars选项”窗口中选择“在右键菜单使用系统菜单”选项,则还可以使用Windows的系统菜单,不离开VC的集成开发环境就可以进行常规的文件操作: 图16. 系统菜单示例
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

王晓华-吹泡泡的小猫

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值