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

项目
08/12/2011

若要向 Microsoft Office Word 文档添加操作窗格，请首先创建一个 Windows 窗体用户控件。然后，将该用户控件添加到项目中 ThisDocument.ActionsPane 字段的 Controls 属性。

**适用于：**本主题中的信息适用于 Word 2007 和 Word 2010 的文档级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

提示

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

创建用户控件

下面的过程说明如何在 Word 项目中创建用户控件。该过程还向用户控件添加一个按钮，单击该按钮时，会向文档中写入文本。

创建用户控件

在 Visual Studio 中打开 Word 文档或模板项目。
在**“项目”菜单上，单击“添加新项”**。
在**“添加新项”对话框中选择“操作窗格控件”，将其命名为“HelloControl”，然后单击“添加”**。

提示

还可以向项目中添加“用户控件”项。 “操作窗格控件”项与“用户控件”项生成的类在功能上等效。
从**“工具箱”的“Windows 窗体”选项卡中，将“按钮”**控件拖到控件上。

提示

如果在设计器中看不到控件，请双击“解决方案资源管理器”中的“HelloControl”。

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

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

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

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

有关如何创建事件处理程序的信息，请参见如何：在 Office 项目中创建事件处理程序。
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

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

若要显示操作窗格，请将用户控件添加到 ThisDocument.ActionsPane 字段的 Controls 属性中。

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

将以下代码作为类级声明添加到 ThisDocument 类中（不要将此代码添加到方法中）。
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
将以下代码添加到 ThisDocument 类的 ThisDocument_Startup 事件处理程序中。
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```