通过

演练：使用 CheckBox 控件更改文档格式

  • 项目

本演练演示如何在文档级自定义中使用Windows 窗体控件，Microsoft 办公室 Word 更改文本格式。

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

本演练阐释了以下任务：

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

  • 选择某个选项时设置文本的格式。

    若要查看结果为已完成的示例，请参阅办公室开发示例和演练中的 Word 控件示例。

    注意

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

先决条件

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

创建项目

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

创建新项目

  1. 创建名为 “我的 Word 格式”的 Word 文档项目。 在向导中，选择“ 创建新文档”。

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

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

向 Word 文档添加文本和控件

在本演练中，将控件中的Bookmark三个检查框和一些文本添加到 Word 文档中。 检查框将为用户提供设置文本格式的选项。

添加三个检查框

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

  2. 从工具箱的“常见控件”选项卡中，将第一个CheckBox控件拖动到文档中。

  3. 在 “属性” 窗口中，更改下列属性。

    属性 值
    Name applyBoldFont
    文本 加粗

  4. 按 Enter 将插入点移到第一个检查框下方。

  5. 将第二个检查框添加到检查框下方ApplyBoldFont的文档，并更改以下属性。

    属性 值
    Name applyItalicFont
    文本 斜体

  6. 按 Enter 将插入点移到第二个检查框下方。

  7. 将第三个检查框添加到检查框下方ApplyItalicFont的文档，并更改以下属性。

    属性 值
    Name applyUnderlineFont
    文本 下划线

添加文本和书签控件

  1. 在检查框控件下方移动插入点并键入以下文本：

    单击检查框可更改此文本的格式。

  2. 在工具箱的“Word 控件”选项卡中，将Bookmark控件拖动到文档中。

    此时会显示“添加书签控件”对话框。

  3. 选择添加到文档的文本，然后单击“ 确定”。

    Bookmark名为 Bookmark1 的控件将添加到文档中的选定文本中。

  4. 在“属性”窗口中，将 （Name） 属性的值更改为 fontText。

    接下来，编写代码以在检查框检查或清除时设置文本格式。

检查或清除检查框时设置文本格式

当用户选择格式选项时，更改文档中文本的格式。

选中检查框时更改格式

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

  2. 仅对于 C#，请将以下常量添加到 ThisDocument 类。

    const int WordTrue = -1;
const int WordFalse = 0;

  3. 将以下代码添加到Click检查框的applyBoldFont事件处理程序。

    private void applyBoldFont_Click(object sender, System.EventArgs e)
{
    if (this.applyBoldFont.Checked == true)
    {
        this.fontText.Bold = WordTrue;
    }
    else
    {
        this.fontText.Bold = WordFalse;
    }
}

  4. 将以下代码添加到Click检查框的applyItalicFont事件处理程序。

    private void applyItalicFont_Click(object sender, System.EventArgs e)
{
    if (this.applyItalicFont.Checked == true)
    {
        this.fontText.Italic = WordTrue;
    }
    else
    {
        this.fontText.Italic = WordFalse;
    }
}

  5. 将以下代码添加到Click检查框的applyUnderlineFont事件处理程序。

    private 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;
    }
}

  6. 在 C# 中，必须将文本框的事件处理程序添加到 Startup 事件。 有关如何创建事件处理程序的信息，请参阅如何：在办公室项目中创建事件处理程序。

    this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);

测试应用程序

现在可以测试文档，以验证选择或清除检查框时文本的格式是否正确。

测试文档

  1. 按 F5 运行项目。

  2. 选择或清除检查框。

  3. 确认文本的格式正确。

后续步骤

本演练演示了在 Word 文档中使用检查框和以编程方式更改文本格式的基础知识。 以下是接下来可能要执行的一些任务：

  • 使用按钮填充文本框。 有关详细信息，请参阅 演练：使用按钮在文档中的文本框中显示文本。

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

相关内容