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

更新：2007 年 11 月

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

ActionsPane 对象可用于 Visual Studio Tools for Office 项目，但除非向其添加一个 Windows 窗体控件，否则此对象将不可见。

若要向 Microsoft Office Excel 工作簿添加操作窗格，可以先创建一个用户控件，然后将此控件添加到操作窗格中。“添加新项”对话框包含一个操作窗格控件，此控件是该操作窗格的用户控件；可使用此控件或使用具有同样效果的用户控件。

说明：
只能在 Word 或 Excel 的文档级自定义项中创建操作窗格。无法在应用程序级外接程序中创建操作窗格。有关更多信息，请参见按应用程序和项目类型提供的功能。

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

创建操作窗格控件

向项目中添加操作窗格控件

1. 在 Visual Studio 中打开 Excel 工作簿或模板项目。

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

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

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

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

5. 将下面的代码添加到按钮的 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!";
   }
   

6. 在 C# 中，必须为 Button 创建事件处理程序。可以将此代码放在 HelloControl 构造函数中。有关创建事件处理程序的更多信息，请参见 如何：使用 Visual Studio Tools for Office 创建事件处理程序。

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

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

若要显示操作窗格，请向其添加控件。

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

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

   Dim hello As New HelloControl
   

   private HelloControl hello = new HelloControl();
   

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

   Me.ActionsPane.Controls.Add(hello)
   

   this.ActionsPane.Controls.Add(hello);
   

请参见

任务

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

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

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

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

概念

操作窗格概述