如何：向 Word 文档或 Excel 工作簿添加操作窗格

项目
02/24/2013

若要操作窗格添加到 Microsoft Office Word 文档或 Microsoft Excel 工作簿，首先创建一个 Windows 窗体用户控件。然后，将用户控件添加到 ThisDocument.ActionsPane 字段 (Word) 或 ThisWorkbook.ActionsPane 字段 (Excel 工作表) 的 Controls 属性在项目中。

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

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

创建用户控件

下面的过程在 Word 或 Excel 项目演示如何创建用户控件。它还将一个按钮添加到写入文本。对该文档或工作簿的用户控件，当单击该控件时。

创建用户控件

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

说明

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

说明

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

说明
还可以向项目中添加“用户控件”项。“操作窗格控件”项与“用户控件”项生成的类在功能上等效。

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

将代码添加到按钮的 Click 事件处理程序。Microsoft Office Word 的下面的示例演示代码文档。

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 字段 (Word) 或 ThisWorkbook.ActionsPane 字段 (Excel 工作表) 的 Controls 属性。

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

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