Class DocumentVisitor

DocumentVisitor class

La clase abstracta para iterar a través del subárbol con raíz en el nodo especificado.

public abstract class DocumentVisitor

Métodos

NombreDescripción
virtual VisitAttachedFileEnd(AttachedFile)Fin para visitar elAttachedFile nodo.
virtual VisitAttachedFileStart(AttachedFile)Empezar a visitar elAttachedFile nodo.
virtual VisitDocumentEnd(Document)Fin para visitar elDocument nodo.
virtual VisitDocumentStart(Document)Empezar a visitar elDocument nodo.
virtual VisitImageEnd(Image)Fin para visitar elImage nodo.
virtual VisitImageStart(Image)Empezar a visitar elImage nodo.
virtual VisitOutlineElementEnd(OutlineElement)Fin para visitar elOutlineElement nodo.
virtual VisitOutlineElementStart(OutlineElement)Empezar a visitar elOutlineElement nodo.
virtual VisitOutlineEnd(Outline)Fin para visitar elOutline nodo.
virtual VisitOutlineGroupEnd(OutlineGroup)Fin para visitar elOutlineGroup nodo.
virtual VisitOutlineGroupStart(OutlineGroup)Empezar a visitar elOutlineGroup nodo.
virtual VisitOutlineStart(Outline)Empezar a visitar elOutline nodo.
virtual VisitPageEnd(Page)Fin para visitar elPage nodo.
virtual VisitPageStart(Page)Empezar a visitar elPage nodo.
virtual VisitRichTextEnd(RichText)Fin para visitar elRichText nodo.
virtual VisitRichTextStart(RichText)Empezar a visitar elRichText nodo.
virtual VisitTableCellEnd(TableCell)Fin para visitar elTableCell nodo.
virtual VisitTableCellStart(TableCell)Empezar a visitar elTableCell nodo.
virtual VisitTableEnd(Table)Fin para visitar elTable nodo.
virtual VisitTableRowEnd(TableRow)Fin para visitar elTableRow nodo.
virtual VisitTableRowStart(TableRow)Empezar a visitar elTableRow nodo.
virtual VisitTableStart(Table)Empezar a visitar elTable nodo.
virtual VisitTitleEnd(Title)Fin para visitar elTitle nodo.
virtual VisitTitleStart(Title)Empezar a visitar elTitle nodo.

Ejemplos

Muestra cómo acceder al contenido de un documento utilizando el visitante.

public static void Run()
{
    // La ruta al directorio de documentos.
    string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

    // Abre el documento que queremos convertir.
    Document doc = new Document(dataDir + "Aspose.one");

    // Crear un objeto que herede de la clase DocumentVisitor.
    MyOneNoteToTxtWriter myConverter = new MyOneNoteToTxtWriter();

    // Este es el conocido patrón Visitante. Obtenga el modelo para aceptar un visitante.
    // El modelo iterará a través de sí mismo llamando a los métodos correspondientes
    // en el objeto visitante (esto se llama visita).
    //
    // Tenga en cuenta que cada nodo en el modelo de objetos tiene el método Aceptar, por lo que la visita
    // puede ejecutarse no solo para todo el documento, sino también para cualquier nodo del documento.
    doc.Accept(myConverter);

    // Una vez completada la visita, podemos recuperar el resultado de la operación,
    // que en este ejemplo, se ha acumulado en el visitante.
    Console.WriteLine(myConverter.GetText());
    Console.WriteLine(myConverter.NodeCount);            
}

/// <summary>
/// Implementación simple de guardar un documento en formato de texto sin formato. Implementado como Visitante.
/// </summary>
public class MyOneNoteToTxtWriter : DocumentVisitor
{
    public MyOneNoteToTxtWriter()
    {
        nodecount = 0;
        mIsSkipText = false;
        mBuilder = new StringBuilder();
    }

    /// <summary>
    /// Obtiene el texto sin formato del documento que fue acumulado por el visitante.
    /// </summary>
    public string GetText()
    {
        return mBuilder.ToString();
    }

    /// <summary>
    /// Agrega texto a la salida actual. Respeta el indicador de salida activado/desactivado.
    /// </summary>
    private void AppendText(string text)
    {
        if (!mIsSkipText)
        {
            mBuilder.AppendLine(text);
        }
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo RichText en el documento.
    /// </summary>
    public override void VisitRichTextStart(RichText run)
    {
        ++nodecount;
        AppendText(run.Text);
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo Documento en el documento.
    /// </summary>
    public override void VisitDocumentStart(Document document)
    {
        ++nodecount;
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo de página en el documento.
    /// </summary>
    public override void VisitPageStart(Page page)
    {
        ++nodecount;
        this.AppendText($"*** Page '{page.Title?.TitleText?.Text ?? "(no title)"}' ***");
    }

    /// <summary>
    /// Llamado cuando finaliza el procesamiento de un nodo de página.
    /// </summary>
    public override void VisitPageEnd(Page page)
    {
        this.AppendText(string.Empty);
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo Título en el documento.
    /// </summary>
    public override void VisitTitleStart(Title title)
    {
        ++nodecount;
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo de imagen en el documento.
    /// </summary>
    public override void VisitImageStart(Image image)
    {
        ++nodecount;
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo de OutlineGroup en el documento.
    /// </summary>
    public override void VisitOutlineGroupStart(OutlineGroup outlineGroup)
    {
        ++nodecount;
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo Esquema en el documento.
    /// </summary>
    public override void VisitOutlineStart(Outline outline)
    {
        ++nodecount;
    }

    /// <summary>
    /// Llamado cuando se encuentra un nodo OutlineElement en el documento.
    /// </summary>
    public override void VisitOutlineElementStart(OutlineElement outlineElement)
    {
        ++nodecount;
    }

    /// <summary>
    /// Obtiene el conteo total de nodos por parte del Visitante
    /// </summary>
    public Int32 NodeCount
    {
        get { return this.nodecount; }
    }

    private readonly StringBuilder mBuilder;
    private bool mIsSkipText;
    private Int32 nodecount;
}

Ver también