操作演示：为 PowerPoint 创建你的第一个 VSTO 外接程序

本演练演示如何为 Microsoft Office PowerPoint 创建 VSTO 外接程序。 在这种解决方案中创建的功能可供应用程序本身使用，无论打开哪些演示文稿。 有关详细信息，请参阅 Office 解决方案开发概述（VSTO）。

适用于： 本主题中的信息适用于 PowerPoint 的 VSTO 外接程序项目。 有关详细信息，请参阅 Office 应用程序和项目类型提供的功能。

本演练阐释了以下任务：

• 为 PowerPoint 创建 VSTO 扩展插件项目。

• 编写使用 PowerPoint 对象模型向每个新幻灯片添加文本框的代码。

• 生成并运行项目以对其进行测试。

• 清理项目，使 VSTO 外接程序不再在开发计算机上自动运行。

  注释

  以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。 有关详细信息，请参阅 个性化设置 IDE。

先决条件

你需要满足以下条件才能完成本演练：

• 包含 Microsoft Office 开发人员工具的 Visual Studio 版本。 有关详细信息，请参阅 配置计算机以开发 Office 解决方案。

• PowerPoint

创建项目

创建新项目

1. 启动 Visual Studio。

2. 在“ 文件 ”菜单上，指向“ 新建”，然后单击“ 项目”。

3. 在模板窗格中，展开 Visual C# 或 Visual Basic，然后展开 Office/SharePoint。

4. 在展开的 Office/SharePoint 节点下，选择 Office 加载项 节点。

5. 在项目模板列表中，选择 PowerPoint VSTO 外接程序项目。

6. 在 “名称 ”框中，键入 FirstPowerPointAddIn。

7. 单击 “确定” 。

   Visual Studio 创建 FirstPowerPointAddIn 项目，并在编辑器中打开 ThisAddIn 代码文件。

编写向每个新幻灯片添加文本的代码

接下来，将代码添加到 ThisAddIn 代码文件。 新代码使用 PowerPoint 的对象模型向每个新幻灯片添加文本框。 默认情况下，ThisAddIn 代码文件包含以下生成的代码：

• 类的ThisAddIn部分定义。 此类提供代码的入口点，并提供对 PowerPoint 对象模型的访问权限。 有关详细信息，请参阅 程序 VSTO 外接程序。该 ThisAddIn 类的其余部分在不应修改的隐藏代码文件中定义。

• ThisAddIn_Startup和ThisAddIn_Shutdown事件处理程序。 PowerPoint 加载和卸载 VSTO 外接程序时会调用这些事件处理程序。 使用这些事件处理程序在加载 VSTO 外接程序时初始化 VSTO 外接程序，并在卸载 VSTO 外接程序时清理其使用的资源。 有关详细信息，请参阅 Office 项目中的事件。

向每个新幻灯片添加文本框

1. 在 ThisAddIn 代码文件中，将以下代码添加到 ThisAddIn 类。 此代码为 Application 对象的 Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide 事件定义事件处理程序。

   当用户向活动演示文稿添加新幻灯片时，此事件处理程序会将文本框添加到新幻灯片的顶部，并将一些文本添加到文本框。

   • C#
   • VB

   void Application_PresentationNewSlide(PowerPoint.Slide Sld)
   {
       PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
           Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
       textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
   }
   

2. 如果使用 C#，请将以下代码添加到 ThisAddIn_Startup 事件处理程序。 此代码用于将Application_PresentationNewSlide事件处理程序与Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide事件连接。

   this.Application.PresentationNewSlide += 
       new PowerPoint.EApplication_PresentationNewSlideEventHandler(
       Application_PresentationNewSlide);
   

   若要修改每个新幻灯片，前面的代码示例使用以下对象：

• Application类的ThisAddIn字段。 该 Application 字段返回一个 Application 对象，该对象表示 PowerPoint 的当前实例。

• Sld Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide 事件的事件处理程序的参数。 参数 Sld 是一个 Slide 对象，该对象表示新幻灯片。 有关详细信息，请参阅 PowerPoint 解决方案。

测试项目

生成并运行项目时，请验证文本框是否显示在添加到演示文稿的新幻灯片中。

测试该项目

1. 按 F5 生成并运行项目。

   生成项目时，代码将编译为放入项目的生成输出文件夹中的程序集。 Visual Studio 还创建一组注册表项，使 PowerPoint 能够发现和加载 VSTO 外接程序，并将开发计算机上的安全设置配置为使 VSTO 外接程序能够运行。 有关详细信息，请参阅 生成 Office 解决方案。

2. 在 PowerPoint 中，向活动演示文稿添加新幻灯片。

3. 验证是否已将以下文本添加到幻灯片顶部的新文本框。

   此文本是使用代码添加的。

4. 关闭 PowerPoint。

清理项目

完成项目开发后，请从开发计算机中删除 VSTO 外接程序程序集、注册表项和安全设置。 否则，每次在开发计算机上打开 PowerPoint 时，VSTO 外接程序都会运行。

要清理您的项目

1. 在 Visual Studio 的 “生成 ”菜单上，单击“ 清理解决方案”。

后续步骤

现在，你已为 PowerPoint 创建了一个基本的 VSTO 外接程序，接下来可以详细了解如何从以下主题开发 VSTO 外接程序：

• 可在 PowerPoint 的 VSTO 外接程序中执行的常规编程任务。 有关详细信息，请参阅 程序 VSTO 外接程序。

• 使用 PowerPoint 的对象模型。 有关详细信息，请参阅 PowerPoint 解决方案。

• 例如，通过在功能区添加自定义选项卡或创建自己的自定义任务窗格来定制 PowerPoint 的 UI。 有关详细信息，请参阅 Office UI 自定义。

• 生成和调试 PowerPoint 的 VSTO 外接程序。 有关详细信息，请参阅 生成 Office 解决方案。

• 为 PowerPoint 部署 VSTO 外接程序。 有关详细信息，请参阅 部署 Office 解决方案。

相关内容

• 编程 VSTO 外接程序
• PowerPoint 解决方案
• Office UI 自定义
• 生成 Office 解决方案
• 部署 Office 解决方案
• Office 项目模板概述