-
AddIn And Automation Development In VB.NET 2003 (2)
这几天牟足了力气写,快写完了。今天Boss说下周一开始授课。Faint马上又开始做ppt。晚上回家又堵车。不过现在终于清静下来了。今天帖的是关于Add-in控制DTE菜单、按钮的部分。不多,也比较简单。
这里下载 https://files.cnblogs.com/farrio/02.rar
我试试把内容帖上来。不知道效果如何。
AddIn编程的好处就是我们可以使用自动化对象模型,在我们不必知道.NET内部的实现机制的前提下操纵.NET IDE的控件,完成一些既存功能。在这部分,我们将按照不同的对象单独介绍各种自动化对象模型的使用方法。
需要注意的是,我们所有的DTE模型都是从EnvDTE里面得到的,这也就是为什么前面我们说EnvDTE是我们AddIn编程的基础。此后的部分,如果没有特别指明,那么相关的对象都是在EnvDTE命名空间下的。而为了方便起见,我们将按照文章的层次在我们先前的AddIn工程下面建立相应的文件夹、文件和类。而从Connect.vb文件调用这些类的代码就不再明确说明。
DTE使用的菜单是标准的Office系列菜单,这和我们使用Windows.Forms.MenuItem菜单是不一样的。Office系列的菜单实际上和工具条上面的按钮是同一个类,但是有所不同的是,顶级菜单使用的是PopupCommandBar,而其他的菜单都是使用的普通的CommandBarButton。
首先我们声明我们需要的所有菜单项目,包括一个顶级菜单项“MyAddIn Command”;下属的三个子菜单“Tool Window”、“Source Code”和“Others”。那么下面的声明是必须的。
Private m_cpopMenu As Microsoft.Office.Core.CommandBarPopup
Private WithEvents m_miToolWnd As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_miSourceCode As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_miOthers As Microsoft.Office.Core.CommandBarButton
现在我们的声明部分已经结束,我们需要实例化这些菜单。在写入这些代码的时候可能已经发现,这些菜单的类型并不是类,而是接口。接口意味着我们不能简单地通过New方法实例化这些对象。所幸的是,DTE已经为我们预留好了接口,让我们可以方便的实例化自己的菜单。
在DTE上面添加主菜单项目,通过DTE.CommandBars.ActiveMenuBar.Controls.Add这个方法就可以简单地实现了。Add方法主要使用第一个参数Type,这个参数确定了这个要添加的项目类型。这里我们只能选择msoControlPopup这种类型。随后我们通过设置Caption属性设置显示在DTE顶级菜单上面的名字。Add的返回值赋给顶级菜单的变量,这样我们就通过这种方法实例化了定义菜单。
'Init main menu in DTE
m_cpopMenu = m_DTE.CommandBars.ActiveMenuBar.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlPopup)
m_cpopMenu.Caption = "MyAddIn Command"
上面的代码就是实例化顶级菜单,这里m_DTE是从Connect.vb里面传递进来的EnvDTE实例。
实例化子菜单项目主要通过顶级菜单的Microsoft.Office.Core.CommandBarControls.Add方法来实现。与实例化顶级菜单稍有不同,子菜单的实例化参数也是设定了这个菜单的类型,而菜单的名字等等信息要在实例化之后设定。
'Init [Tool WIndow] menu in main menu that had been created
m_miToolWnd = m_cpopMenu.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlButton)
m_miToolWnd.Caption = "Tool Window (&T)" 'Set the display caption
m_miToolWnd.FaceId = 642 'Set the icon of the menu
m_miToolWnd.BeginGroup = False 'Set the divition line up of the menu
上面的代码设定了Action菜单项目,通过代码我们看到,首先我们通过顶级菜单的Controls.Add命令生成它的下一次菜单项,而类型通过参数指定。随后我们分别对子菜单项的Caption、FaceId、BeginGroup进行设定。
Ø Caption属性:设定菜单显示的名字。支持“&”符号的快捷键设定。
Ø FaceId属性:设定菜单左侧显示的图标(如果不设置就没有图标)。这种设置图标的方法不支持用户自己的图标,只能够从Office系统提供的将近2000个图标里面选择相应的ID。这也是最简单的设置图标的办法。
Ø BeginGroup属性:设置这个菜单项的上边是不是要加入一个分割线。在Windows应用程序中,我们使用一个Text属性是减号的菜单来代替分割线,但是Office菜单里面,我们是通过这样的属性才实现分割线的。
同样的方法,我们可以设定其余的两个菜单项目。然后我们将我们的代码填充到我们的AddIn程序中,运行就可以看到我们做成的菜单了。
菜单的目的就是为了响应用户的消息,启动相关的程序。由于我们此前已经将菜单项目设定为可以响应消息的模式,所以我们响应DTE菜单事件的操作和Windows应用程序基本一致。
Private Sub m_miToolWnd_Click(ByVal Ctrl As Microsoft.Office.Core.CommandBarButton, ByRef CancelDefault As Boolean) Handles m_miToolWnd.Click
MsgBox("Tool window menu clicked.")
End Sub
这段代码就是相应ToolWindow菜单的一个Handle函数,为了简单,我们只是进行了一个操作。但是它足以说明问题。同样的,我们可以为每一个菜单项目Handle一个函数,然后写入我们的代码,和普通的Windows应用程序没有任何区别。
与Windows应用程序不同,我们的AddIn程序不是一个独立的程序,也就是说我们可能退出了AddIn程序,但是宿主程序仍然运行。这时候我们在宿主程序里面添加的所用控件和窗口都不会随着我们AddIn程序的退出而被丢弃。所以AddIn很重要的一个设计原则就是需要考虑资源的回收问题。现在的菜单项目就反映这一点。
只是上面的程序,我们在关闭AddIn之后,这个菜单依旧存在于DTE环境里面。而如果我们再次打开AddIn,又会建立一个新的完全一致的菜单项目。这显然不是我们希望看到的。所以我们要做的事情就是在AddIn关闭的时候卸载这个菜单。还记得OnDisconnection函数么,我们就是要在这个函数里面进行所有的卸载操作,当然现在只有卸载菜单的操作。
卸载菜单很简单。通过CommandBarControl.Delete方法就可以实现。
Public Sub Dispose()
m_miToolWnd.Delete()
m_miSourceCode.Delete()
m_miOthers.Delete()
m_cpopMenu.Delete()
End Sub
上面的函数,只要我们在OnDsiconnection函数里面调用了,我们的程序就会自动地在退出的时候卸载这个菜单项目。
前面已经介绍了,在Office控件里面,菜单和工具条没有明确的界限,我们甚至可以说,Office的菜单和工具条是同样的东西,只是表现形式不一样。对于工具条的处理,和处理菜单基本一致。所以下面我们会将重点放在他们不相一致的地方。
与菜单不同,工具条的声明是一个工具条对象和多个工具条按钮对象。这很类似于Windows应用程序的CommandBar控件。
Private m_cmdBar As Microsoft.Office.Core.CommandBar
Private WithEvents m_cmdInsert As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_cmdDelete As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_cmdFormat As Microsoft.Office.Core.CommandBarButton
实例化工具条和按钮,和菜单基本一致,都是使用接口声明的,所以我们只能通过DTE给我们提供的方法得到我们想要的新控件。只是在实例化工具条的时候,我们要通过DTE.CommandBar.Add方法添加。而且参数我们设定的就是这个工具条的名称。
'Init command bar in DTE
m_cmdBar = m_DTE.CommandBars.Add("My AddIn Command")
下面的代码是实例化一个按钮。和菜单不同,按钮的Caption属性就是这个按钮的ToolTip属性。当然如果你的DTE环境设定为“显示按钮图标和文字”或者“只显示按钮文字”的话,这个属性将会显示成按钮上面的文字。
'Init [Insert] menu in command bar that had been created
m_cmdInsert = m_cmdBar.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlButton)
m_cmdInsert.Caption = "Insert" 'Set the display caption
m_cmdInsert.FaceId = 534 'Set the icon of the menu
m_cmdInsert.BeginGroup = False 'Set the divition line up of the menu
由于工具条在DTE环境下可以有很多,而且每个工具条都可以停靠到DTE四周的各个位置,所以和菜单不同,我们还可以设定这个工具条默认的停靠位置。另外工具条控件默认是不会显示的,所以和菜单不同,我们还必须手动设置CommandBar的Visible属性。
'Visible the command bar
m_cmdBar.Visible = True
'Set the command bar position in DTE
m_cmdBar.Position = Microsoft.Office.Core.MsoBarPosition.msoBarTop
上面的代码显示工具条,并且将这个工具条默认停靠到DTE的上方。如果不进行这个操作,工具条将会浮在DTE环境之上。而其他的属性,工具条控件和菜单控件完全一致。
和菜单一样,简单的通过Handle函数就可以响应按钮事件。
Private Sub m_cmdInsert_Click(ByVal Ctrl As Microsoft.Office.Core.CommandBarButton, ByRef CancelDefault As Boolean) Handles m_cmdInsert.Click
MsgBox("This is insert command called from command bar button.")
End Sub
和菜单一样,在AddIn结束的时候,也应该卸载掉建立的工具条和内部的按钮控件。
Public Sub Dispose()
m_cmdInsert.Delete()
m_cmdDelete.Delete()
m_cmdFormat.Delete()
m_cmdBar.Delete()
End Sub
出处:https://www.cnblogs.com/farrio/archive/2005/04/08/134438.html
这里下载 https://files.cnblogs.com/farrio/02.rar
我试试把内容帖上来。不知道效果如何。
第三部分 使用自动化对象模型
AddIn编程的好处就是我们可以使用自动化对象模型,在我们不必知道.NET内部的实现机制的前提下操纵.NET IDE的控件,完成一些既存功能。在这部分,我们将按照不同的对象单独介绍各种自动化对象模型的使用方法。
需要注意的是,我们所有的DTE模型都是从EnvDTE里面得到的,这也就是为什么前面我们说EnvDTE是我们AddIn编程的基础。此后的部分,如果没有特别指明,那么相关的对象都是在EnvDTE命名空间下的。而为了方便起见,我们将按照文章的层次在我们先前的AddIn工程下面建立相应的文件夹、文件和类。而从Connect.vb文件调用这些类的代码就不再明确说明。
第一章 菜单
DTE使用的菜单是标准的Office系列菜单,这和我们使用Windows.Forms.MenuItem菜单是不一样的。Office系列的菜单实际上和工具条上面的按钮是同一个类,但是有所不同的是,顶级菜单使用的是PopupCommandBar,而其他的菜单都是使用的普通的CommandBarButton。
第一节 建立菜单
首先我们声明我们需要的所有菜单项目,包括一个顶级菜单项“MyAddIn Command”;下属的三个子菜单“Tool Window”、“Source Code”和“Others”。那么下面的声明是必须的。
Private m_cpopMenu As Microsoft.Office.Core.CommandBarPopup
Private WithEvents m_miToolWnd As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_miSourceCode As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_miOthers As Microsoft.Office.Core.CommandBarButton
【注意】
Ø 子菜单项需要加入WithEvents关键字,这样这些菜单项才可能得到消息相应,完成我们的选择操作,启动相关的代码。 Ø 操作DTE的菜单或工具条,必须要在工程共加入Office的引用。当然前提是开发的计算机上面已经安装了MS Office™。 |
现在我们的声明部分已经结束,我们需要实例化这些菜单。在写入这些代码的时候可能已经发现,这些菜单的类型并不是类,而是接口。接口意味着我们不能简单地通过New方法实例化这些对象。所幸的是,DTE已经为我们预留好了接口,让我们可以方便的实例化自己的菜单。
在DTE上面添加主菜单项目,通过DTE.CommandBars.ActiveMenuBar.Controls.Add这个方法就可以简单地实现了。Add方法主要使用第一个参数Type,这个参数确定了这个要添加的项目类型。这里我们只能选择msoControlPopup这种类型。随后我们通过设置Caption属性设置显示在DTE顶级菜单上面的名字。Add的返回值赋给顶级菜单的变量,这样我们就通过这种方法实例化了定义菜单。
'Init main menu in DTE
m_cpopMenu = m_DTE.CommandBars.ActiveMenuBar.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlPopup)
m_cpopMenu.Caption = "MyAddIn Command"
上面的代码就是实例化顶级菜单,这里m_DTE是从Connect.vb里面传递进来的EnvDTE实例。
实例化子菜单项目主要通过顶级菜单的Microsoft.Office.Core.CommandBarControls.Add方法来实现。与实例化顶级菜单稍有不同,子菜单的实例化参数也是设定了这个菜单的类型,而菜单的名字等等信息要在实例化之后设定。
'Init [Tool WIndow] menu in main menu that had been created
m_miToolWnd = m_cpopMenu.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlButton)
m_miToolWnd.Caption = "Tool Window (&T)" 'Set the display caption
m_miToolWnd.FaceId = 642 'Set the icon of the menu
m_miToolWnd.BeginGroup = False 'Set the divition line up of the menu
上面的代码设定了Action菜单项目,通过代码我们看到,首先我们通过顶级菜单的Controls.Add命令生成它的下一次菜单项,而类型通过参数指定。随后我们分别对子菜单项的Caption、FaceId、BeginGroup进行设定。
Ø Caption属性:设定菜单显示的名字。支持“&”符号的快捷键设定。
Ø FaceId属性:设定菜单左侧显示的图标(如果不设置就没有图标)。这种设置图标的方法不支持用户自己的图标,只能够从Office系统提供的将近2000个图标里面选择相应的ID。这也是最简单的设置图标的办法。
Ø BeginGroup属性:设置这个菜单项的上边是不是要加入一个分割线。在Windows应用程序中,我们使用一个Text属性是减号的菜单来代替分割线,但是Office菜单里面,我们是通过这样的属性才实现分割线的。
同样的方法,我们可以设定其余的两个菜单项目。然后我们将我们的代码填充到我们的AddIn程序中,运行就可以看到我们做成的菜单了。
【提示】
Ø 不要妄图在MSDN里面检索到关于DTE菜单和工具条的帮助。这些对象是Office所有的。所以如果你需要帮助,参考Office的SDK。 【未知】 Ø 通过AcitveMenuBar.Controls.Add的第四个参数Before可以设置这个顶级菜单项的添加位置,将一个存在的顶级菜单设定为Before参数,那么这个新的菜单应该添加在Before菜单的前面。但是目前我没有设置成功。上面的代码只能将新的菜单添加在DTE所有菜单的最后。 Ø CommandBarButton.ShortcutText可以设定ShortCut的文字,只是一个String类型的属性。也就是说它只能设定显示的内容,不能完成快捷键的设定,设定之后快捷键仍旧无效。目前并不清楚如何设置快捷键。 |
第二节 响应菜单事件
菜单的目的就是为了响应用户的消息,启动相关的程序。由于我们此前已经将菜单项目设定为可以响应消息的模式,所以我们响应DTE菜单事件的操作和Windows应用程序基本一致。
Private Sub m_miToolWnd_Click(ByVal Ctrl As Microsoft.Office.Core.CommandBarButton, ByRef CancelDefault As Boolean) Handles m_miToolWnd.Click
MsgBox("Tool window menu clicked.")
End Sub
这段代码就是相应ToolWindow菜单的一个Handle函数,为了简单,我们只是进行了一个操作。但是它足以说明问题。同样的,我们可以为每一个菜单项目Handle一个函数,然后写入我们的代码,和普通的Windows应用程序没有任何区别。
第三节 卸载菜单
与Windows应用程序不同,我们的AddIn程序不是一个独立的程序,也就是说我们可能退出了AddIn程序,但是宿主程序仍然运行。这时候我们在宿主程序里面添加的所用控件和窗口都不会随着我们AddIn程序的退出而被丢弃。所以AddIn很重要的一个设计原则就是需要考虑资源的回收问题。现在的菜单项目就反映这一点。
只是上面的程序,我们在关闭AddIn之后,这个菜单依旧存在于DTE环境里面。而如果我们再次打开AddIn,又会建立一个新的完全一致的菜单项目。这显然不是我们希望看到的。所以我们要做的事情就是在AddIn关闭的时候卸载这个菜单。还记得OnDisconnection函数么,我们就是要在这个函数里面进行所有的卸载操作,当然现在只有卸载菜单的操作。
卸载菜单很简单。通过CommandBarControl.Delete方法就可以实现。
Public Sub Dispose()
m_miToolWnd.Delete()
m_miSourceCode.Delete()
m_miOthers.Delete()
m_cpopMenu.Delete()
End Sub
上面的函数,只要我们在OnDsiconnection函数里面调用了,我们的程序就会自动地在退出的时候卸载这个菜单项目。
【提示】
Ø 并没有明确的说明,删除父菜单不会自动删除子菜单,但是个人认为使用“从小到大”的原则逐个删除可能更加安全。况且这样逐个删除在效率上并没有比只删除顶级菜单慢。 |
第二章 工具条
前面已经介绍了,在Office控件里面,菜单和工具条没有明确的界限,我们甚至可以说,Office的菜单和工具条是同样的东西,只是表现形式不一样。对于工具条的处理,和处理菜单基本一致。所以下面我们会将重点放在他们不相一致的地方。
第一节 建立工具条和按钮
与菜单不同,工具条的声明是一个工具条对象和多个工具条按钮对象。这很类似于Windows应用程序的CommandBar控件。
Private m_cmdBar As Microsoft.Office.Core.CommandBar
Private WithEvents m_cmdInsert As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_cmdDelete As Microsoft.Office.Core.CommandBarButton
Private WithEvents m_cmdFormat As Microsoft.Office.Core.CommandBarButton
实例化工具条和按钮,和菜单基本一致,都是使用接口声明的,所以我们只能通过DTE给我们提供的方法得到我们想要的新控件。只是在实例化工具条的时候,我们要通过DTE.CommandBar.Add方法添加。而且参数我们设定的就是这个工具条的名称。
'Init command bar in DTE
m_cmdBar = m_DTE.CommandBars.Add("My AddIn Command")
下面的代码是实例化一个按钮。和菜单不同,按钮的Caption属性就是这个按钮的ToolTip属性。当然如果你的DTE环境设定为“显示按钮图标和文字”或者“只显示按钮文字”的话,这个属性将会显示成按钮上面的文字。
'Init [Insert] menu in command bar that had been created
m_cmdInsert = m_cmdBar.Controls.Add(Microsoft.Office.Core.MsoControlType.msoControlButton)
m_cmdInsert.Caption = "Insert" 'Set the display caption
m_cmdInsert.FaceId = 534 'Set the icon of the menu
m_cmdInsert.BeginGroup = False 'Set the divition line up of the menu
由于工具条在DTE环境下可以有很多,而且每个工具条都可以停靠到DTE四周的各个位置,所以和菜单不同,我们还可以设定这个工具条默认的停靠位置。另外工具条控件默认是不会显示的,所以和菜单不同,我们还必须手动设置CommandBar的Visible属性。
'Visible the command bar
m_cmdBar.Visible = True
'Set the command bar position in DTE
m_cmdBar.Position = Microsoft.Office.Core.MsoBarPosition.msoBarTop
上面的代码显示工具条,并且将这个工具条默认停靠到DTE的上方。如果不进行这个操作,工具条将会浮在DTE环境之上。而其他的属性,工具条控件和菜单控件完全一致。
第二节 响应按钮事件
和菜单一样,简单的通过Handle函数就可以响应按钮事件。
Private Sub m_cmdInsert_Click(ByVal Ctrl As Microsoft.Office.Core.CommandBarButton, ByRef CancelDefault As Boolean) Handles m_cmdInsert.Click
MsgBox("This is insert command called from command bar button.")
End Sub
第三节 卸载工具条和按钮
和菜单一样,在AddIn结束的时候,也应该卸载掉建立的工具条和内部的按钮控件。
Public Sub Dispose()
m_cmdInsert.Delete()
m_cmdDelete.Delete()
m_cmdFormat.Delete()
m_cmdBar.Delete()
End Sub
出处:https://www.cnblogs.com/farrio/archive/2005/04/08/134438.html
栏目列表
最新更新
nodejs爬虫
Python正则表达式完全指南
爬取豆瓣Top250图书数据
shp 地图文件批量添加字段
爬虫小试牛刀(爬取学校通知公告)
【python基础】函数-初识函数
【python基础】函数-返回值
HTTP请求:requests模块基础使用必知必会
Python初学者友好丨详解参数传递类型
如何有效管理爬虫流量?
2个场景实例讲解GaussDB(DWS)基表统计信息估
常用的 SQL Server 关键字及其含义
动手分析SQL Server中的事务中使用的锁
openGauss内核分析:SQL by pass & 经典执行
一招教你如何高效批量导入与更新数据
天天写SQL,这些神奇的特性你知道吗?
openGauss内核分析:执行计划生成
[IM002]Navicat ODBC驱动器管理器 未发现数据
初入Sql Server 之 存储过程的简单使用
SQL Server -- 解决存储过程传入参数作为s
关于JS定时器的整理
JS中使用Promise.all控制所有的异步请求都完
js中字符串的方法
import-local执行流程与node模块路径解析流程
检测数据类型的四种方法
js中数组的方法,32种方法
前端操作方法
数据类型
window.localStorage.setItem 和 localStorage.setIte
如何完美解决前端数字计算精度丢失与数