IStructuredDocumentTag

IStructuredDocumentTag interface

接口定义通用数据StructuredDocumentTagStructuredDocumentTagRangeStart.

public interface IStructuredDocumentTag

特性

姓名描述
Appearance { get; set; }获取或设置结构化文档标签的外观。
Color { get; set; }获取或设置结构化文档标签的颜色。
Id { get; }指定一个唯一的只读持久数字 ID特殊和差别待遇
IsMultiSection { get; }如果此实例是范围(多部分)结构化文档标签,则返回 true。
IsShowingPlaceholderText { get; set; }指定此内容是否特殊和差别待遇应解释为包含占位符文本 (与 SDT 中的常规文本内容相反)。
Level { get; }获取此特殊和差别待遇出现在文档树中。
LockContentControl { get; set; }设置为 true 时,此属性将禁止用户删除此特殊和差别待遇.
LockContents { get; set; }设置为 true 时,此属性将禁止用户编辑此内容特殊和差别待遇.
Node { get; }返回实现此接口的 Node 对象。
Placeholder { get; }获取BuildingBlock包含当此 SDT 运行内容为空时应显示的占位符文本, 关联的映射 XML 元素为空,如通过XmlMappingelement 或IsShowingPlaceholderText元素为真。
PlaceholderName { get; set; }获取或设置BuildingBlock包含占位符文本。
SdtType { get; }获取此类型结构化文档标签.
Tag { get; set; }指定与当前 SDT 节点关联的标签。 不能为空。
Title { get; set; }指定与此相关的友好名称特殊和差别待遇 . 不能为空。
WordOpenXML { get; }获取表示节点中包含的 XML 的字符串FlatOpc格式.
XmlMapping { get; }获取一个对象,该对象表示此结构化文档标签到当前文档的自定义 XML 部分中的 XML 数据的映射。

方法

姓名描述
GetChildNodes(NodeType, bool)返回与指定类型匹配的子节点的实时集合。
RemoveSelfOnly()仅删除此 SDT 节点本身,但保留其在文档树中的内容。

例子

展示如何删除结构化文档标签,但保留其中的内容。

Document doc = new Document(MyDir + "Structured document tags.docx");

 // 此集合提供了用于访问范围和非范围结构化标签的统一接口。
IEnumerable<IStructuredDocumentTag> sdts = doc.Range.StructuredDocumentTags.ToList();
Assert.AreEqual(5, sdts.Count());

// 这里我们可以从范围和非范围结构化标签的公共接口中获取子节点。
foreach (IStructuredDocumentTag sdt in sdts)
    if (sdt.GetChildNodes(NodeType.Any, false).Count > 0)
        sdt.RemoveSelfOnly();

sdts = doc.Range.StructuredDocumentTags.ToList();
Assert.AreEqual(0, sdts.Count());

也可以看看