外接程序的设计要素

在设计所有的外接程序时，不管它们的功能如何，都要求参考本主题里讨论的项目。在开始外接程序工程时，要选择 Visual Basic 提供的外接程序模板，该模板提供了一个包含本主题所列的所有项目的代码的工程。在本主题里将描述该模板。

所有用 Visual Basic 创建的外接程序要求如下：

• 根对象   在扩展模型中，最顶端的对象或根对象是 VBE 对象。VBE 代表 Visual Basic 环境（VB 环境），所有的扩展性对象和集合都以它为宿主，它有许多属性、方法和事件用以显露它的功能。

  详细信息   关于使用 VBE 对象的信息请参阅本章中“Visual Basic 实例变量”。

• lDTExtensibility 接口   名为 IDTExtensibility 的接口提供了对扩展模型中必要事件的快速访问。这些接口方法包含在外接程序中的类模块里。要显露这些接口方法，请在类模型的 Declaration 部分里使用 Implements 语句。语法为：

  Implements IDTExtensibility

  IDTExtensibility 接口包含四个处理外接程序事件的方法：

  • OnConnection
    
    
  • OnDisconnection
    
    
  • OnStartupComplete
    
    
  • OnAddInsUpdate

  对编程者来说，虽然这些是IDTExtensibility 接口中的方法，但它们的行为很象事件，当事件发生时触发。

  IDTExtensibility 接口加快了这四个基本过程的创建，同时消除了由参数表的入口错误或其它过程的语法错误导致的外接程序的问题。

  当在类模块的代码窗口里单击“对象”下拉框时，可以看见 IDTExtensibility。当选择 IDTExtensibility 之后，四个必需的外接程序事件过程就会出现在“过程”下拉框里。只要单击每个过程的名字，就可以把它添加到类模块中。

  因为外接程序要求接口的所有成员都得实现，所以类模块中必须包含全部四个过程。类模块中还可以添加所有需要的其它过程，然而，外接程序最少具有上述四个必需过程才能工作。

  注意   重要的警告：四个过程中的每一个必须至少包含一行代码，例如一条语句、过程调用、注释等等。如果过程是空的话，它会被编译器删掉。如果实在没有代码可往这些过程里加的话，就插入注释。

  详细信息   在第四章“连接和显露外接程序”中的“连接或断开外接程序”一节也介绍外接程序事件。本章的“事件的响应”一节，介绍其它事件。

• Visual Basic 实例变量 扩展模型中的每一个集合和对象都需要变量来存储和引用 Visual Basic 的当前实例。实例是 Visual Basic 当前会话期的动态标识变量。因为在任一给定的时间内运行的 Visual Basic IDE 可能有不止一个的会话期，每个会话期的实例变量之间会有差异。

  要在模块或类模块的声明部分声明 Visual Basic 实例变量，可以输入：

  '把 VBInst 的当前实例变量设置为 Visual Basic。
  Global gVBInst As VBIDE.VBE

详细信息   第一章“外接程序概述”中的“创建基本的外接程序”引导逐步地创建一个简单的外接程序，同时提供在这里提出的项目的简要说明。

外接程序模板

Visual Basic 的外接程序模板包含了所有外接程序所需的基本且必要的代码。为了用外接程序模板创建新的外接程序工程，在“新建工程”对话框中选择“外接程序” 。此模块包含的要素：

• 基本模块，它声明了全局变量，例如 Visual Basic 实例变量。
  
  
• 类模块，带有预创建的 IDTExtensibility 接口过程。
  
  
• 外接程序设计器。

模板还包含其它一些有用的特性：

• CommandBar 事件处理程序
  
  
• 基本的错误处理代码
  
  
• 访问作为标准工具栏上按钮的外接程序所用的代码。

外接程序模板是外接程序工程非常好的起点。