演练：从操作窗格将文本插入到文档中

更新：2007 年 11 月

此演练演示如何在 Microsoft Office Word 文档中创建操作窗格。操作窗格包含两个控件，用于收集输入并随后将文本发送到文档。

本演练阐释以下任务：

• 在操作窗格控件上使用 Windows 窗体控件来设计界面。

• 打开应用程序时显示操作窗格。

说明：
以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。您安装的 Visual Studio 版本以及使用的设置决定了这些元素。有关更多信息，请参见 Visual Studio 设置。

先决条件

您需要以下组件来完成本演练：

• Visual Studio Tools for Office（Visual Studio 2008 专业版 和 Visual Studio Team System 的可选组件）。

• Microsoft Office Word 2003 或 Microsoft Office Word 2007。

默认情况下，Visual Studio Tools for Office 随列出的 Visual Studio 版本一起安装。若要检查它是否已安装，请参见安装 Visual Studio Tools for Office。

创建项目

第一步是创建 Word 文档项目。

创建新项目

• 创建一个 Word 文档项目，并将其命名为“My Basic Actions Pane”。在向导中，选择“创建新文档”。有关更多信息，请参见如何：创建 Visual Studio Tools for Office 项目。

  Visual Studio 将在设计器中打开新的 Word 文档，并将“My Basic Actions Pane”项目添加到“解决方案资源管理器”中。

向文档中添加文本和书签

操作窗格将向文档中的书签发送文本。若要设计文档，请键入一些文本以创建基本窗体。

向文档中添加文本

• 在 Word 文档中键入以下文本：

  March 21, 2008

  名称

  地址

  这是 Word 中基本操作窗格的示例。

通过将 Bookmark 控件从 Visual Studio 中的“工具箱”拖动到文档中或使用 Word 中的“书签”对话框，可以将该控件添加到文档中。

向文档中添加 Bookmark 控件

1. 从“工具箱”的“Word 控件”选项卡中，将一个 Bookmark 控件拖动到文档中。

   将出现“添加书签控件”对话框。

2. 选择单词“Name”，而不选择段落标记，然后单击“确定”。

   说明：
   段落标记应该在书签之外。如果段落标记在文档中不可见，请单击“工具”菜单，指向“Microsoft Office Word Tools”，然后单击“选项”。单击“视图”选项卡，然后在“选项”对话框的“格式化标记”区域中选择“段落标记”复选框。

3. 在“属性”窗口中，将“Bookmark1”的“Name”属性更改为 showName。

4. 选择单词“Address”，而不选择段落标记。

5. 执行以下步骤之一：

   • 对于 Word 2003：在“插入”菜单上单击“书签”。

   • 对于 Word 2007：在功能区的“插入”选项卡上的“链接”组中，单击“书签”。

6. 在“书签”对话框的“书签名”框中键入 showAddress，然后单击“添加”。

向操作窗格中添加控件

若要设计操作窗格界面，请向项目中添加操作窗格控件，然后向操作窗格控件添加 Windows 窗体控件。

添加操作窗格控件

1. 在“解决方案资源管理器”中选择“My Basic Actions Pane”项目。

2. 在“项目”菜单上单击“添加新项”。

3. 在“添加新项”对话框中单击“操作窗格控件”，并将该控件命名为“InsertTextControl”，然后单击“添加”。

向操作窗格控件添加 Windows 窗体控件

1. 如果操作窗格控件在设计器中不可见，请双击“InsertTextControl”。

2. 从“工具箱”的“公共控件”选项卡中，将“Label”控件拖动到操作窗格控件中。

3. 将 Label 控件的 Text 属性更改为“Name”。

4. 将“Textbox”控件添加到操作窗格控件中，然后更改以下属性。

   属性	值
   Name	getName
   Size	130, 20

5. 将第二个“Label”控件添加到操作窗格控件中，然后将“Text”属性更改为“Address”。

6. 将第二个“Textbox”控件添加到操作窗格控件中，然后更改以下属性。

   属性	值
   Name	getAddress
   Accepts Return	True
   Multiline	True
   Size	130, 40

7. 将“Button”控件添加到操作窗格控件中，然后更改以下属性。

   属性	值
   Name	addText
   Text	Insert

添加用于将文本插入文档的代码

在操作窗格中，编写用于将文本框中的文本插入文档中相应 Bookmark 控件的代码。可以使用 Globals 类通过操作窗格上的控件来访问文档上的控件。有关更多信息，请参见 对 Visual Studio Tools for Office 项目中的对象的全局访问。

将操作窗格中的文本插入文档中的书签

1. 将以下代码添加到“addText”按钮的 Click 事件处理程序。

   Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles addText.Click
   
       If Me.getName.Text <> String.Empty Then
           Globals.ThisDocument.showName.Text = Me.getName.Text
       End If
   
       If Me.getAddress.Text <> String.Empty Then
           Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
       End If
   
       Me.getName.Text = String.Empty
       Me.getAddress.Text = String.Empty
   End Sub
   

   private void addText_Click(object sender, System.EventArgs e)
   {
       if (this.getName.Text != String.Empty) 
       {
           Globals.ThisDocument.showName.Text = this.getName.Text;
       }
   
       if (this.getAddress.Text != String.Empty)
       {
           Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
       }
   
       this.getName.Text = String.Empty;
       this.getAddress.Text = String.Empty;
   }
   

2. 在 C# 中，必须为按钮单击添加一个事件处理程序。可以将此代码放在 InsertTextControl 构造函数中 IntializeComponent 调用的后面。有关创建事件处理程序的信息，请参见如何：使用 Visual Studio Tools for Office 创建事件处理程序。

   public InsertTextControl()
   {
       InitializeComponent();
       this.addText.Click += new EventHandler(addText_Click);
   }
   

添加用于显示操作窗格的代码

若要显示操作窗格，请将您创建的控件添加到控件集合中。

显示操作窗格

1. 在 ThisDocument 类中创建一个新的操作窗格控件实例。

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

2. 将以下代码添加到 ThisDocument 的 Startup 事件处理程序中。

   Me.ActionsPane.Controls.Add(insertText)
   

   this.ActionsPane.Controls.Add(insertText);
   

测试应用程序

对文档进行测试，以验证在打开文档时操作窗格也同时打开，并确保单击相应按钮时将已键入文本框中的文本插入到书签中。

测试文档

1. 按 F5 运行项目。

2. 确认操作窗格可见。

3. 在操作窗格的文本框中键入姓名和地址，然后单击“插入”。

后续步骤

下一步可能要执行以下几项任务：

• 在 Excel 中创建操作窗格。有关更多信息，请参见如何：向 Excel 工作簿添加操作窗格。

• 将数据绑定到操作窗格上的控件。有关更多信息，请参见 演练：将数据绑定到“Word 操作”窗格上的控件。

• 显示和隐藏操作窗格上的控件。有关更多信息，请参见 演练：根据用户上下文更改操作窗格。

请参见

任务

如何：向 Word 文档添加操作窗格

如何：向 Excel 工作簿添加操作窗格

演练：根据用户上下文更改操作窗格

如何：管理操作窗格上的控件布局

概念

操作窗格概述

Bookmark 控件