C# 给Word文档添加内容控件

- 日理万妓 2024-02-17 17:33 49阅读 0赞

在MSWord中，我们可以通过内容控件来向word文档中插入预先定义好的模块，指定模块的内容格式（如图片、日期、列表或格式化的文本等），从而创建一个结构化的word文档。下面就来看看如何使用C\#给word文档添加组合框、文本、图片、日期选取器及下拉列表等内容控件（这里我借助了一个word组件[Spire.Doc][]）。

**添加组合框内容控件**

组合框用于显示用户可以选择的项目列表。和下拉列表不同的是组合框允许用户编辑或添加项。

//给段落添加一个内容控件并指定它的SDTtype为Combo Box
    StructureDocumentTagInline sd = new StructureDocumentTagInline(document);
    paragraph.ChildObjects.Add(sd);
    sd.SDTProperties.SDTType = SdtType.ComboBox;
     
    //创建一个Combo Box, 添加选项并把它赋值给内容控件
    SdtComboBox cb = new SdtComboBox();
    cb.ListItems.Add(new SdtListItem("Cat"));
    cb.ListItems.Add(new SdtListItem("Dog"));
    sd.SDTProperties.ControlProperties = cb;
     
    //设置显示文本
    TextRange rt = new TextRange(document);
    rt.Text = cb.ListItems[0].DisplayText;
    sd.SDTContent.ChildObjects.Add(rt);

![Center][]

**添加文本内容控件**

纯文本控件包含文本，但不能包含其他项，例如表格、图片或其他内容控件。此外，纯文本控件中的所有文本都具有相同的格式。

添加文本内容控件的步骤和添加组合框内容控件类似，核心代码如下：

paragraph = section.AddParagraph();
    sd = new StructureDocumentTagInline(document);
    paragraph.ChildObjects.Add(sd);
    sd.SDTProperties.SDTType = SdtType.Text;
    SdtText text = new SdtText(true);
    text.IsMultiline = true;
    sd.SDTProperties.ControlProperties = text;
    rt = new TextRange(document);
    rt.Text = "Text";
    sd.SDTContent.ChildObjects.Add(rt);

![Center 1][]

**添加图片内容控件**

图片控件用于显示图像。我们可以在设计时或运行时指定图像，用户也可以单击此控件以选择要插入文档中的图像。

核心代码：

paragraph = section.AddParagraph();
    sd = new StructureDocumentTagInline(document);
    paragraph.ChildObjects.Add(sd);
    sd.SDTProperties.SDTType = SdtType.Picture;
    DocPicture pic = new DocPicture(document){ Width = 10, Height = 10 };
    pic.LoadImage(Image.FromFile("C:\\Icon.jpg"));
    sd.SDTContent.ChildObjects.Add(pic);

![Center 2][]

**添加日期选取器内容控件**

日期选取器提供用于选择日期的日历UI。最终用户单击控件中的下拉箭头时，就会显示日历。

核心代码：

paragraph = section.AddParagraph();
    sd = new StructureDocumentTagInline(document);
    paragraph.ChildObjects.Add(sd);
    sd.SDTProperties.SDTType = SdtType.DatePicker;
    SdtDate date = new SdtDate();
    date.CalendarType = CalendarType.Default;
    date.DateFormat = "yyyy.MM.dd";
    date.FullDate = DateTime.Now;
    sd.SDTProperties.ControlProperties = date;
    rt = new TextRange(document);
    rt.Text = "1990.02.08";
    sd.SDTContent.ChildObjects.Add(rt);

![Center 3][]

**添加下拉列表内容控件**

下拉列表显示了用户可以选择的项目列表。和组合框不同的是，下拉列表不允许用户添加或编辑项。

核心代码：

paragraph = section.AddParagraph();
    sd = new StructureDocumentTagInline(document);
    paragraph.ChildObjects.Add(sd);
    sd.SDTProperties.SDTType = SdtType.DropDownList;
    SdtDropDownList sddl = new SdtDropDownList();
    sddl.ListItems.Add(newSdtListItem("Harry"));
    sddl.ListItems.Add(newSdtListItem("Jerry"));
    sd.SDTProperties.ControlProperties = sddl;
    rt = new TextRange(document);
    rt.Text = sddl.ListItems[0].DisplayText;
    sd.SDTContent.ChildObjects.Add(rt);

![Center 4][]

**全部代码：**

using System;
    using System.Drawing;
    using Spire.Doc;
    using Spire.Doc.Documents;
    using Spire.Doc.Fields;
     
    namespace Insert_content_control_in_word_document
    {
        class Program
        {
            static void Main(string[] args)
            {
               //创建一个新的Word文档
               Document document = newDocument();
               Section section = document.AddSection();
               Paragraph paragraph = section.AddParagraph();
     
               //添加组合框内容控件
               StructureDocumentTagInline sd = new StructureDocumentTagInline(document);
               paragraph.ChildObjects.Add(sd);
               sd.SDTProperties.SDTType = SdtType.ComboBox;
               SdtComboBox cb = newSdtComboBox();
               cb.ListItems.Add(new SdtListItem("Cat"));
               cb.ListItems.Add(new SdtListItem("Dog"));
               sd.SDTProperties.ControlProperties = cb;
               TextRange rt = newTextRange(document);
               rt.Text = cb.ListItems[0].DisplayText;
               sd.SDTContent.ChildObjects.Add(rt);
     
               //添加文本内容控件
               paragraph = section.AddParagraph();
               sd= new StructureDocumentTagInline(document);
               paragraph.ChildObjects.Add(sd);
               sd.SDTProperties.SDTType = SdtType.Text;
               SdtText text = newSdtText(true);
               text.IsMultiline = true;
               sd.SDTProperties.ControlProperties = text;
               rt= new TextRange(document);
               rt.Text = "Text";
               sd.SDTContent.ChildObjects.Add(rt);
     
               //添加图片内容控件
               paragraph = section.AddParagraph();
               sd= new StructureDocumentTagInline(document);
               paragraph.ChildObjects.Add(sd);
               sd.SDTProperties.SDTType = SdtType.Picture;
               DocPicture pic = newDocPicture(document) { Width = 10, Height =10 };
               pic.LoadImage(Image.FromFile("C:\\Icon.jpg"));
               sd.SDTContent.ChildObjects.Add(pic);
     
               //添加日期选取器内容控件
               paragraph = section.AddParagraph();
               sd= new StructureDocumentTagInline(document);
               paragraph.ChildObjects.Add(sd);
               sd.SDTProperties.SDTType = SdtType.DatePicker;
               SdtDate date = newSdtDate();
               date.CalendarType = CalendarType.Default;
               date.DateFormat = "yyyy.MM.dd";
               date.FullDate = DateTime.Now;
               sd.SDTProperties.ControlProperties = date;
               rt= new TextRange(document);
               rt.Text = "1990.02.08";
               sd.SDTContent.ChildObjects.Add(rt);
     
               //添加下拉列表内容控件
               paragraph = section.AddParagraph();
               sd= new StructureDocumentTagInline(document);
               paragraph.ChildObjects.Add(sd);
               sd.SDTProperties.SDTType = SdtType.DropDownList;
               SdtDropDownList sddl = newSdtDropDownList();
               sddl.ListItems.Add(new SdtListItem("Harry"));
               sddl.ListItems.Add(new SdtListItem("Jerry"));
               sd.SDTProperties.ControlProperties = sddl;
               rt= new TextRange(document);
               rt.Text = sddl.ListItems[0].DisplayText;
               sd.SDTContent.ChildObjects.Add(rt);
     
               //保存并重启文件
               string resultfile = "sample.docx";
               document.SaveToFile(resultfile, FileFormat.Docx);
               System.Diagnostics.Process.Start(resultfile);
               
            }
        }
    }

[Spire.Doc]: http://www.e-iceblue.com/Introduce/word-for-net-introduce.html
[Center]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/2fc77c371d994c96b4023e4a97fef150.png
[Center 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/b70ff1731ce44fefb5a23919b6aba7f2.png
[Center 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/7ce0b06427914bde81b30eaa683ad1c9.png
[Center 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/5614564dd223413d8b461c3bfaec050e.png
[Center 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/cacc2e82d33c43cd9e40f49fa083c34d.png