Clear

StructuredDocumentTag.Clear method

Rensar innehållet i denna strukturerade dokumenttagg och visar en platshållare om den är definierad.

public void Clear()

Anmärkningar

Det är inte möjligt att rensa innehållet i en strukturerad dokumenttagg om den har revideringar.

Om denna strukturerade dokumenttagg är mappad till anpassad XML (med hjälp avXmlMapping egenskapen), rensas den refererade XML-noden.

Exempel

Visar hur man tar bort innehållet i strukturerade dokumenttaggelement.

Document doc = new Document();

// Skapa en textstrukturerad dokumenttagg och lägg sedan till den i dokumentet.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// Den här strukturerade dokumenttaggen, som är i form av en textruta, visar redan platshållartext.
Assert.AreEqual("Click here to enter text.", tag.GetText().Trim());
Assert.True(tag.IsShowingPlaceholderText);

// Skapa en byggsten med textinnehåll.
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);

// Ställ in den strukturerade dokumenttaggens "PlaceholderName"-egenskap till vårt byggblocks namn för att få
// den strukturerade dokumenttaggen för att visa innehållet i byggblocket istället för den ursprungliga standardtexten.
tag.PlaceholderName = "My placeholder";

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

// Redigera texten i den strukturerade dokumenttaggen och dölj platshållartexten.
Run run = (Run)tag.GetChild(NodeType.Run, 0, true);
run.Text = "New text.";
tag.IsShowingPlaceholderText = false;

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

// Använd metoden "Rensa" för att rensa innehållet i denna strukturerade dokumenttagg och visa platshållaren igen.
tag.Clear();

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

Se även

StructuredDocumentTag.Accept StructuredDocumentTag.RemoveSelfOnly