演练：为 Word 创建第一个文档级自定义

admin 2025-08-25 阅读:67 评论:0

本介绍性演练演示了如何创建 Microsoft Office Word 的文档级自定义项。仅在特定文档处于打开状态时，才可提供你在这种解决方案中创建的功能。不能使用文档级自定义项进行应用程序范围的更改，例如在任何文档处于打开状态时显示新...

本介绍性演练演示了如何创建 Microsoft Office Word 的文档级自定义项。仅在特定文档处于打开状态时，才可提供你在这种解决方案中创建的功能。不能使用文档级自定义项进行应用程序范围的更改，例如在任何文档处于打开状态时显示新“功能区”选项卡。

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

本演练阐释了以下任务：

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

在 Visual Studio 中创建新的 Word 文档项目

启动 Visual Studio。

在 “文件” 菜单上，指向 “新建” ，然后单击 “项目” 。

在 “创建新项目 ”对话框中，选择 Word VSTO 文档项目。

备注

还可以通过在“创建新项目”对话框顶部的“搜索”文本框中键入办公室产品的名称来搜索模板。例如，键入 Excel 将显示 Excel 的所有项目模板。还可以通过选择“项目类型”下拉列表中的办公室来筛选模板，以便仅显示办公室的模板列表。有关详细信息，请参阅在 Visual Studio 中创建新项目。

单击“下一步”。

在“配置新项目”对话框的“名称”框中键入 FirstWorkbookCustomization，然后单击“创建”。

从 Visual Studio Tools for 办公室项目向导中选择“创建新文档”，然后单击“确定”。

在设计器中关闭并重新打开文档

如果开发项目时有意或无意关闭了设计器中的文档whatsapp网页版，则可以重新打开它。

若要关闭并重新打开设计器中的文档

通过单击设计器窗口的 “关闭 ”按钮（X）关闭文档。

在解决方案资源管理器中，右键单击 ThisDocument 代码文件，然后单击“视图设计器”。

- 或 -

在解决方案资源管理器中whatsapp网页版登录，双击 ThisDocument 代码文件。

向设计器中的文档添加文本

可以通过修改在设计器中打开的文档来设计自定义的用户界面 (UI)。例如，可以添加文本、表格或 Word 控件。有关如何使用设计器的详细信息，请参阅 Visual Studio 环境中的办公室项目。

使用设计器将文本添加到文档

在已在设计器中打开的文档中键入以下文本。

此文本是使用设计器添加的。

以编程方式向文档添加文本

接下来，将代码添加到 ThisDocument 代码文件。新代码使用 Word 对象模型向文档添加文本的第二个段落。默认情况下，ThisDocument 代码文件包含以下生成的代码：

若要使用代码向文档添加文本的第二个段落

在解决方案资源管理器中，右键单击 ThisDocument，然后单击“查看代码”。

将在 Visual Studio 中打开代码文件。

将 ThisDocument_Startup 事件处理程序替换为以下代码。当打开文档时，此代码会将文本第二个段落添加到文档中。

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub