Sinopsis del Editor de Documentos
DocumentBuilder es una clase poderosa que se asocia con Document y le permite construir documentos dinámicos desde cero o añadir nuevos elementos a uno existente.
DocumentBuilder proporciona métodos para insertar texto, casillas de verificación, objetos ole, párrafos, listas, tablas, imágenes y otros elementos de contenido. Le permite especificar fuentes, párrafo o sección formato, y realizar otras operaciones.
Document Builder o Aspose.Words DOM
DocumentBuilder complementa clases y métodos disponibles en Aspose.Words Document Object Model (G)DOM) para simplificar las tareas más comunes de construcción de documentos. Es decir, usted puede crear y modificar el contenido de los documentos a través de Aspose.Words DOM, que requiere una buena comprensión de la estructura del árbol, y el uso del DocumentBuilder. El DocumentBuilder es una “fachada” para el complejo Document estructura que le permite insertar rápidamente y fácilmente contenido y formato.
Operaciones que son posibles con DocumentBuilder son también posibles al utilizar las clases de Aspose.Words DOM directamente. Sin embargo, utilizando Aspose.Words DOM clases directamente generalmente requieren más líneas de código que usar DocumentBuilder.
Documento de navegación
La navegación de documentos se basa en el concepto de un cursor virtual, con el que se puede desplazar a otra ubicación en el documento utilizando varios DocumentBuilder.MoveToXXX métodos tales como MoveToDocumentStart y MoveToField. Este cursor virtual indica dónde se insertará el texto al llamar los métodos Write, Writeln, InsertBreak, y otros. Vea el siguiente artículo “Navigation with Cursor” para aprender más sobre el cursor virtual.
El siguiente ejemplo de código muestra cómo navegar a un marcador:
Document Building and Modification
Aspose.Words API proporciona varias clases que son responsables de formatear varios elementos de un documento. Cada una de las clases encapsula propiedades de formato relacionadas con un elemento de documento específico, como texto, párrafo, sección y otros. Por ejemplo, el Font clase representa propiedades de formato de caracteres, la ParagraphFormat clase representa propiedades de formato del párrafo, etc. Los objetos de estas clases son devueltos por el correspondiente DocumentBuilder propiedades, 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, casilla de verificación, objeto ole, imágenes, marcadores, campos de formulario y otros elementos de documento en la posición del cursor utilizando el Write método o cualquiera de los DocumentBuilder.InsertXXX métodos, como InsertField, InsertHtml, y métodos similares.
Veamos cómo crear un documento simple usando el DocumentBuilder.
Crear un documento usando DocumentBuilder
Para empezar, necesitas crear un DocumentBuilder y asociarlo con un Document objeto. Creas una nueva instancia DocumentBuilder llamando a su constructor y pasarlo a un Document objeto para el apego al constructor.
Para insertar un texto, pase la cadena de texto que necesita insertar en el documento al Write método.
El siguiente ejemplo de código muestra cómo crear un documento simple usando un constructor de documentos.
Especificar formato de documento
El Font propiedad define el formato de texto. Este objeto contiene diferentes atributos de fuentes (nombre de columna, tamaño de fuente, color, etc.). Algunos atributos de fuentes importantes también están representados por DocumentBuilder propiedades que le permiten acceder directamente a ellas. Estos son los Font.Bold, Font.Italic, y Font.Underline propiedades booleanas.
El siguiente ejemplo de código muestra cómo insertar un texto formateado utilizando DocumentBuilder:
- Font especifica el formato de caracteres que se aplicará a todo texto insertado desde la posición actual en el documento en adelante.
- ParagraphFormat especifica el formato del párrafo para el texto actual y todos los párrafos que deben insertarse.
- 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 especifique las propiedades de formato que se aplicarán a las celdas y filas de la posición actual en el documento en adelante.
En esta situación, “actual” significa la posición, párrafo, sección, celda o fila en la que está el cursor.