Insertar campos
Hay varias formas diferentes de insertar campos en un documento:
- usando DocumentBuilder
- usando FieldBuilder
- usando Modelo de objetos de documento Aspose.Words (DOM)
En este artículo, veremos cada forma con más detalle y analizaremos cómo insertar ciertos campos usando estas opciones.
Insertar campos en un documento usando DocumentBuilder
En Aspose.Words, el método insert_field se utiliza para insertar nuevos campos en un documento. El primer parámetro acepta el código de campo completo del campo a insertar. El segundo parámetro es opcional y permite configurar manualmente el resultado del campo. Si no se proporciona, el campo se actualiza automáticamente. Puede pasar nulo o vacío a este parámetro para insertar un campo con un valor de campo vacío. Si no está seguro de la sintaxis del código de campo en particular, primero cree el campo en Microsoft Word y cambie para ver su código de campo.
El siguiente ejemplo de código muestra cómo insertar un campo de combinación en un documento usando DocumentBuilder:
El siguiente ejemplo de código muestra cómo insertar un campo de combinación con configuración regional alemana en un documento usando DocumentBuilder:
Se utiliza la misma técnica para insertar campos anidados dentro de otros campos.
El siguiente ejemplo de código muestra cómo insertar campos anidados dentro de otro campo usando DocumentBuilder:
Especificar configuración regional a nivel de campo
Un identificador de idioma es una abreviatura numérica internacional estándar para el idioma de un país o región geográfica. Con Aspose.Words, puede especificar la configuración regional a nivel de campo. La propiedad locale_id obtiene o establece el ID de configuración regional del campo.
El siguiente ejemplo de código muestra cómo utilizar esta opción:
Insertar campo sin escribir/vacío
Si desea insertar campos vacíos/sin escribir ({}) tal como lo permite Microsoft Word, puede usar el método insert_field con el parámetro FieldType.FIELD_NONE. Para insertar un campo en un documento de Word, puede presionar la combinación de teclas “Ctrl + F9”.
El siguiente ejemplo de código muestra cómo insertar un campo vacío en el documento:
Insertar campos en un documento usando FieldBuilder
La forma alternativa de insertar campos en Aspose.Words es la clase FieldBuilder. Proporciona una interfaz fluida para especificar cambios de campo y valores de argumentos como texto, nodos o incluso campos anidados.
El siguiente ejemplo de código muestra cómo insertar un campo en un documento usando FieldBuilder:
Insertar campos usando DOM
También puede insertar varios tipos de campos usando Modelo de objetos de documento Aspose.Words (DOM). En esta sección veremos algunos ejemplos.
Insertar campo de combinación en un documento usando DOM
El campo MERGEFIELD en un documento de Word se puede representar mediante la clase FieldMergeField. Puede utilizar la clase FieldMergeField para realizar las siguientes operaciones:
- especifique el nombre del campo de combinación
- especificar el formato del campo de combinación
- especifique el texto que se encuentra entre el separador de campo y el final del campo de combinación
- especifique el texto que se insertará después del campo de combinación si el campo no está en blanco
- especifique el texto que se insertará antes del campo de combinación si el campo no está en blanco
El siguiente ejemplo de código muestra cómo agregar un campo Merge usando DOM a un párrafo de un documento:
Insertar el campo Mail Merge ADDRESSBLOCK en un documento usando DOM
El campo ADDRESSBLOCK se utiliza para insertar un bloque de dirección Mail Merge en un documento de Word. El campo ADDRESSBLOCK en un documento de Word se puede representar mediante la clase FieldAddressBlock. Puede utilizar la clase FieldAddressBlock para realizar las siguientes operaciones:
- especifique si desea incluir el nombre del país/región en el campo
- especifique si desea formatear la dirección según el país/región del destinatario según lo definido por POST*CODE (Unión Postal Universal 2006)
- especifique el nombre del país/región excluidos
- especificar el formato de nombre y dirección
- especifique el ID de idioma utilizado para formatear la dirección
El siguiente ejemplo de código muestra cómo agregar el campo Mail Merge ADDRESSBLOCK usando DOM a un párrafo de un documento:
Insertar campo ADVANCE en un documento sin usar DocumentBuilder
El campo ADVANCE se utiliza para desplazar el texto posterior dentro de una línea hacia la izquierda, derecha, arriba o abajo. El campo ADVANCE en un documento de Word se puede representar mediante la clase FieldAdvance. Puede utilizar la clase FieldAdvance para realizar las siguientes operaciones:
- especifique el número de puntos por los cuales el texto que sigue al campo debe moverse verticalmente desde el borde superior de la página
- especifique el número de puntos por los cuales el texto que sigue al campo debe moverse horizontalmente desde el borde izquierdo de la columna, marco o cuadro de texto
- especifique el número de puntos por los cuales el texto que sigue al campo debe moverse hacia la izquierda, derecha, arriba o abajo
El siguiente ejemplo de código muestra cómo agregar el campo ADVANCE usando DOM a un párrafo de un documento.
Insertar un campo ASK en un documento sin usar DocumentBuilder
El campo ASK se utiliza para solicitar al usuario el texto que desea asignar a un marcador en un documento de Word. El campo ASK en un documento de Word se puede representar mediante la clase FieldAsk. Puede utilizar la clase FieldAsk para realizar las siguientes operaciones:
- especificar el nombre del marcador
- especificar la respuesta del usuario predeterminada (valor inicial contenido en la ventana de solicitud)
- especificar si la respuesta del usuario debe recibirse una vez por operación mail merge
- especificar el texto del mensaje (el título de la ventana del mensaje)
El siguiente ejemplo de código muestra cómo agregar el campo ASK usando DOM a un párrafo de un documento:
Insertar un campo AUTHOR en un documento sin usar DocumentBuilder
El campo AUTHOR se utiliza para especificar el nombre del autor del documento desde las propiedades Document. El campo AUTHOR en un documento de Word se puede representar mediante la clase FieldAuthor. Puede utilizar la clase FieldAuthor para realizar las siguientes operaciones:
- especificar el nombre del autor del documento
El siguiente ejemplo de código muestra cómo agregar el campo AUTHOR usando DOM a un párrafo de un documento:
Insertar campo INCLUDETEXT en un documento sin usar DocumentBuilder
El campo INCLUDETEXT inserta el texto y los gráficos contenidos en el documento nombrado en el código de campo. Puede insertar el documento completo o una parte del documento al que hace referencia un marcador. Este campo en un documento de Word está representado por INCLUDETEXT. Puede utilizar la clase FieldIncludeText para realizar las siguientes operaciones:
- especifique el nombre del marcador del documento incluido
- especificar la ubicación del documento
El siguiente ejemplo de código muestra cómo agregar el campo INCLUDETEXT usando DOM a un párrafo de un documento:
Insertar un campo TOA en un documento sin usar DocumentBuilder
El campo TOA (Tabla de autoridades) crea e inserta una tabla de autoridades. El campo TOA recopila entradas marcadas por campos TA (Entrada de tabla de autoridades). Microsoft Office Word inserta el campo TOA al hacer clic en Insertar tabla de autoridades en el grupo Mesa de Autoridades de la pestaña References. Cuando ve el campo TOA en su documento, la sintaxis se ve así:
{ TOA [Switches ] }
Puede utilizar la clase FieldToa para realizar las operaciones con el campo TOA.
El siguiente ejemplo de código muestra cómo agregar el campo TOA usando DOM a un párrafo de un documento: