Id

StructuredDocumentTag.Id property

Gibt hierfür eine eindeutige, schreibgeschützte, persistente numerische ID anSDT.

public int Id { get; }

Bemerkungen

Das ID-Attribut muss diesen Regeln folgen:

  • Das Dokument behält SDT-IDs nur dann bei, wenn das gesamte Dokument geklont wirdClone.
  • WährendImportNode Die -ID soll beibehalten werden, wenn der Import keine Konflikte mit anderen SDT-IDs im des Zieldokuments verursacht.
  • Wenn mehrere SDT-Knoten denselben Dezimalzahlenwert für das Id-Attribut angeben, , behält der erste SDT im Dokument diese ursprüngliche ID bei, und allen nachfolgenden SDT-Knoten werden beim Laden des Dokuments neue Bezeichner zugewiesen.
  • Während des Standalone-SDTINodeCloningListener) Durch den Vorgang wird eine neue eindeutige ID für den geklonten SDT-Knoten generiert.
  • Wenn im Quelldokument keine ID angegeben ist, wird dem SDT-Knoten beim Laden des Dokuments eine neue eindeutige Kennung zugewiesen .

Beispiele

Zeigt, wie man ein strukturiertes Dokument-Tag in einem Nur-Text-Feld erstellt und sein Erscheinungsbild ändert.

Document doc = new Document();

// Erstellen Sie ein strukturiertes Dokument-Tag, das einfachen Text enthält.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline);

// Legen Sie den Titel und die Farbe des Rahmens fest, der angezeigt wird, wenn Sie mit der Maus über das strukturierte Dokument-Tag in Microsoft Word fahren.
tag.Title = "My plain text";
tag.Color = Color.Magenta;

// Legen Sie ein Tag für dieses strukturierte Dokument-Tag fest, das verfügbar ist
// als XML-Element mit dem Namen „tag“, mit der folgenden Zeichenfolge in seinem „@val“-Attribut.
tag.Tag = "MyPlainTextSDT";

// Jedes strukturierte Dokument-Tag hat eine zufällige eindeutige ID.
Assert.That(tag.Id, Is.Positive);

// Legen Sie die Schriftart für den Text innerhalb des strukturierten Dokument-Tags fest.
tag.ContentsFont.Name = "Arial";

// Legen Sie die Schriftart für den Text am Ende des strukturierten Dokument-Tags fest.
// Jeder Text, den wir in den Dokumentkörper eingeben, nachdem wir ihn mit den Pfeiltasten aus dem Tag herausbewegt haben, verwendet diese Schriftart.
tag.EndCharacterFont.Name = "Arial Black";

// Standardmäßig ist dies falsch und das Drücken der Eingabetaste innerhalb eines strukturierten Dokument-Tags führt zu nichts.
// Wenn es auf „true“ gesetzt ist, kann unser strukturiertes Dokument-Tag mehrere Zeilen haben.

// Setzen Sie die Eigenschaft „Multiline“ auf „false“, um nur den Inhalt zuzulassen
// dieses strukturierten Dokument-Tags, um eine einzelne Zeile zu umfassen.
// Setzen Sie die Eigenschaft „Multiline“ auf „true“, damit das Tag mehrere Zeilen Inhalt enthalten kann.
tag.Multiline = true;

// Setzen Sie die Eigenschaft „Appearance“ auf „SdtAppearance.Tags“, um Tags rund um den Inhalt anzuzeigen.
 // Standardmäßig wird das strukturierte Dokument-Tag als BoundingBox angezeigt.
tag.Appearance = SdtAppearance.Tags;

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertNode(tag);

// Einen Klon unseres strukturierten Dokument-Tags in einen neuen Absatz einfügen.
StructuredDocumentTag tagClone = (StructuredDocumentTag)tag.Clone(true);
builder.InsertParagraph();
builder.InsertNode(tagClone);

// Verwenden Sie die Methode „RemoveSelfOnly“, um ein strukturiertes Dokument-Tag zu entfernen und gleichzeitig seinen Inhalt im Dokument zu behalten.
tagClone.RemoveSelfOnly();

doc.Save(ArtifactsDir + "StructuredDocumentTag.PlainText.docx");

Siehe auch

StructuredDocumentTag.FullDate StructuredDocumentTag.IsShowingPlaceholderText