Clear

StructuredDocumentTag.Clear method

Löscht den Inhalt dieses strukturierten Dokument-Tags und zeigt einen Platzhalter an, sofern dieser definiert ist.

public void Clear()

Bemerkungen

Es ist nicht möglich, den Inhalt eines strukturierten Dokument-Tags zu löschen, wenn es Revisionen aufweist.

Wenn dieses strukturierte Dokument-Tag benutzerdefiniertem XML zugeordnet ist (unter Verwendung vonXmlMapping -Eigenschaft) wird der referenzierte XML-Knoten gelöscht.

Beispiele

Zeigt, wie Inhalte strukturierter Dokument-Tag-Elemente gelöscht werden.

Document doc = new Document();

// Erstellen Sie ein strukturiertes Nur-Text-Dokument-Tag und hängen Sie es dann an das Dokument an.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// Dieses strukturierte Dokument-Tag in Form eines Textfelds zeigt bereits Platzhaltertext an.
Assert.AreEqual("Click here to enter text.", tag.GetText().Trim());
Assert.True(tag.IsShowingPlaceholderText);

// Einen Baustein mit Textinhalten erstellen.
GlossaryDocument glossaryDoc = doc.GlossaryDocument;
BuildingBlock substituteBlock = new BuildingBlock(glossaryDoc);
substituteBlock.Name = "My placeholder";
substituteBlock.AppendChild(new Section(glossaryDoc));
substituteBlock.FirstSection.EnsureMinimum();
substituteBlock.FirstSection.Body.FirstParagraph.AppendChild(new Run(glossaryDoc, "Custom placeholder text."));
glossaryDoc.AppendChild(substituteBlock);

// Setzen Sie die Eigenschaft „PlaceholderName“ des strukturierten Dokument-Tags auf den Namen unseres abzurufenden Bausteins
// das strukturierte Dokument-Tag, um den Inhalt des Bausteins anstelle des ursprünglichen Standardtextes anzuzeigen.
tag.PlaceholderName = "My placeholder";

Assert.AreEqual("Custom placeholder text.", tag.GetText().Trim());
Assert.True(tag.IsShowingPlaceholderText);

// Den Text des strukturierten Dokument-Tags bearbeiten und den Platzhaltertext ausblenden.
Run run = (Run)tag.GetChild(NodeType.Run, 0, true);
run.Text = "New text.";
tag.IsShowingPlaceholderText = false;

Assert.AreEqual("New text.", tag.GetText().Trim());

// Verwenden Sie die Methode „Clear“, um den Inhalt dieses strukturierten Dokument-Tags zu löschen und den Platzhalter erneut anzuzeigen.
tag.Clear();

Assert.True(tag.IsShowingPlaceholderText);
Assert.AreEqual("Custom placeholder text.", tag.GetText().Trim());

Siehe auch

StructuredDocumentTag.Accept StructuredDocumentTag.RemoveSelfOnly