演练：使用 CheckBox 控件更改文档格式设置
更新：2007 年 11 月
适用于 |
|---|
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型
Microsoft Office 版本
有关更多信息，请参见按应用程序和项目类型提供的功能。 |
本演练演示在 Microsoft Office Word 的文档级自定义项中，如何使用 Windows 窗体控件来更改文本格式。
本演练阐释以下任务：
设计时在文档级项目中向文档添加文本和控件。
选中选项时设置文本的格式。
若要查看完整示例，请参见 Word 控件示例。
.gif "说明") 说明： |
|---|
对于在以下说明中使用的某些 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。
默认情况下，Visual Studio Tools for Office 随列出的 Visual Studio 版本一起安装。若要检查它是否已安装，请参见安装 Visual Studio Tools for Office。
创建项目
第一步是创建 Word 文档项目。
创建新项目
创建一个 Word 文档项目，并将其命名为“我的 Word 格式设置”。在向导中，选择“创建新文档”。
有关更多信息，请参见如何：创建 Visual Studio Tools for Office 项目。
Visual Studio 将在设计器中打开新的 Word 文档，并将“我的 Word 格式设置”项目添加到“解决方案资源管理器”中。
将文本和控件添加到 Word 文档中
对于此演练，要在 Word 文档中添加三个复选框，并在 Bookmark 控件中添加一些文本。这些复选框将向用户呈现用于设置文本格式的选项。
添加三个复选框
验证文档是否已在 Visual Studio 设计器中打开。
从“工具箱”的“公共控件”选项卡中，将第一个 CheckBox 控件拖到文档中。
在“属性”窗口中，更改下列属性。
属性
值
Name
applyBoldFont
Text
Bold
按“Enter”将插入点移至第一个复选框下方。
将第二个复选框添加到文档中 ApplyBoldFont 复选框的下方，并更改以下属性。
属性
值
Name
applyItalicFont
Text
Italic
按“Enter”将插入点移至第二个复选框的下方。
将第三个复选框添加到文档中 ApplyItalicFont 复选框的下方，并更改以下属性。
属性
值
Name
applyUnderlineFont
Text
Underline
添加文本和书签控件
将插入点移至复选框控件的下方，并键入以下文本：
单击一个复选框以更改此文本的格式设置。
从“工具箱”的“Word 控件”选项卡中，将 Bookmark 控件拖动到文档中。
将出现“添加书签控件”对话框。
选择已添加到文档中的文本，然后单击“确定”。
Bookmark 控件“Bookmark1”被添加到文档中的选定文本中。
在“属性”窗口中，将“(Name)”属性更改为 fontText。
接下来，编写在选中或清除复选框时用于设置文本格式的代码。
选中或清除复选框时设置文本的格式
当用户选择格式设置选项时，将更改文档中文本的格式。
选中复选框时更改格式设置
右击“解决方案资源管理器”中的 ThisDocument，再单击快捷菜单上的“查看代码”。
（仅适用于 C#）将下列常量添加到 ThisDocument 类。
const int WordTrue = -1; const int WordFalse = 0;将以下代码添加到 applyBoldFont 复选框的 Click 事件处理程序中。
Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyBoldFont.Click Me.fontText.Bold = Me.applyBoldFont.Checked End Subprivate void applyBoldFont_Click(object sender, System.EventArgs e) { if (this.applyBoldFont.Checked == true) { this.fontText.Bold = WordTrue; } else { this.fontText.Bold = WordFalse; } }将以下代码添加到 applyItalicFont 复选框的 Click 事件处理程序中。
Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyItalicFont.Click Me.fontText.Italic = Me.applyItalicFont.Checked End Subprivate void applyItalicFont_Click(object sender, System.EventArgs e) { if (this.applyItalicFont.Checked == true) { this.fontText.Italic = WordTrue; } else { this.fontText.Italic = WordFalse; } }将以下代码添加到 applyUnderlineFont 复选框的 Click 事件处理程序中。
Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyUnderlineFont.Click If Me.applyUnderlineFont.Checked Then Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle Else Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone End If End Subprivate void applyUnderlineFont_Click(object sender, System.EventArgs e) { if (this.applyUnderlineFont.Checked == true) { this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle; } else { this.fontText.Underline = Word.WdUnderline.wdUnderlineNone; } }在 C# 中，必须将文本框的事件处理程序添加到 Startup 事件。有关如何创建事件处理程序的信息，请参见如何：使用 Visual Studio Tools for Office 创建事件处理程序。
this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click); this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click); this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
测试应用程序
现在，可以对文档进行测试，以验证选择或清除复选框时文本的格式设置是否正确。
测试文档
按 F5 运行项目。
选择或清除复选框。
确认文本的格式设置正确。
后续步骤
本演练演示在 Word 文档中使用复选框以及以编程方式更改文本格式设置的基本操作。下一步可能要执行以下几项任务：
使用按钮填充文本框。有关更多信息，请参见演练：使用按钮在文档的文本框中显示文本。
使用单选按钮选择图表样式。有关更多信息，请参见演练：使用单选按钮更新文档中的图表。