Clear

StructuredDocumentTag.Clear method

Efface le contenu de cette balise de document structuré et affiche un espace réservé s’il est défini.

public void Clear()

Remarques

Il n’est pas possible d’effacer le contenu d’une balise de document structuré si elle contient des révisions.

Si cette balise de document structuré est mappée à un XML personnalisé (en utilisant leXmlMapping(propriété ), le nœud XML référencé est effacé.

Exemples

Montre comment supprimer le contenu des éléments de balise de document structuré.

Document doc = new Document();

// Créez une balise de document structurée en texte brut, puis ajoutez-la au document.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// Cette balise de document structurée, qui se présente sous la forme d'une zone de texte, affiche déjà un texte d'espace réservé.
Assert.AreEqual("Click here to enter text.", tag.GetText().Trim());
Assert.True(tag.IsShowingPlaceholderText);

// Créez un bloc de construction avec un contenu textuel.
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);

// Définissez la propriété « PlaceholderName » de la balise de document structuré sur le nom de notre bloc de construction pour obtenir
// la balise de document structurée pour afficher le contenu du bloc de construction à la place du texte par défaut d'origine.
tag.PlaceholderName = "My placeholder";

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

// Modifiez le texte de la balise du document structuré et masquez le texte d'espace réservé.
Run run = (Run)tag.GetChild(NodeType.Run, 0, true);
run.Text = "New text.";
tag.IsShowingPlaceholderText = false;

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

// Utilisez la méthode « Clear » pour effacer le contenu de cette balise de document structuré et afficher à nouveau l'espace réservé.
tag.Clear();

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

Voir également

StructuredDocumentTag.AcceptStart StructuredDocumentTag.RemoveSelfOnly