演练:使用按钮在文档中的文本框中显示文本

本演练演示如何在Microsoft Office Word 的文档级自定义中使用按钮和文本框。

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

本演练阐释了以下任务:

  • 在设计时将控件添加到文档级项目中的 Word 文档。

  • 单击按钮时填充文本框。

    注释

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

先决条件

你需要满足以下条件才能完成本演练:

创建项目

第一步是创建 Word 文档项目。

创建新项目

  1. 创建名为 “我的 Word 按钮”的 Word 文档项目。 在向导中,选择“ 创建新文档”。

    有关详细信息,请参阅 如何:在 Visual Studio 中创建 Office 项目

    Visual Studio 将在设计器中打开新的 Word 文档,并将 “我的 Word 按钮” 项目添加到 解决方案资源管理器

向 Word 文档添加控件

用户界面控件由 Word 文档上的按钮和文本框组成。

添加按钮和文本框

  1. 验证文档是否在 Visual Studio 设计器中打开。

  2. 工具箱“常见控件”选项卡中,将控件TextBox拖动到文档中。

    注释

    在 Word 中,控件默认内嵌于文本中。 可以通过更改 Word 中“选项”对话框的“编辑”选项卡上的默认值来修改控件和形状对象插入的方式。

  3. “视图 ”菜单上,选择“ 属性”窗口

  4. 在“属性”窗口下拉列表框中查找 TextBox1,并将文本框的 Name 属性更改为 displayText

  5. 按钮 控件拖到文档中并更改以下属性。

    资产 价值
    名称 insertText
    文字 插入文本

    现在,可以编写将在单击按钮时运行的代码。

单击按钮时填充文本框

每次用户选择该按钮时, Hello World! 都会添加到文本框中。

单击按钮时写入文本框

  1. 解决方案资源管理器中,右键单击 ThisDocument,然后选择快捷菜单上的 “查看代码 ”。

  2. 将以下代码添加到 Click 按钮的事件处理程序。

    private void insertText_Click(object sender, EventArgs e)
    {
        this.displayText.Text += "Hello World!";
    }
    
  3. 在 C# 中,必须将按钮的事件处理程序添加到事件 Startup 。 有关创建事件处理程序的信息,请参阅 如何:在 Office 项目中创建事件处理程序

    this.insertText.Click += new EventHandler(insertText_Click);
    

测试应用程序

现在,你可以测试文档,以确保选择按钮时文本框中会显示消息 Hello World!

要测试您的文档

  1. F5 运行项目。

  2. 选择按钮。

  3. 确认 Hello World! 显示在文本框中。

后续步骤

本演练演示了在 Word 文档中使用按钮和文本框的基础知识。 下面是一些可能接下来执行的任务: