VB.net 2010 视频教程 VB.net 2010 视频教程 python基础视频教程
SQL Server 2008 视频教程 c#入门经典教程 Visual Basic从门到精通视频教程
当前位置:
首页 > temp > C#教程 >
  • 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
  
【注意】
Ø         子菜单项需要加入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

相关教程