Documentation – Descripción general del Generador de documentos en C++

Cpp: Navegación con Cursor en C++

Mon, 01 Jan 0001 00:00:00 +0000

Mientras trabaja con un documento, incluso si es corto o largo, deberá navegar por su documento. La navegación con un cursor virtual representa la capacidad de navegar entre diferentes nodos en un documento.

Dentro de un documento corto, moverse por un documento es simple, ya que puede mover el punto de inserción incluso usando las teclas de flecha del teclado o haciendo clic con el mouse para ubicar el punto de inserción donde desee. Pero una vez que tenga un documento grande que tenga muchas páginas, estas técnicas básicas serán insuficientes.

En este artículo se explica cómo moverse por un documento y navegar con un cursor virtual a diferentes partes del mismo.

Detección de La Posición Actual del Cursor

Antes de comenzar el proceso de navegación por su documento, deberá obtener el nodo que está seleccionado actualmente. Puede obtener la posición exacta del cursor en un nodo seleccionado utilizando la propiedad CurrentNode. Además, en lugar de obtener el nodo actual, puede obtener el párrafo seleccionado actualmente o la sección seleccionada actualmente utilizando las propiedades CurrentParagraph y CurrentSection.

Cualquier operación de inserción que realice con DocumentBuilder se insertará antes de CurrentNode. Cuando el párrafo actual está vacío o el cursor se coloca justo antes del final del párrafo, CurrentNode devuelve nullptr.

Navegar por los métodos de un documento

Cuando edite texto, es importante saber cómo navegar por su documento y dónde moverse exactamente en él. Aspose.Words le permite moverse por un documento y navegar a sus diferentes secciones y partes; esto es similar a la funcionalidad del Panel de navegación en Microsoft Word para ir a una página o encabezado en un documento de Word sin desplazarse.

El método principal es poder mover la posición del cursor a un nodo específico en su documento, puede lograrlo utilizando el método MoveTo.

El siguiente ejemplo de código muestra cómo mover el DocumentBuilder a diferentes nodos en un documento:

Pero además del método básico MoveTo, hay otros más específicos.

Vaya al Principio o al final de un Documento

Puede ir al principio o al final de su documento utilizando los métodos MoveToDocumentStart y MoveToDocumentEnd.

El siguiente ejemplo de código muestra cómo mover la posición del cursor al principio o al final de un documento:

Navegar Con Marcadores

Puede marcar un lugar que desee encontrar y volver a él fácilmente. Puede insertar tantos marcadores en su documento como desee y luego navegar a través de ellos identificando los marcadores con nombres únicos. Puede moverse a un marcador utilizando el método MoveToBookmark.

Los siguientes ejemplos de código muestran cómo mover una posición del cursor a un marcador:

Navegar a las Celdas de la Tabla

Puede moverse a una celda de la tabla utilizando el método MoveToCell. Este método le permitirá navegar con el cursor a cualquier celda de una tabla específica. Además, puede especificar un índice para mover el cursor a cualquier posición o carácter especificado en una celda dentro del método MoveToCell.

El siguiente ejemplo de código muestra cómo mover una posición del cursor a una celda de tabla especificada:

Navegar a un Campo

Puede moverse a un campo específico en su documento utilizando el método MoveToField. Además, puede moverse a un campo de combinación específico utilizando el método MoveToMergeField.

El siguiente ejemplo de código muestra cómo mover el cursor del generador de documentos a un campo específico:

Navegar a un Encabezado o Pie de página

Puede moverse al principio de un encabezado o pie de página utilizando el método MoveToHeaderFooter.

El siguiente ejemplo de código muestra cómo mover el cursor del generador de documentos al encabezado o pie de página de un documento:

Navegar a una Sección o Párrafo

Puede moverse a una sección o párrafo específico utilizando los métodos MoveToParagraph o MoveToSection. Además, puede especificar un índice para mover el cursor a cualquier posición o carácter especificado en un párrafo dentro del método MoveToParagraph.

El siguiente ejemplo de código muestra cómo moverse a una sección y un párrafo específicos en un documento:

Cpp: Utilice DocumentBuilder para Insertar Elementos de Documento

Mon, 01 Jan 0001 00:00:00 +0000

El DocumentBuilder se usa para modificar documentos. Este artículo explica y describe cómo realizar una serie de tareas:

Insertar una Cadena de Texto

Simplemente pase la cadena de texto que necesita insertar en el documento al método DocumentBuilder.Write. El formato del texto está determinado por la propiedad Font. 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 propiedades DocumentBuilder para permitirle acceder a ellos directamente. Estas son propiedades booleanas Font.Bold, Font.Italic y Font.Underline.

Tenga en cuenta que el formato de caracteres que establezca se aplicará a todo el texto insertado desde la posición actual en el documento en adelante.

El siguiente ejemplo Inserta texto formateado usando DocumentBuilder.

Insertar un Párrafo

DocumentBuilder.Writeln también inserta una cadena de texto en el documento, pero además, agrega un salto de párrafo. El formato de fuente actual también se especifica mediante la propiedad DocumentBuilder.Font y el formato de párrafo actual se determina mediante la propiedad DocumentBuilder.ParagraphFormat. El siguiente ejemplo muestra cómo insertar un párrafo en el documento.

Insertar una Tabla

El algoritmo básico para crear una tabla usando DocumentBuilder es simple:

Comience la tabla usando DocumentBuilder.StartTable.
Inserte una celda usando DocumentBuilder.InsertCell. Esto inicia automáticamente una nueva fila. Si es necesario, use la propiedad DocumentBuilder.CellFormat para especificar el formato de celda.
Inserte el contenido de la celda utilizando los métodos DocumentBuilder.
Repita los pasos 2 y 3 hasta completar la fila.
Llame a DocumentBuilder.EndRow para finalizar la fila actual. Si es necesario, use la propiedad DocumentBuilder.RowFormat para especificar el formato de fila.
Repita los pasos 2 - 5 hasta completar la tabla.
Llama a DocumentBuilder.EndTable para terminar de construir la mesa. Los métodos apropiados de creación de la tabla DocumentBuilder se describen a continuación.

Comenzando una Mesa

Llamar a DocumentBuilder.StartTable es el primer paso para crear una tabla. También se puede llamar dentro de una celda, en cuyo caso inicia una tabla anidada. El siguiente método a llamar es DocumentBuilder.InsertCell.

Insertar una Celda

Después de llamar a DocumentBuilder->InsertCell, se crea una nueva celda y cualquier contenido que agregue utilizando otros métodos de la clase DocumentBuilder se agregará a la celda actual. Para iniciar una celda nueva en la misma fila, llame a DocumentBuilder->InsertCell nuevamente. Utilice la propiedad DocumentBuilder.CellFormat para especificar el formato de celda. Devuelve un objeto CellFormat que representa todo el formato de una celda de la tabla.

Terminando una Fila

Llame a DocumentBuilder.EndRow para finalizar la fila actual. Si llama a DocumentBuilder->InsertCell inmediatamente después de eso, la tabla continúa en una nueva fila.

Utilice la propiedad DocumentBuilder.RowFormat para especificar el formato de fila. Devuelve un objeto RowFormat que representa todo el formato de una fila de la tabla.

Poner fin a una Mesa

Llame a DocumentBuilder.EndTable para finalizar la tabla actual. Este método debe llamarse solo una vez después de llamar a DocumentBuilder->EndRow. Cuando se llama, DocumentBuilder.EndTable mueve el cursor fuera de la celda actual a una posición justo después de la tabla. El siguiente ejemplo demuestra cómo crear una tabla formateada que contenga 2 filas y 2 columnas.

Insertar una Pausa

Si desea iniciar explícitamente una nueva línea, párrafo, columna, sección o página, llame a DocumentBuilder.InsertBreak. Pase a este método el tipo de interrupción que necesita insertar que está representado por la enumeración BreakType. El siguiente ejemplo muestra cómo insertar saltos de página en un documento.

Insertar una Imagen

DocumentBuilder proporciona varias sobrecargas del método DocumentBuilder->InsertImage que le permiten insertar una imagen en línea o flotante. Si la imagen es un metarchivo EMF o WMF, se insertará en el documento en formato metarchivo. Todas las demás imágenes se almacenarán en formato PNG. El método DocumentBuilder->InsertImage puede usar imágenes de diferentes fuentes:

Desde un archivo o URL pasando un parámetro de cadena DocumentBuilder->InsertImage.
De una secuencia pasando un parámetro Stream DocumentBuilder->InsertImage.
De un objeto Image pasando un parámetro Image DocumentBuilder->InsertImage.
De una matriz de bytes pasando un parámetro de matriz de bytes DocumentBuilder.InsertImage.Para cada uno de los métodos DocumentBuilder->InsertImage, hay sobrecargas adicionales que le permiten insertar una imagen con las siguientes opciones:
En línea o flotando en una posición específica, por ejemplo, DocumentBuilder->InsertImage.
Escala porcentual o tamaño personalizado, por ejemplo, DocumentBuilder.InsertImage. Además, el método DocumentBuilder->InsertImage devuelve un objeto Shape que acaba de crearse e insertarse para que pueda modificar aún más las propiedades de la Forma.

Insertar una Imagen en Línea

Pase una sola cadena que represente un archivo que contenga la imagen a DocumentBuilder->InsertImage para insertar la imagen en el documento como gráficos en línea. El siguiente ejemplo muestra cómo insertar una imagen en línea en la posición del cursor en un documento.

Insertar una Imagen Flotante (Posicionada Absolutamente)

Este ejemplo inserta una imagen flotante de un archivo o URL en una posición y tamaño especificados.

Insertar un Marcador

Para insertar un marcador en el documento, debe hacer lo siguiente:

Llame a DocumentBuilder->StartBookmark pasándole el nombre deseado del marcador.
Inserte el texto del marcador utilizando los métodos DocumentBuilder.
Llame a DocumentBuilder.EndBookmark pasándole el mismo nombre que usó con DocumentBuilder->StartBookmark.
Los marcadores pueden superponerse y abarcar cualquier rango. Para crear un marcador válido, debe llamar a DocumentBuilder->StartBookmark y DocumentBuilder->EndBookmark con el mismo nombre de marcador.

Los marcadores mal formados o los marcadores con nombres duplicados se ignorarán cuando se guarde el documento.

El siguiente ejemplo muestra cómo insertar un marcador en un documento utilizando un generador de documentos.

Insertar un campo <code>Form</code>

Los campos de formulario son un caso particular de campos de palabras que permiten la “interacción” con el usuario. Los campos de formulario en Microsoft Word incluyen cuadro de texto, cuadro combinado y casilla de verificación.DocumentBuilder proporciona métodos especiales para insertar cada tipo de campo de formulario en el documento: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox y DocumentBuilder.InsertComboBox. Tenga en cuenta que si especifica un nombre para el campo del formulario, se creará automáticamente un marcador con el mismo nombre.

Insertar una Entrada de texto

DocumentBuilder.InsertTextInput para insertar un cuadro de texto en el documento. El siguiente ejemplo muestra cómo insertar un campo de formulario de entrada de texto en un documento.

Insertar una casilla de Verificación

Llame a DocumentBuilder.InsertCheckBox para insertar una casilla de verificación en el documento. El siguiente ejemplo muestra cómo insertar un campo de formulario de casilla de verificación en un documento.

Insertar un Cuadro Combinado

Llame a DocumentBuilder.InsertComboBox para insertar un cuadro combinado en el documento. El siguiente ejemplo muestra cómo insertar un campo de formulario de cuadro combinado en un documento.

Insertar Configuración regional a Nivel de Campo

Los clientes pueden especificar la configuración regional a nivel de campo ahora y pueden lograr un mejor control. Los ID de configuración regional se pueden asociar con cada campo dentro del DocumentBuilder. Los ejemplos a continuación ilustran cómo hacer uso de esta opción.

Insertar un Hipervínculo

Utilice DocumentBuilder.InsertHyperlink para insertar un hipervínculo en el documento. Este método acepta tres parámetros: texto del enlace que se mostrará en el documento, destino del enlace (URL o el nombre de un marcador dentro del documento) y un parámetro booleano que debería ser verdadero si URL es el nombre de un marcador dentro del documento.DocumentBuilder.InsertHyperlink llamadas internas DocumentBuilder.InsertField.El método siempre agrega apóstrofes al principio y al final de la URL. Tenga en cuenta que debe especificar el formato de fuente para el texto de visualización del hipervínculo explícitamente utilizando la propiedad Font. El siguiente ejemplo inserta un hipervínculo en un documento usando DocumentBuilder.

Insertar Objeto Ole

Si desea llamar al objeto Ole DocumentBuilder.InsertOleObject. Pase a este método el ProgId explícitamente con otros parámetros. El siguiente ejemplo muestra cómo insertar un objeto Ole en un documento.

Establezca el Nombre y la Extensión del Archivo al Insertar el Objeto Ole

El paquete OLE es una forma heredada e “indocumentada” de almacenar objetos incrustados si se desconoce el controlador OLE. Versiones tempranas de Windows como Windows 3.1, 95 y 98 tenían Empaquetador.aplicación exe que podría usarse para incrustar cualquier tipo de datos en el documento. Ahora, esta aplicación está excluida de Windows, pero MS Word y otras aplicaciones aún la usan para incrustar datos si falta el controlador OLE o se desconoce. la clase OlePackage permite acceder a las propiedades del paquete OLE. El siguiente ejemplo muestra cómo configurar el nombre de archivo, la extensión y el nombre para mostrar del paquete OLE.

Inserción de HTML

Puede insertar fácilmente una cadena HTML que contenga un fragmento HTML o un documento HTML completo en el documento de Word. Simplemente pase esta cadena al método DocumentBuilder->InsertHtml. Una de las implementaciones útiles del método es almacenar una cadena HTML en una base de datos e insertarla en el documento durante Mail Merge para agregar el contenido formateado en lugar de compilarlo utilizando varios métodos del generador de documentos. El siguiente ejemplo muestra inserciones HTML en un documento usando DocumentBuilder.

Insertar Regla Horizontal en el Documento

El ejemplo Below code muestra cómo insertar una forma de regla horizontal en un documento utilizando el método DocumentBuilder->InsertHorizontalRule.

Cpp: Usar DocumentBuilder para Modificar un Documento fácilmente

Mon, 01 Jan 0001 00:00:00 +0000

Especificación del Formato

Formato de Fuente

El formato de fuente actual está representado por un objeto Font devuelto por la propiedad DocumentBuilder.Font. La clase Font contiene una amplia variedad de propiedades de fuente posibles en Microsoft Word. El siguiente ejemplo muestra cómo configurar el formato de fuente.

Formato de Párrafo

El formato de párrafo actual está representado por un objeto ParagraphFormat que devuelve la propiedad DocumentBuilder.ParagraphFormat. Este objeto encapsula varias propiedades de formato de párrafo disponibles en Microsoft Word. Puede restablecer fácilmente el formato de párrafo predeterminado al estilo normal, alineado a la izquierda, sin sangría, sin espaciado, sin bordes y sin sombreado llamando a ParagraphFormat.ClearFormatting. El siguiente ejemplo muestra cómo configurar el formato de párrafo.

Trabajar con Tipografía Asiática

Ajusta automáticamente el espacio entre texto asiático y latino, Números

Si está diseñando una plantilla con texto de Asia Oriental y latín, y desea mejorar la apariencia de la plantilla de formulario controlando los espacios entre ambos tipos de texto, puede configurar su plantilla de formulario para ajustar automáticamente los espacios entre estos dos tipos de texto. Puede usar las propiedades AddSpaceBetweenFarEastAndAlpha y AddSpaceBetweenFarEastAndDigit de la clase ParagraphFormat para lograr esto.

El siguiente ejemplo de código muestra cómo usar las propiedades ParagraphFormat.AddSpaceBetweenFarEastAndAlpha y ParagraphFormat.AddSpaceBetweenFarEastAndDigit.

Cambiar el Espaciado y las Sangrías de los Párrafos Asiáticos

El siguiente ejemplo de código demuestra cómo cambiar el espaciado y las sangrías de los párrafos asiáticos.

Establecer Opciones de Salto de Línea

La pestaña Tipografía asiática del cuadro de diálogo de propiedades Paragraph en MS Word tiene un grupo de saltos de línea. Las opciones de este grupo se pueden configurar usando FarEastLineBreakControl, WordWrap, HangingPunctuation propiedades de la clase ParagraphFormat. El ejemplo Below code muestra cómo usar estas propiedades.

Formato de Celda

El formato de celda se usa durante la creación de una tabla. Está representado por un objeto CellFormat devuelto por la propiedad DocumentBuilder.CellFormat. CellFormat encapsula varias propiedades de celda de tabla, como ancho o alineación vertical. El siguiente ejemplo muestra cómo crear una tabla que contenga una sola celda formateada.

Formato de Filas

El formato de fila actual está determinado por un objeto RowFormat que devuelve la propiedad DocumentBuilder.RowFormat. El objeto encapsula información sobre el formato de todas las filas de la tabla. El siguiente ejemplo muestra cómo crear una tabla que contenga una sola celda y aplicar formato de fila.

Formato de Lista

Aspose.Words permite la creación sencilla de listas aplicando formato de lista. DocumentBuilder proporciona la propiedad DocumentBuilder.ListFormat que devuelve un objeto ListFormat. Este objeto tiene varios métodos para iniciar y finalizar una lista y para aumentar/disminuir la sangría. Hay dos tipos generales de listas en Microsoft Word: con viñetas y numeradas.

Para iniciar una lista con viñetas, llame a ListFormat.ApplyBulletDefault.
Para iniciar una lista numerada, llame a ListFormat.ApplyNumberDefault.

La viñeta o el número y el formato se agregan al párrafo actual y a todos los párrafos adicionales creados con DocumentBuilder hasta que se llame a ListFormat.RemoveNumbers para detener el formato de la lista con viñetas. En los documentos de Word, las listas pueden constar de hasta nueve niveles. El formato de lista para cada nivel especifica qué viñeta o número se usa, sangría izquierda, espacio entre la viñeta y el texto, etc.

Para aumentar el nivel de lista del párrafo actual en un nivel, llame a ListFormat.ListIndent.
Para disminuir el nivel de lista del párrafo actual en un nivel, llame a ListFormat.ListOutdent.

Los métodos cambian el nivel de la lista y aplican las propiedades de formato del nuevo nivel.

También puede usar la propiedad ListFormat.ListLevelNumber para obtener o establecer el nivel de lista del párrafo. Los niveles de lista están numerados 0 a 8.

El siguiente ejemplo muestra cómo crear una lista multinivel.

Configuración de la Página y Formato de la Sección

Las propiedades de configuración de página y sección están encapsuladas en el objeto PageSetup que devuelve la propiedad DocumentBuilder.PageSetup. El objeto contiene todos los atributos de configuración de página de una sección (margen izquierdo, margen inferior, tamaño del papel, etc.) como propiedades. El siguiente ejemplo muestra cómo establecer propiedades como el tamaño de página y la orientación para la sección actual.

Aplicar un Estilo

Algunos objetos de formato, como Font o ParagraphFormat, admiten estilos. Un único estilo integrado o definido por el usuario se representa mediante un objeto Style que contiene las propiedades de estilo correspondientes, como el nombre, el estilo base, la fuente y el formato de párrafo del estilo,etc.

Además, un objeto Style proporciona la propiedad Style.StyleIdentifier que devuelve un identificador de estilo independiente de la configuración regional representado por un valor de enumeración Style.StyleIdentifier. El punto es que los nombres de los estilos integrados en Microsoft Word están localizados para diferentes idiomas. Con un identificador de estilo, puede encontrar el estilo correcto independientemente del idioma del documento. Los valores de enumeración corresponden a los estilos integrados de Microsoft Word, como Normal, Encabezado 1, Encabezado 2, etc. A todos los estilos definidos por el usuario se les asigna el StyleIdentifier.User value. El siguiente ejemplo muestra cómo aplicar un estilo de párrafo.

Bordes y Sombreado

Los bordes están representados por BorderCollection. Se trata de una colección de objetos de borde a los que se accede por índice o por tipo de borde. El tipo de borde está representado por la enumeración BorderType. Algunos valores de la enumeración son aplicables a varios o solo a un elemento de documento. Por ejemplo, BorderType.Bottom se aplica a un párrafo o celda de tabla, mientras que BorderType.DiagonalDown especifica el borde diagonal solo en una celda de tabla.

Tanto la colección de bordes como cada borde separado tienen atributos similares, como color, estilo de línea, ancho de línea, distancia del texto y sombra opcional. Están representados por propiedades del mismo nombre. Puede lograr diferentes tipos de bordes combinando los valores de las propiedades. Además, los objetos BorderCollection y Border le permiten restablecer estos valores predeterminados llamando al método Border.ClearFormatting. Tenga en cuenta que cuando las propiedades del borde se restablecen a los valores predeterminados, el borde es invisible. La clase Shading contiene atributos de sombreado para los elementos del documento. Puede establecer la textura de sombreado deseada y los colores que se aplican al fondo y al primer plano del elemento.

La textura de sombreado se establece con un valor de enumeración TextureIndex que permite la aplicación de varios patrones al objeto Shading. Por ejemplo, para establecer un color de fondo para un elemento de documento, use el valor TextureIndex.TextureSolid y establezca el color de sombreado de primer plano según corresponda. El siguiente ejemplo muestra cómo aplicar bordes y sombreado a un párrafo.

Ajustar a la cuadrícula

Aspose.Words proporciona dos propiedades ParagraphFormat.SnapToGrid y Font.SnapToGrid para obtener y establecer el ajuste de la propiedad del párrafo a la cuadrícula.

Mover el Cursor

Detectar la Posición Actual del Cursor

Puede obtener dónde se encuentra actualmente el cursor del constructor en cualquier momento. La propiedad DocumentBuilder.CurrentNode devuelve el nodo que está seleccionado actualmente en este generador. El nodo es un hijo directo de un párrafo. Cualquier operación de inserción que realice con DocumentBuilder se insertará antes de DocumentBuilder.CurrentNode. Cuando el párrafo actual está vacío o el cursor se coloca justo antes del final del párrafo, DocumentBuilder.CurrentNode devuelve nulo.

Además, puede usar la propiedad DocumentBuilder.CurrentParagraph, que obtiene el párrafo que está seleccionado actualmente en este DocumentBuilder. El siguiente ejemplo muestra cómo acceder al nodo actual en un generador de documentos. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Mover a Cualquier Nodo (Párrafos y sus Hijos)

Si tiene un nodo de objeto de documento, que es un párrafo o un elemento secundario directo de un párrafo, puede apuntar el cursor del generador a este nodo. Utilice el método DocumentBuilder.MoveTo para realizar esto. El siguiente ejemplo muestra cómo mover una posición del cursor a un nodo especificado. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Ir al Inicio/Fin del documento

Si necesita moverse al principio del documento, llame a DocumentBuilder.MoveToDocumentStart. Si necesita desplazarse hasta el final del documento, llame a DocumentBuilder.MoveToDocumentEnd. El siguiente ejemplo muestra cómo mover la posición del cursor al principio o al final de un documento. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Mover a una Sección

Si está trabajando con un documento que contiene varias secciones, puede moverse a la sección deseada usando DocumentBuilder.MoveToSection. Este método mueve el cursor al principio de una sección especificada y acepta el índice de la sección requerida. Cuando el índice de la sección es mayor o igual que 0, especifica un índice desde el principio del documento, siendo 0 la primera sección. Cuando el índice de la sección es menor que 0, especifica un índice desde el final del documento, siendo -1 la última sección. El siguiente ejemplo muestra cómo mover una posición del cursor a la sección especificada. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Mover a un Encabezado/Pie de página

Cuando necesite colocar algunos datos en un encabezado o pie de página, primero debe moverse allí usando DocumentBuilder.MoveToHeaderFooter. El método acepta un valor de enumeración HeaderFooterType que identifica el tipo de encabezado o pie de página al que se debe mover el cursor. Si desea crear encabezados y pies de página que sean diferentes para la primera página, debe establecer la propiedad PageSetup.DifferentFirstPageHeaderFooter en true. Si desea crear encabezados y pies de página que sean diferentes para las páginas pares e impares, debe establecer PageSetup.OddAndEvenPagesHeaderFooter en true.

Si necesita volver a la historia principal, use DocumentBuilder.MoveToSection para salir del encabezado o pie de página. El siguiente ejemplo crea encabezados y pies de página en un documento usando DocumentBuilder.

Pasar a un Párrafo

Use DocumentBuilder.MoveToParagraph para mover el cursor al párrafo deseado en la sección actual. Debe pasar dos parámetros a este método: paragraphIndex (el índice del párrafo al que moverse) y characterIndex (el índice del carácter dentro del párrafo).

La navegación se realiza dentro de la historia actual de la sección actual. Es decir, si movió el cursor al encabezado principal de la primera sección, paragraphIndex especifica el índice del párrafo dentro de ese encabezado de esa sección.

Cuando paragraphIndex es mayor o igual que 0, especifica un índice desde el principio de la sección, siendo 0 el primer párrafo. Cuando paragraphIndex es menor que 0, especifica un índice desde el final de la sección, siendo -1 el último párrafo.

Actualmente, el índice de caracteres solo se puede especificar como 0 para ir al principio del párrafo o -1 para ir al final del párrafo. El siguiente ejemplo muestra cómo mover una posición del cursor al párrafo especificado. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Mover a una Celda de Tabla

Utilice DocumentBuilder.MoveToCell si necesita mover el cursor a una celda de la tabla en la sección actual. Este método acepta cuatro parámetros:

tableIndex - el índice de la tabla a la que se moverá.
rowIndex - el índice de la fila en la tabla.
columnIndex - el índice de la columna en la tabla.
characterIndex - el índice del carácter dentro de la celda.

La navegación se realiza dentro de la historia actual de la sección actual. Para los parámetros de índice, cuando el índice es mayor o igual que 0, especifica un índice desde el principio siendo 0 el primer elemento. Cuando el índice es menor que 0, especifica un índice desde el final siendo -1 el último elemento.

Además, tenga en cuenta que characterIndex actualmente solo puede especificar 0 para moverse al principio de la celda o -1 para moverse al final de la celda. El siguiente ejemplo muestra cómo mover una posición del cursor a la celda de la tabla especificada. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Mover a un marcador

Los marcadores se utilizan con frecuencia para marcar lugares particulares del documento donde se van a insertar nuevos elementos. Para desplazarse a un marcador, utilice DocumentBuilder.MoveToBookmark. Este método tiene dos sobrecargas. El más simple no acepta nada más que el nombre del marcador donde se moverá el cursor. El siguiente ejemplo muestra cómo mover la posición del cursor a un marcador. Puede descargar el archivo de plantilla de este ejemplo desde aquí.

Esta sobrecarga mueve el cursor a una posición justo después del inicio del marcador con el nombre especificado. Otra sobrecarga DocumentBuilder.MoveToBookmark mueve el cursor a un marcador con mayor precisión. Acepta dos parámetros booleanos adicionales:

isStart determina si se mueve el cursor al principio o al final del marcador.
isAfter determina si se mueve el cursor para que esté después de la posición inicial o final del marcador, o si se mueve el cursor para que esté antes de la posición inicial o final del marcador.

El siguiente ejemplo muestra cómo mover la posición del cursor justo después del final del marcador.

La comparación de ambos métodos no distingue entre mayúsculas y minúsculas.

Insertar texto nuevo de esta manera no reemplaza el texto existente del marcador. Tenga en cuenta que algunos marcadores del documento están asignados a campos de formulario. Moverse a dicho marcador e insertar texto allí inserta el texto en el código del campo del formulario. Aunque esto no invalidará el campo del formulario, el texto insertado no será visible porque se convierte en parte del código del campo.

Cómo Convertir entre Unidades de Medida

La mayoría de las propiedades de objeto proporcionadas en la API Aspose.Words que representan alguna medida (ancho / alto, márgenes y varias distancias) aceptan valores en puntos (1 pulgada equivale a 72 puntos). A veces, esto no es conveniente, por lo que existe la clase ConvertUtil que proporciona funciones auxiliares para convertir entre varias unidades de medida. Permite convertir pulgadas en puntos, puntos en pulgadas, píxeles en puntos y puntos en píxeles. Cuando los píxeles se convierten en puntos y viceversa, se puede realizar con resoluciones de 96 ppp (puntos por pulgada) o con la resolución de ppp especificada. ConvertUtil