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

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

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

本演练阐释了以下任务:

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

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

    注意

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

先决条件

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

创建项目

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

创建新项目

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

    有关详细信息,请参阅“如何:在 Visual Studio 中创建办公室项目。

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

向 Word 文档添加控件

用户界面控件包含一个按钮和一个 Word 文档上的文本框。

添加一个按钮和一个文本框

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

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

    注意

    在 Word 中,默认情况下控件将按照文本进行删除。 可以通过更改 Word 中“选项”对话框的“编辑”选项卡上的默认值来修改控件和形状对象插入的方式。

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

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

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

    属性
    Name insertText
    文本 插入文本

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

单击按钮时填充文本框

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

在单击按钮时写入文本框

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

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

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

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

测试应用程序

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

测试文档

  1. F5 运行项目。

  2. 选择 按钮。

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

后续步骤

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

  • 使用组合框来更改格式设置。 有关详细信息,请参阅 演练:使用 CheckBox 控件更改文档格式。

  • 使用单选按钮以选择图表样式。