通过

将操作窗格添加到 Word 文档或 Excel 工作簿

  • 项目

若要将操作窗格添加到 Microsoft 办公室 Word 文档或 Microsoft Excel 工作簿，请先创建Windows 窗体用户控件。 然后，将用户控件添加到Controls项目中字段（Word）或ThisWorkbook.ActionsPane字段（Excel）的属性ThisDocument.ActionsPane。

适用于： 本主题中的信息适用于 Excel 和 Word 的文档级项目。 有关详细信息，请参阅办公室应用程序和项目类型提供的功能。

注意

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。 有关详细信息，请参阅个性化设置 Visual Studio IDE。

创建用户控件

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

创建用户控件

  1. 在 Visual Studio 中打开 Word 或 Excel 文档级项目。

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

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

    注意

    也可以向 项目添加用户控件 项。 操作窗格控件和用户控件项生成的类在功能上等效。

  4. 在工具箱的“Windows 窗体”选项卡中，将按钮控件拖到控件上。

    注意

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

  5. 将代码添加到 Click 按钮的事件处理程序。 以下示例演示Microsoft 办公室 Word 文档的代码。

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

  6. 在 C# 中，必须为按钮单击添加事件处理程序。 调用后InitializeComponent，可以将此代码放在构造函数中HelloControl。

    有关如何创建事件处理程序的信息，请参阅如何：在 办公室 项目中创建事件处理程序。

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

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

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

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

  1. 将以下代码作为 ThisDocument 类级声明添加到或 ThisWorkbook 类（请勿将此代码添加到方法）。

    private HelloControl hello = new HelloControl();

  2. 将以下代码添加到 ThisDocument_Startup 类的 ThisDocument 事件处理程序或 ThisWorkbook_Startup 类的 ThisWorkbook 事件处理程序。

    this.ActionsPane.Controls.Add(hello);

相关内容