C++ 在 Word 文档中创建可填充表单

Word 允许用户创建可供其他人录入信息的表单。表单可以从多个对象收集数据或反馈，并且能够保持收集到的内容格式一致。以下是在 Word 文档中创建可填充表单可能需要用到的工具：

内容控件：供用户录入信息的表单区域。
表格：用于对齐表单中的文本和表单域，形成表单的边框和单元格等元素。
保护工具：允许用户填充表单域，但不能改变文档的其他内容。

Word 中的内容控件是内容容器，用户可以使用它们来创建结构化文档。结构化文档控制内容在文档中出现的位置。Word 2013 中有10种常见的内容控件，本文主要介绍如何使用 Spire.Doc for C++ 创建以下7种内容控件组成的可填充表单：

内容控件	描述
纯文本内容控件	允许用户输入无格式的文本。
格式文本内容控件	允许用户录入带格式的文本，以及表格、图片、内容控件等其他内容。
图片内容控件	允许用户录入单张图片。
下拉列表内容控件	允许用户从预定义的列表中选择项目。
组合框内容控件	允许用户从预定义的列表中选择项目或自己输入信息。
复选框内容控件	允许用户进行勾选。
日期选取器内容控件	允许用户从日历中选取日期。

安装 Spire.Doc for C++

有两种方法可以将 Spire.Doc for C++ 集成到您的应用程序中。一种方法是通过 NuGet 安装它，另一种方法是从我们的网站下载包并将库复制到您的程序中。通过 NuGet 安装更简单，更推荐使用。您可以通过访问以下链接找到更多详细信息。

如何将 Spire.Doc for C++ 集成到 C++ 程序中

在 Word 文档中创建可填充表单域

Spire.Doc for C++ 提供的 StructureDocumentTagInline 类用于在段落中为 DrawingML、域等内联级结构创建结构化文档标签。此类下的 SDTProperties 和 SDTContent 属性可以设置对应结构化文档标签的属性和内容。以下是在 Word 文档中创建可填充表单的详细操作步骤：

创建 Document 的对象。
使用 Document->AddSection() 方法添加一个节。
使用 Section->AddTable() 方法添加一个表格。
使用 TableCell->AddParagraph() 方法在单元格中添加段落。
创建 StructureDocumentTagInline 的对象，并使用 Paragraph->GetChildObjects()->Add() 方法将其作为子对象添加到段落中。
使用 StructureDocumentTagInline 对象的 SDTProperties 和 SDTContent 属性设置结构化文档标签的属性和内容。结构化文档标签的类型可通过 SDTProperties->SetSDTType() 方法设置。
使用 Document->Protect() 方法设置不允许用户编辑表单域外的内容。
使用 Document->SaveToFile() 方法保存文档。

#include "Spire.Doc.o.h";

using namespace Spire::Doc;
using namespace std;

int main() {

    //创建Document的对象
    Document* doc = new Document();

    //添加一个节
    Section* section = doc->AddSection();

    //添加一个表格
    Table* table = section->AddTable(true);
    table->ResetCells(7, 2);

    //添加文本到第一列的单元格
    Paragraph* paragraph = table->GetRows()->GetItem(0)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"纯文本内容控件");
    paragraph = table->GetRows()->GetItem(1)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"格式文本内容控件");
    paragraph = table->GetRows()->GetItem(2)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"图片内容控件");
    paragraph = table->GetRows()->GetItem(3)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"下拉列表内容控件");
    paragraph = table->GetRows()->GetItem(4)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"复选框内容控件");
    paragraph = table->GetRows()->GetItem(5)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"组合框内容控件");
    paragraph = table->GetRows()->GetItem(6)->GetCells()->GetItem(0)->AddParagraph();
    paragraph->AppendText(L"日期选取器内容控件");

    //添加纯文本内容控件到单元格(0,1)
    paragraph = table->GetRows()->GetItem(0)->GetCells()->GetItem(1)->AddParagraph();
    StructureDocumentTagInline* sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::Text);
    sdt->GetSDTProperties()->SetAlias(L"纯文本");
    sdt->GetSDTProperties()->SetTag(L"纯文本");
    sdt->GetSDTProperties()->SetIsShowingPlaceHolder(true);
    SdtText* text = new SdtText(true);
    text->SetIsMultiline(false);
    sdt->GetSDTProperties()->SetControlProperties(text);
    TextRange* tr = new TextRange(doc);
    tr->SetText(L"单击或点击此处输入文字。");
    sdt->GetSDTContent()->GetChildObjects()->Add(tr);

    //添加格式文本内容控件到单元格(1,1)
    paragraph = table->GetRows()->GetItem(1)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::RichText);
    sdt->GetSDTProperties()->SetAlias(L"格式文本");
    sdt->GetSDTProperties()->SetTag(L"格式文本");
    sdt->GetSDTProperties()->SetIsShowingPlaceHolder(true);
    text = new SdtText(true);
    text->SetIsMultiline(false);
    sdt->GetSDTProperties()->SetControlProperties(text);
    tr = new TextRange(doc);
    tr->SetText(L"单击或点击此处输入文字。");
    sdt->GetSDTContent()->GetChildObjects()->Add(tr);

    //添加图片内容控件到单元格(2,1)
    paragraph = table->GetRows()->GetItem(2)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::Picture);
    sdt->GetSDTProperties()->SetAlias(L"图片");
    sdt->GetSDTProperties()->SetTag(L"图片");
    SdtPicture* sdtPicture = new SdtPicture();
    sdt->GetSDTProperties()->SetControlProperties(sdtPicture);
    DocPicture* pic = new DocPicture(doc);
    pic->LoadImageSpire(L"C:/Workspace.png");
    sdt->GetSDTContent()->GetChildObjects()->Add(pic);

    //添加下拉列表内容控件到单元格(3,1)
    paragraph = table->GetRows()->GetItem(3)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    sdt->GetSDTProperties()->SetSDTType(SdtType::DropDownList);
    sdt->GetSDTProperties()->SetAlias(L"下拉列表");
    sdt->GetSDTProperties()->SetTag(L"下拉列表");
    paragraph->GetChildObjects()->Add(sdt);
    SdtDropDownList* sddl = new SdtDropDownList();
    sddl->GetListItems()->Add(new SdtListItem(L"选择一项。", L"1"));
    sddl->GetListItems()->Add(new SdtListItem(L"项目 2", L"2"));
    sddl->GetListItems()->Add(new SdtListItem(L"项目 3", L"3"));
    sddl->GetListItems()->Add(new SdtListItem(L"项目 4", L"4"));
    sdt->GetSDTProperties()->SetControlProperties(sddl);
    tr = new TextRange(doc);
    tr->SetText(sddl->GetListItems()->GetItem(0)->GetDisplayText());
    sdt->GetSDTContent()->GetChildObjects()->Add(tr);

    //添加两个复选框内容控件到单元格(4,1)
    paragraph = table->GetRows()->GetItem(4)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::CheckBox);
    SdtCheckBox* scb = new SdtCheckBox();
    sdt->GetSDTProperties()->SetControlProperties(scb);
    tr = new TextRange(doc);
    sdt->GetChildObjects()->Add(tr);
    scb->SetChecked(false);
    paragraph->AppendText(L" 选项 1");

    paragraph = table->GetRows()->GetItem(4)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::CheckBox);
    scb = new SdtCheckBox();
    sdt->GetSDTProperties()->SetControlProperties(scb);
    tr = new TextRange(doc);
    sdt->GetChildObjects()->Add(tr);
    scb->SetChecked(false);
    paragraph->AppendText(L" 选项 2");

    //添加组合框内容控件到单元格(5,1)
    paragraph = table->GetRows()->GetItem(5)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::ComboBox);
    sdt->GetSDTProperties()->SetAlias(L"组合框");
    sdt->GetSDTProperties()->SetTag(L"组合框");
    SdtComboBox* cb = new SdtComboBox();
    cb->GetListItems()->Add(new SdtListItem(L"选择一项。"));
    cb->GetListItems()->Add(new SdtListItem(L"项目 2"));
    cb->GetListItems()->Add(new SdtListItem(L"项目 3"));
    sdt->GetSDTProperties()->SetControlProperties(cb);
    tr = new TextRange(doc);
    tr->SetText(cb->GetListItems()->GetItem(0)->GetDisplayText());
    sdt->GetSDTContent()->GetChildObjects()->Add(tr);

    //添加日期选取器内容控件到单元格(6,1)
    paragraph = table->GetRows()->GetItem(6)->GetCells()->GetItem(1)->AddParagraph();
    sdt = new StructureDocumentTagInline(doc);
    paragraph->GetChildObjects()->Add(sdt);
    sdt->GetSDTProperties()->SetSDTType(SdtType::DatePicker);
    sdt->GetSDTProperties()->SetAlias(L"日期选取器");
    sdt->GetSDTProperties()->SetTag(L"日期选取器");
    SdtDate* date = new SdtDate();
    date->SetCalendarType(CalendarType::Default);
    date->SetDateFormatSpire(L"yyyy.MM.dd");
    date->SetFullDate(DateTime::GetNow());
    sdt->GetSDTProperties()->SetControlProperties(date);
    tr = new TextRange(doc);
    tr->SetText(L"单击或点击此处输入日期。");
    sdt->GetSDTContent()->GetChildObjects()->Add(tr);

    //设置仅允许用户编辑表单域
    doc->Protect(ProtectionType::AllowOnlyFormFields, L"password");

    //保存文档
    doc->SaveToFile(L"Output/表单.docx", FileFormat::Docx2013);
    doc->Close();
    delete doc;
}

C++ 在 Word 文档中创建可填充表单

申请临时 License

如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。

返回顶部