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

适用对象
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型 文档级项目 Microsoft Office 版本 Word 2007 Word 2003 有关更多信息，请参见按应用程序和项目类型提供的功能。

“添加新项”对话框包含一个操作窗格控件，此控件是该操作窗格的用户控件；可使用操作窗格控件或使用具有同样效果的用户控件。

有关如何将操作窗格添加到 Microsoft Office Excel 工作簿的信息，请参见如何：向 Excel 工作簿添加操作窗格。

<!--src=[../icons/alert_note.gif]-->说明：
只能在 Word 或 Excel 的文档级自定义项中创建操作窗格。无法在应用程序级外接程序中创建操作窗格。有关更多信息，请参见按应用程序和项目类型提供的功能。

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

创建操作窗格控件

---

<!---->

在文档中创建操作窗格控件并插入文本

1. 在 Visual Studio 中打开 Word 文档或模板项目。

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

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

4. 如果在设计器中看不到操作窗格控件，请双击设计器中的“HelloControl”。

5. 从“工具箱”的“Windows 窗体”选项卡中，将“Button”控件拖到操作窗格控件上。

6. 将下面的代码添加到按钮的 Click 事件处理程序中。

   Visual Basic

   Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles Button1.Click
   
       Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
   End Sub
   

   C#

   private void button1_Click(object sender, System.EventArgs e)
   {
       Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
   }
   

7. 在 C# 中，必须为按钮单击添加一个事件处理程序。可以将这些代码放在 HelloControl 构造函数中 IntializeComponent 调用的后面。

   有关如何创建事件处理程序的信息，请参见如何：使用 Visual Studio Tools for Office 创建事件处理程序。

   C#

   public HelloControl()
   {
       InitializeComponent();
       this.button1.Click += new EventHandler(this.button1_Click);
   }
   

将操作窗格控件添加到操作窗格中

---

<!---->

若要显示操作窗格，请向其中添加控件。下面的示例向 Word 中的操作窗格添加一个操作窗格控件。

将操作窗格控件添加到操作窗格中

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

   Visual Basic

   Dim hello As New HelloControl
   

   C#

   private HelloControl hello = new HelloControl();
   

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

   Visual Basic

   Me.ActionsPane.Controls.Add(hello)
   

   C#

   this.ActionsPane.Controls.Add(hello);