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

项目
08/12/2011

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

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

提示

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

链接到视频有关相关视频演示，请参见 How Do I: Use WPF Controls Inside an Excel Actions Pane?（如何实现：在 Excel 操作窗格中使用 WPF 控件？）。

创建用户控件

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

创建用户控件

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

提示

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

提示

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

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

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.Sheet1.Range("A1").Value2 = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.Sheet1.Range["A1", System.Type.Missing].Value2 = "Hello World!";
}

在 C# 中，必须为 Button 创建事件处理程序。可以将此代码放在 HelloControl 构造函数中。有关创建事件处理程序的更多信息，请参见如何：在 Office 项目中创建事件处理程序。
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

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

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

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

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