Descripción General del Generador de Documentos
DocumentBuilder es una clase poderosa que se asocia con Document y le permite crear documentos dinámicos desde cero o agregar nuevos elementos a uno existente.
DocumentBuilder
Generador de documentos o Aspose.Words DOM
DocumentBuilder
Las operaciones que son posibles con DocumentBuilder también son posibles cuando se usan las clases de Aspose.Words DOM directamente. Sin embargo, usar Aspose.Words DOM clases directamente generalmente requiere más líneas de código que usar DocumentBuilder.
Navegación de Documentos
La navegación del documento se basa en el concepto de un cursor virtual, con el que puede moverse a otra ubicación en el documento utilizando varios métodos DocumentBuilder.MoveToXXX como MoveToDocumentStart y MoveToField. Este cursor virtual indica dónde se insertará el texto al llamar a los métodos Write, Writeln, InsertBreak, y otros. Consulte el siguiente artículo “Navegación con cursor” para obtener más información sobre el cursor virtual.
El siguiente ejemplo de código muestra cómo navegar a un marcador:
Creación y Modificación de Documentos
Aspose.Words API proporciona varias clases que son responsables de formatear varios elementos de un documento. Cada una de las clases encapsula las propiedades de formato relacionadas con un elemento de documento específico, como texto, párrafo, sección y otros. Por ejemplo, la clase Font representa las propiedades de formato de caracteres, la clase ParagraphFormat representa las propiedades de formato de párrafos,etc. Los objetos de estas clases son devueltos por las propiedades DocumentBuilder correspondientes, que tienen los mismos nombres que las clases. Por lo tanto, puede acceder a ellos y establecer el formato deseado durante la compilación del documento.
También puede insertar texto, checkbox, objeto ole, imágenes, marcadores, campos de formulario y otros elementos de documento en la posición del cursor utilizando el método Write o cualquiera de los métodos DocumentBuilder.InsertXXX, como InsertField, InsertHtml y métodos similares.
Veamos cómo crear un documento simple usando el DocumentBuilder.
Crear un documento usando DocumentBuilder
Para comenzar, debe crear un DocumentBuilder y asociarlo con un objeto Document. Puede crear una nueva instancia de DocumentBuilder llamando a su constructor y pasándola a un objeto Document para adjuntarla al constructor.
Para insertar un texto, pase la cadena de texto que necesita insertar en el documento al método Write.
El siguiente ejemplo de código muestra cómo crear un documento simple utilizando un generador de documentos.
Especificar el Formato del Documento
La propiedad Font define el formato del texto. Este objeto contiene diferentes atributos de fuente( nombre de fuente, tamaño de fuente, color, etc.). Algunos atributos de fuente importantes también están representados por las propiedades DocumentBuilder para permitirle acceder a ellos directamente. Estas son las propiedades booleanas Font.Bold, Font.Italic y Font.Underline.
El siguiente ejemplo de código muestra cómo insertar un texto formateado usando DocumentBuilder:
- Font especifica el formato de caracteres que se aplicará a todo el texto insertado desde la posición actual en el documento en adelante.
- ParagraphFormat especifica el formato de párrafo para el párrafo actual y todos los párrafos que se insertarán.
- PageSetup especifica las propiedades de página y sección para la sección actual y toda la sección que se insertará.
- CellFormat y RowFormat especifican las propiedades de formato que se aplicarán a las celdas y filas de la tabla a partir de la posición actual en el documento.
En esta situación, “actual” significa la posición, párrafo, sección, celda o fila en la que se encuentra el cursor.