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

项目
08/12/2011

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

**适用于：**本主题中的信息适用于 Word 2007 和 Word 2010 的文档级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

本演练阐释了以下任务：

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

提示

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

系统必备

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

Visual Studio 2010 的一个版本，其中包含 Microsoft Office 开发工具。有关更多信息，请参见[将计算机配置为开发 Office 解决方案](bb398242\(v=vs.100\).md)。

Word 2007 或 Word 2010。

创建项目

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

创建新项目

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

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

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

将控件添加到 Word 文档

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

添加按钮和文本框

验证文档是否已在 Visual Studio 设计器中打开。
从**“工具箱”的“公共控件”**选项卡中，将 TextBox 控件拖动到文档中。

提示

在 Word 中，默认情况下放置的控件与文本对齐。通过在 Word 中“选项”对话框的“编辑”选项卡上更改默认值，可以修改控件和形状对象的插入方式。
在**“视图”菜单上，单击“属性窗口”**。
在**“属性”窗口的下拉框中找到“TextBox1”，并将文本框的“Name”**属性更改为 displayText。
将一个**“Button”**控件拖到文档上，并更改以下属性。

Property

值

名称

insertText

Text

插入文本

Property	值
名称	insertText
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 事件添加按钮的事件处理程序。有关创建事件处理程序的信息，请参见如何：在 Office 项目中创建事件处理程序。
```
this.insertText.Click += new EventHandler(insertText_Click);
```

测试应用程序

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

测试文档

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

后续步骤

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

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

请参见

通过