Spire.Doc系列教程（7）：给 Word 文档添加内容控件

本文将介绍如何使用Spire.Doc组件给Word文档添加内容控件。

内容控件简介

内容控件在Word文档中充当着特定内容的容器，不同的内容控件可以指定不同的内容类型（例如日期、图片或文本等）以及能否编辑此内容。我们从Word 2013中选取了以下几种常见的内容控件进行介绍：

添加内容控件

Spire.Doc组件支持用户在Word文档中添加多种内容控件。以下代码将展示如何使用Spire.Doc组件给Word文档添加上述表格中所介绍的内容控件。

//创建一个新的word文档 Document document = new Document();//添加一个section到文档Section section = document.AddSection();//添加一个段落到sectionParagraph paragraph = section.AddParagraph();//添加下拉列表内容控件StructureDocumentTagInline sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.DropDownList;//为控件设置标题和标签sdt.SDTProperties.Alias = "下拉列表";sdt.SDTProperties.Tag = "下拉列表";//添加下拉选项SdtDropDownList sddl = new SdtDropDownList();sddl.ListItems.Add(new SdtListItem("男", "1"));sddl.ListItems.Add(new SdtListItem("女", "2"));sdt.SDTProperties.ControlProperties = sddl;//设置控件显示的初始选项TextRange rt = new TextRange(document);rt.Text = sddl.ListItems[0].DisplayText;sdt.SDTContent.ChildObjects.Add(rt);//添加纯文本内容控件 paragraph = section.AddParagraph();sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.Text;//为控件设置标题和标签sdt.SDTProperties.Alias = "纯文本";sdt.SDTProperties.Tag = "纯文本";//设置显示文本SdtText text = new SdtText(false);text.IsMultiline = true;sdt.SDTProperties.ControlProperties = text;rt = new TextRange(document);rt.Text = "此处只能输入文本";sdt.SDTContent.ChildObjects.Add(rt);//添加格式文本内容控件 paragraph = section.AddParagraph();sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.RichText;//为控件设置标题和标签sdt.SDTProperties.Alias = "格式文本";sdt.SDTProperties.Tag = "格式文本";//设置显示文本SdtText richText = new SdtText(true);richText.IsMultiline = true;sdt.SDTProperties.ControlProperties = richText;rt = new TextRange(document);rt.Text = "输入格式化的文本、表格和图片等";sdt.SDTContent.ChildObjects.Add(rt);//添加日期选取器内容控件 paragraph = section.AddParagraph();sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.DatePicker;//为控件设置标题和标签sdt.SDTProperties.Alias = "日期选取器";sdt.SDTProperties.Tag = "日期选取器";//设置日历模式SdtDate date = new SdtDate();date.CalendarType = CalendarType.Default;date.DateFormat = "yyyy.MM.dd";date.FullDate = DateTime.Now;sdt.SDTProperties.ControlProperties = date;//设置显示日期rt = new TextRange(document);rt.Text = "1990.02.08";sdt.SDTContent.ChildObjects.Add(rt);//添加组合框内容控件 paragraph = section.AddParagraph();sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.ComboBox;//为控件设置标题和标签sdt.SDTProperties.Alias = "组合框";sdt.SDTProperties.Tag = "组合框";//添加选项SdtComboBox cb = new SdtComboBox();cb.ListItems.Add(new SdtListItem("英国", "1"));cb.ListItems.Add(new SdtListItem("日本", "2"));cb.ListItems.Add(new SdtListItem("意大利", "3"));sdt.SDTProperties.ControlProperties = cb;//添加显示文本rt = new TextRange(document);rt.Text = cb.ListItems[0].DisplayText;sdt.SDTContent.ChildObjects.Add(rt);//添加图片内容控件 paragraph = section.AddParagraph();sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.Picture;//为控件设置标题和标签sdt.SDTProperties.Alias = "图片";sdt.SDTProperties.Tag = "图片";//添加图片DocPicture pic = new DocPicture(document) { Width = 10, Height = 10 };pic.LoadImage(Image.FromFile(@"C:UsersAdministratorDesktopYourLogo.png"));sdt.SDTContent.ChildObjects.Add(pic);//保存文档   document.SaveToFile("Controls.docx", FileFormat.Docx);  

来源：慧都