VisitParagraphStart
Contenido
[
Ocultar
]DocumentVisitor.VisitParagraphStart method
Se llama cuando ha comenzado la enumeración de un párrafo.
public virtual VisitorAction VisitParagraphStart(Paragraph paragraph)
Parámetro | Escribe | Descripción |
---|---|---|
paragraph | Paragraph | El objeto que se está visitando. |
Valor_devuelto
AVisitorAction
valor que especifica cómo continuar la enumeración.
Ejemplos
Muestra cómo utilizar un visitante de documentos para imprimir la estructura de nodos de un documento.
public void DocStructureToText()
{
Document doc = new Document(MyDir + "DocumentVisitor-compatible features.docx");
DocStructurePrinter visitor = new DocStructurePrinter();
// Cuando conseguimos que un nodo compuesto acepte un visitante del documento, el visitante visita el nodo receptor,
// y luego atraviesa todos los hijos del nodo en profundidad.
// El visitante puede leer y modificar cada nodo visitado.
doc.Accept(visitor);
Console.WriteLine(visitor.GetText());
}
/// <summary>
/// Atraviesa el árbol de nodos secundarios de un nodo.
/// Crea un mapa de este árbol en forma de cadena.
/// </summary>
public class DocStructurePrinter : DocumentVisitor
{
public DocStructurePrinter()
{
mAcceptingNodeChildTree = new StringBuilder();
}
public string GetText()
{
return mAcceptingNodeChildTree.ToString();
}
/// <summary>
/// Se llama cuando se encuentra un nodo Documento.
/// </summary>
public override VisitorAction VisitDocumentStart(Document doc)
{
int childNodeCount = doc.GetChildNodes(NodeType.Any, true).Count;
IndentAndAppendLine("[Document start] Child nodes: " + childNodeCount);
mDocTraversalDepth++;
// Permitir que el visitante continúe visitando otros nodos.
return VisitorAction.Continue;
}
/// <summary>
/// Se llama después de que se hayan visitado todos los nodos secundarios de un nodo de documento.
/// </summary>
public override VisitorAction VisitDocumentEnd(Document doc)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Document end]");
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo de Sección en el documento.
/// </summary>
public override VisitorAction VisitSectionStart(Section section)
{
// Obtener el índice de nuestra sección dentro del documento.
NodeCollection docSections = section.Document.GetChildNodes(NodeType.Section, false);
int sectionIndex = docSections.IndexOf(section);
IndentAndAppendLine("[Section start] Section index: " + sectionIndex);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Se llama después de que se hayan visitado todos los nodos secundarios de un nodo de Sección.
/// </summary>
public override VisitorAction VisitSectionEnd(Section section)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Section end]");
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo Cuerpo en el documento.
/// </summary>
public override VisitorAction VisitBodyStart(Body body)
{
int paragraphCount = body.Paragraphs.Count;
IndentAndAppendLine("[Body start] Paragraphs: " + paragraphCount);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Se llama después de que se hayan visitado todos los nodos secundarios de un nodo Body.
/// </summary>
public override VisitorAction VisitBodyEnd(Body body)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Body end]");
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo Párrafo en el documento.
/// </summary>
public override VisitorAction VisitParagraphStart(Paragraph paragraph)
{
IndentAndAppendLine("[Paragraph start]");
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Se llama después de que se hayan visitado todos los nodos secundarios de un nodo de párrafo.
/// </summary>
public override VisitorAction VisitParagraphEnd(Paragraph paragraph)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Paragraph end]");
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo Ejecutar en el documento.
/// </summary>
public override VisitorAction VisitRun(Run run)
{
IndentAndAppendLine("[Run] \"" + run.GetText() + "\"");
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo SubDocumento en el documento.
/// </summary>
public override VisitorAction VisitSubDocument(SubDocument subDocument)
{
IndentAndAppendLine("[SubDocument]");
return VisitorAction.Continue;
}
/// <summary>
/// Agrega una línea al StringBuilder y sangra dependiendo de qué tan profundo esté el visitante en el árbol del documento.
/// </summary>
/// <param nombre="texto"></param>
private void IndentAndAppendLine(string text)
{
for (int i = 0; i < mDocTraversalDepth; i++) mAcceptingNodeChildTree.Append("| ");
mAcceptingNodeChildTree.AppendLine(text);
}
private int mDocTraversalDepth;
private readonly StringBuilder mAcceptingNodeChildTree;
}
Muestra cómo utilizar una implementación de DocumentVisitor para eliminar todo el contenido oculto de un documento.
public void RemoveHiddenContentFromDocument()
{
Document doc = new Document(MyDir + "Hidden content.docx");
RemoveHiddenContentVisitor hiddenContentRemover = new RemoveHiddenContentVisitor();
// A continuación se muestran tres tipos de campos que pueden aceptar un visitante de documentos,
// lo que le permitirá visitar el nodo de aceptación y luego atravesar sus nodos secundarios en profundidad.
// 1 - Nodo de párrafo:
Paragraph para = (Paragraph)doc.GetChild(NodeType.Paragraph, 4, true);
para.Accept(hiddenContentRemover);
// 2 - Nodo de tabla:
Table table = doc.FirstSection.Body.Tables[0];
table.Accept(hiddenContentRemover);
// 3 - Nodo de documento:
doc.Accept(hiddenContentRemover);
doc.Save(ArtifactsDir + "Font.RemoveHiddenContentFromDocument.docx");
}
/// <summary>
/// Elimina todos los nodos visitados marcados como "contenido oculto".
/// </summary>
public class RemoveHiddenContentVisitor : DocumentVisitor
{
/// <summary>
/// Se llama cuando se encuentra un nodo FieldStart en el documento.
/// </summary>
public override VisitorAction VisitFieldStart(FieldStart fieldStart)
{
if (fieldStart.Font.Hidden)
fieldStart.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo FieldEnd en el documento.
/// </summary>
public override VisitorAction VisitFieldEnd(FieldEnd fieldEnd)
{
if (fieldEnd.Font.Hidden)
fieldEnd.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo FieldSeparator en el documento.
/// </summary>
public override VisitorAction VisitFieldSeparator(FieldSeparator fieldSeparator)
{
if (fieldSeparator.Font.Hidden)
fieldSeparator.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo Ejecutar en el documento.
/// </summary>
public override VisitorAction VisitRun(Run run)
{
if (run.Font.Hidden)
run.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un nodo Párrafo en el documento.
/// </summary>
public override VisitorAction VisitParagraphStart(Paragraph paragraph)
{
if (paragraph.ParagraphBreakFont.Hidden)
paragraph.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un FormField en el documento.
/// </summary>
public override VisitorAction VisitFormField(FormField formField)
{
if (formField.Font.Hidden)
formField.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un GroupShape en el documento.
/// </summary>
public override VisitorAction VisitGroupShapeStart(GroupShape groupShape)
{
if (groupShape.Font.Hidden)
groupShape.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra una forma en el documento.
/// </summary>
public override VisitorAction VisitShapeStart(Shape shape)
{
if (shape.Font.Hidden)
shape.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un comentario en el documento.
/// </summary>
public override VisitorAction VisitCommentStart(Comment comment)
{
if (comment.Font.Hidden)
comment.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra una nota al pie en el documento.
/// </summary>
public override VisitorAction VisitFootnoteStart(Footnote footnote)
{
if (footnote.Font.Hidden)
footnote.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando se encuentra un carácter especial en el documento.
/// </summary>
public override VisitorAction VisitSpecialChar(SpecialChar specialChar)
{
if (specialChar.Font.Hidden)
specialChar.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando finaliza la visita a un nodo de tabla en el documento.
/// </summary>
public override VisitorAction VisitTableEnd(Table table)
{
// El contenido dentro de las celdas de la tabla puede tener la marca de contenido oculto, pero las tablas mismas no.
// Si esta tabla no tuviera nada más que contenido oculto, este visitante lo habría eliminado todo.
// y no quedarán nodos secundarios.
// Por lo tanto, también podemos tratar la tabla como contenido oculto y eliminarla.
// Las tablas que están vacías pero que no tienen contenido oculto tendrán celdas con párrafos vacíos en su interior.
// que este visitante no eliminará.
if (!table.HasChildNodes)
table.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando finaliza la visita a un nodo celular en el documento.
/// </summary>
public override VisitorAction VisitCellEnd(Cell cell)
{
if (!cell.HasChildNodes && cell.ParentNode != null)
cell.Remove();
return VisitorAction.Continue;
}
/// <summary>
/// Se llama cuando finaliza la visita a un nodo de fila en el documento.
/// </summary>
public override VisitorAction VisitRowEnd(Row row)
{
if (!row.HasChildNodes && row.ParentNode != null)
row.Remove();
return VisitorAction.Continue;
}
}
Ver también
- enum VisitorAction
- class Paragraph
- class DocumentVisitor
- espacio de nombres Aspose.Words
- asamblea Aspose.Words