C# 给Word文档添加内容控件
在MS Word中，我们可以通过内容控件来向word文档中插入预先定义好的模块，指定模块的内容格式（如图片、日期、列表或格式化的文本等），从而创建一个结构化的word文档。下面就来看看如何使用C#给word文档添加组合框、文本、图片、日期选取器及下拉列表等内容控件（这里我借助了一个word组件Spire.Doc）。
添加组合框内容控件
组合框用于显示用户可以选择的项目列表。和下拉列表不同的是组合框允许用户编辑或添加项。
//给段落添加一个内容控件并指定它的SDT type为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);
添加文本内容控件
纯文本控件包含文本，但不能包含其他项，例如表格、图片或其他内容控件。此外，纯文本控件中的所有文本都具有相同的格式。
添加文本内容控件的步骤和添加组合框内容控件类似，核心代码如下：
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);
添加图片内容控件
图片控件用于显示图像。我们可以在设计时或运行时指定图像，用户也可以单击此控件以选择要插入文档中的图像。
核心代码：
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);
添加日期选取器内容控件
日期选取器提供用于选择日期的日历 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);
添加下拉列表内容控件
下拉列表显示了用户可以选择的项目列表。和组合框不同的是，下拉列表不允许用户添加或编辑项。
核心代码：
paragraph = section.AddParagraph(); sd = new StructureDocumentTagInline(document); paragraph.ChildObjects.Add(sd); sd.SDTProperties.SDTType = SdtType.DropDownList; SdtDropDownList sddl = new SdtDropDownList(); 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);
全部代码：
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 = new Document(); Section section = document.AddSection(); Paragraph paragraph = section.AddParagraph(); //添加组合框内容控件 StructureDocumentTagInline sd = new StructureDocumentTagInline(document); paragraph.ChildObjects.Add(sd); sd.SDTProperties.SDTType = SdtType.ComboBox; 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); //添加文本内容控件 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); //添加图片内容控件 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); //添加日期选取器内容控件 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); //添加下拉列表内容控件 paragraph = section.AddParagraph(); sd = new StructureDocumentTagInline(document); paragraph.ChildObjects.Add(sd); sd.SDTProperties.SDTType = SdtType.DropDownList; SdtDropDownList sddl = new SdtDropDownList(); 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); } } }
