Clear

StructuredDocumentTag.Clear method

Borra el contenido de esta etiqueta de documento estructurado y muestra un marcador de posición si está definido.

public void Clear()

Observaciones

No es posible borrar el contenido de una etiqueta de documento estructurado si tiene revisiones.

Si esta etiqueta de documento estructurado se asigna a XML personalizado (con el uso delXmlMapping propiedad), se borra el nodo XML al que se hace referencia.

Ejemplos

Muestra cómo eliminar el contenido de elementos de etiquetas de documentos estructurados.

Document doc = new Document();

// Cree una etiqueta de documento estructurado de texto sin formato y luego agréguela al documento.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// Esta etiqueta de documento estructurado, que tiene la forma de un cuadro de texto, ya muestra texto de marcador de posición.
Assert.AreEqual("Click here to enter text.", tag.GetText().Trim());
Assert.True(tag.IsShowingPlaceholderText);

// Crea un bloque de construcción con contenido de texto.
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);

// Establece la propiedad "PlaceholderName" de la etiqueta del documento estructurado en el nombre de nuestro bloque de construcción para obtener
// la etiqueta del documento estructurado para mostrar el contenido del bloque de creación en lugar del texto predeterminado original.
tag.PlaceholderName = "My placeholder";

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

// Edite el texto de la etiqueta del documento estructurado y oculte el texto del marcador de posición.
Run run = (Run)tag.GetChild(NodeType.Run, 0, true);
run.Text = "New text.";
tag.IsShowingPlaceholderText = false;

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

// Utilice el método "Borrar" para borrar el contenido de esta etiqueta de documento estructurado y mostrar el marcador de posición nuevamente.
tag.Clear();

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

Ver también

StructuredDocumentTag.Accept StructuredDocumentTag.RemoveSelfOnly