Id

StructuredDocumentTag.Id property

Gibt eine eindeutige, schreibgeschützte, persistente numerische ID für diesesSDT.

public int Id { get; }

Bemerkungen

Das ID-Attribut muss diesen Regeln folgen:

  • Das Dokument soll SDT-IDs nur behalten, wenn das gesamte Dokument geklont wirdClone.
  • WährendImportNode Die ID muss beibehalten werden, wenn der Import keine Konflikte mit anderen SDT-IDs im Zieldokument verursacht.
  • Wenn mehrere SDT-Knoten denselben Dezimalwert für das ID-Attribut angeben, dann muss der erste SDT im Dokument diese ursprüngliche ID beibehalten, und allen nachfolgenden SDT-Knoten müssen beim Laden des Dokuments neue Kennungen zugewiesen werden.
  • Während des eigenständigen SDTINodeCloningListener) Bei diesem Vorgang wird für den geklonten SDT-Knoten eine neue eindeutige ID generiert.
  • Wenn die ID im Quelldokument nicht angegeben ist, muss dem SDT-Knoten beim Laden des Dokuments eine neue eindeutige Kennung zugewiesen werden.

Beispiele

Zeigt, wie Sie in einem einfachen Textfeld ein strukturiertes Dokument-Tag erstellen und dessen Erscheinungsbild ändern.

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 in Microsoft Word mit der Maus über das strukturierte Dokument-Tag fahren.
tag.Title = "My plain text";
tag.Color = Color.Magenta;

// Setzen Sie ein Tag für dieses strukturierte Dokument-Tag, das erhältlich ist
// als XML-Element mit dem Namen „tag“, mit der folgenden Zeichenfolge im Attribut „@val“.
tag.Tag = "MyPlainTextSDT";

// Jedes strukturierte Dokument-Tag hat eine zufällige eindeutige ID.
Assert.IsTrue(tag.Id > 0);

// 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 Dokumenttext eingeben, nachdem wir das Tag mit den Pfeiltasten verlassen haben, verwendet diese Schriftart.
tag.EndCharacterFont.Name = "Arial Black";

// Standardmäßig ist dies „false“ und das Drücken der Eingabetaste innerhalb eines strukturierten Dokument-Tags bewirkt nichts.
// Wenn auf „true“ gesetzt, 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 Inhaltszeilen enthalten kann.
tag.Multiline = true;

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

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

// Fügen Sie einen Klon unseres strukturierten Dokument-Tags in einen neuen Absatz ein.
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 beizubehalten.
tagClone.RemoveSelfOnly();

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

Siehe auch

StructuredDocumentTag.FullDate StructuredDocumentTag.IsShowingPlaceholderText