通过

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

  • 项目

重要

从 Office 2024 开始，Microsoft Word 中的“操作”功能已被移除。 此功能仅在具有以下 Office 版本的 Microsoft Word 中可用：

  • Microsoft 365
  • Office LTSC Professional Plus 2021
  • Microsoft Office LTSC 标准版 2021
  • Office Professional Plus 2016,2019
  • Office Standard 2016,2019

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

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

注释

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

创建用户控件

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

创建用户控件

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

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

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

    注释

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

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

    注释

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

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

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

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

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

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

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

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

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

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

    private HelloControl hello = new HelloControl();

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

    this.ActionsPane.Controls.Add(hello);

相关内容