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

项目
09/10/2008

更新：2007 年 11 月

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

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

项目类型

文档级项目

Microsoft Office 版本

Word 2007
Word 2003

有关更多信息，请参见按应用程序和项目类型提供的功能。

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

本演练阐释以下任务：

在文档级项目中，在设计时向 Word 文档中添加控件。
单击按钮时填充文本框。

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

先决条件

您需要以下组件来完成本演练：

Visual Studio Tools for Office（Visual Studio 2008 专业版和 Visual Studio Team System 的可选组件）。
Microsoft Office Word 2003 或 Microsoft Office Word 2007。

创建项目

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

创建新项目

创建一个名为“我的 Word 按钮”的 Word 文档项目。在向导中，选择“创建新文档”。

有关更多信息，请参见如何：创建 Visual Studio Tools for Office 项目。

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

将控件添加到 Word 文档

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

添加按钮和文本框

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

从“工具箱”的“公共控件”选项卡中，将 TextBox 控件拖动到文档中。

说明：
在 Word 中，默认情况下放置的控件与文本对齐。通过在 Word 中“选项”对话框的“编辑”选项卡上更改默认值，可以修改控件和形状对象的插入方式。

在“视图”菜单上单击“属性窗口”。
在“属性”窗口的下拉框中找到“TextBox1”，并将文本框的“Name”属性更改为 displayText。
将一个“Button”控件拖到文档上，并更改以下属性。

属性

值

Name

insertText

Text

Insert Text

属性	值
Name	insertText
Text	Insert Text

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

单击按钮时填充文本框

每次用户单击按钮时，都会将“Hello World!”添加到文本框中。

单击按钮时向文本框写入内容

在“解决方案资源管理器”中右击“ThisDocument”，再单击快捷菜单上的“查看代码”。

将下面的代码添加到按钮的 Click 事件处理程序中。

Private Sub insertText_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles insertText.Click

    Me.displayText.Text += "Hello World!"
End Sub

private void insertText_Click(object sender, EventArgs e)
{
    this.displayText.Text += "Hello World!";
}

在 C# 中，必须向 Startup 事件添加按钮的事件处理程序。有关创建事件处理程序的信息，请参见如何：使用 Visual Studio Tools for Office 创建事件处理程序。
```
this.insertText.Click += new EventHandler(insertText_Click);
```

测试应用程序

现在可以对文档进行测试，以确保单击按钮时“Hello World!”消息会出现在文本框中。

测试文档

按 F5 运行项目。
单击按钮。
确认“Hello World!”出现在文本框中。

后续步骤

此演练演示在 Word 文档中使用按钮和文本框的基本操作。下一步可能要执行以下几项任务：

使用组合框更改格式设置。有关更多信息，请参见演练：使用 CheckBox 控件更改文档格式设置。
使用单选按钮选择图表样式。有关更多信息，请参见演练：使用单选按钮更新文档中的图表。

请参见

通过