IStructuredDocumentTag

IStructuredDocumentTag interface

Schnittstelle zur Definition gemeinsamer Daten fürStructuredDocumentTag UndStructuredDocumentTagRangeStart .

public interface IStructuredDocumentTag

Eigenschaften

NameBeschreibung
Appearance { get; set; }Ruft das Erscheinungsbild des strukturierten Dokumenttags ab oder legt es fest.
Color { get; set; }Ruft die Farbe des strukturierten Dokument-Tags ab oder legt sie fest.
Id { get; }Gibt eine eindeutige, schreibgeschützte, persistente numerische ID für diesesSDT.
IsMultiSection { get; }Gibt „true“ zurück, wenn diese Instanz ein strukturierter Dokumenttag mit mehreren Abschnitten ist.
IsShowingPlaceholderText { get; set; }Gibt an, ob der Inhalt dieserSDT muss so interpretiert werden, dass es Platzhaltertext enthält (im Gegensatz zu regulärem Textinhalt innerhalb des SDT).
Level { get; }Ruft die Ebene ab, auf der diesesSDT tritt im Dokumentbaum auf.
LockContentControl { get; set; }Wenn diese Eigenschaft auf „true“ gesetzt ist, verhindert sie, dass ein Benutzer dieseSDT .
LockContents { get; set; }Wenn diese Eigenschaft auf „true“ gesetzt ist, wird ein Benutzer daran gehindert, den Inhalt dieserSDT .
Node { get; }Gibt das Node-Objekt zurück, das diese Schnittstelle implementiert.
Placeholder { get; }Ruft dieBuildingBlock Enthält Platzhaltertext, der angezeigt werden soll, wenn der Inhalt dieses SDT-Laufs leer ist, das zugehörige zugeordnete XML-Element ist leer, wie über dieXmlMapping element oder dasIsShowingPlaceholderText Element ist wahr.
PlaceholderName { get; set; }Ruft den Namen desBuildingBlock mit Platzhaltertext.
SdtType { get; }Ruft den Typ diesesStrukturiertes Dokument-Tag .
Tag { get; set; }Gibt ein Tag an, das mit dem aktuellen SDT-Knoten verknüpft ist. Darf nicht null sein.
Title { get; set; }Gibt den Anzeigenamen an, der mit diesemSDT . Darf nicht null sein.
WordOpenXML { get; }Ruft eine Zeichenfolge ab, die das XML darstellt, das im Knoten imFlatOpc format.
XmlMapping { get; }Ruft ein Objekt ab, das die Zuordnung dieses strukturierten Dokumenttags zu XML-Daten in einem benutzerdefinierten XML-Teil des aktuellen Dokuments darstellt.

Methoden

NameBeschreibung
GetChildNodes(NodeType, bool)Gibt eine Live-Sammlung von untergeordneten Knoten zurück, die den angegebenen Typen entsprechen.
RemoveSelfOnly()Entfernt nur diesen SDT-Knoten selbst, behält aber seinen Inhalt im Dokumentbaum.

Beispiele

Zeigt, wie strukturierte Dokument-Tags entfernt werden, der Inhalt jedoch erhalten bleibt.

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

    // Diese Sammlung bietet eine einheitliche Schnittstelle für den Zugriff auf strukturierte Tags mit und ohne Bereich.
IEnumerable<IStructuredDocumentTag> sdts = doc.Range.StructuredDocumentTags.ToList();
Assert.AreEqual(5, sdts.Count());

// Hier können wir untergeordnete Knoten aus der gemeinsamen Schnittstelle strukturierter Tags mit und ohne Bereich abrufen.
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());

Siehe auch