通过

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

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

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

本演练阐释了以下任务：

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

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

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

    注释

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

先决条件

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

创建项目

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

创建新项目

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

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

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

向 Word 文档添加文本和控件

在本演练中，将控件中的三个 Bookmark 复选框和一些文本添加到 Word 文档中。 复选框将向用户显示用于设置文本格式的选项。

添加三个复选框

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

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

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

    资产 价值
    名称 applyBoldFont
    文字 Bold

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

  5. 在文档中，在ApplyBoldFont复选框下方添加第二个复选框，并更改以下属性。

    资产 价值
    名称 applyItalicFont
    文字 Italic

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

  7. 将一个新的复选框添加到文档中，在ApplyItalicFont复选框的下方，并更改其以下属性。

    资产 价值
    名称 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 事件。 有关如何创建事件处理程序的信息，请参阅 如何：在 Office 项目中创建事件处理程序。

    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 文档中使用复选框和以编程方式更改文本格式的基础知识。 下面是一些可能接下来执行的任务：

相关内容