Los documentos 4D Write Pro pueden contener tablas. Las tablas 4D Write Pro son creadas y definidas por programación, pero su contenido puede ser modificado y manejado por el usuario. Varios atributos de tablas 4D Write Pro son editables, incluyendo la altura de la la línea, la alineación, los márgenes, el estilo del texto, el color o los bordes.

Una tabla 4D Write Pro puede contener hasta:

• 1000 líneas
• 300 columnas

Las tablas 4D Write Pro se crean mediante una llamada al comando WP Insert table. Luego puede añadir líneas utilizando el comando WP Table append row.

Nota: un usuario puede crear una tabla al copiar y pegar un rango de celdas:

El contenido de las celdas se puede agregar por programación utilizando el comando WP Table append row.

Una vez se crea una tabla, el contenido de la celda también puede ser editado en tiempo de ejecución por los usuarios. Pueden hacer clic en las celdas y seleccionar, editar, copiar o pegar o borrar texto o imágenes como en los párrafos regulares. Pueden navegar a través de las celdas con la tecla Tab (Mayús+ Tab para navegar en dirección opuesta).

Usando la tecla Retorno de carro dentro de una celda crea un nuevo párrafo en la celda.

Tenga en cuenta que el ancho de la celda es fijo: cuando un usuario escribe texto o pega una imagen, la altura de la fila se amplía automáticamente si es necesario y el texto se ajusta automáticamente:

Los usuarios también pueden seleccionar columnas, filas o celdas y aplicar los atributos disponibles con respecto al estilo del texto, colores, alineación, etc. utilizando el menú emergente integrado o cualquier interfaz personalizada. 4D Write Pro ofrece varios comandos para seleccionar cualquier parte de una tabla:

• WP Table get rows para obtener un rango de líneas (o rango de líneas de encabezado)
• WP Table get columns para obtener un rango de columnas (*)
• WP Table get cells para obtener un rango de celdas

(*) Las columnas no tienen equivalente en html. En 4D Write Pro, un rango de columnas es en realidad un rango de celdas, lo que significa que las columnas tienen la misma prioridad que las celdas.

Una vez que haya seleccionado un rango, puede aplicar cualquier atributo apropiado usando el comando WP SET ATTRIBUTES. Dentro de las celdas, los atributos se aplican a párrafos, caracteres o imágenes, dependiendo de su contenido. Por ejemplo, puede definir la altura, el tamaño de fuente, el borde, el relleno, etc. de tablas o celdas de tabla (para obtener más información, consulte la sección Atributos 4D Write Pro).

Cuando se aplican atributos diferentes a elementos concurrentes de una tabla, se aplica un orden de prioridad para la renderización:

1. La tabla se renderiza primero
2. Se renderizan las líneas (sobreescribir atributos de tabla)
3. Se renderizan las celdas/columnas (atributos de línea sobreescritos).

El ancho de las columnas de la tabla se puede modificar arrastrando el separador de columnas hacia la izquierda o hacia la derecha. El cursor cambia para indicar que se puede mover horizontalmente y la línea vertical se muestra en la regla:

Cambiar el tamaño de las columnas genera un evento formulario On After Edit.

Para cambiar el tamaño de una columna, haga clic en el separador de columna y arrástrelo hacia la izquierda o hacia la derecha. El tamaño mínimo de la columna es de 8 puntos. Si la columna adyacente a la derecha alcanza el tamaño mínimo, todas las columnas a la derecha se moverán. Si la primera columna o una columna adyacente a la izquierda alcanza el tamaño mínimo, no se puede cambiar el tamaño en esa dirección.

Si presiona la tecla Mayús mientras cambia el tamaño de una columna, el tamaño de la columna adyacente a la derecha no se modificará.

Nota: la propiedad Editable debe estar habilitada para que el documento 4D Write Pro permita cambiar el tamaño de la columna.

Cuando se muestran en modo Página o Borrador (o en el contexto de la impresión de un documento), las tablas 4D Write Pro pueden dividirse:

• automáticamente, si la altura de la tabla es mayor que la altura de página/columna disponible,
• dependiendo de los saltos de página/columna definidos por programación o por el usuario.    

Las tablas se dividen entre líneas, y las líneas también pueden dividirse. La paginación de la tabla se actualiza dinámicamente si la orientación o el número de columna se modifican.

Notas: 

• Puede desactivar los saltos de página automáticos en las tablas utilizando los atributos wk page break inside row / wk page break inside table (ver Atributos 4D Write Pro) o las acciones estándar table/avoidPageBreakInside y row/avoidPageBreakInside (ver Utilizar las acciones estándar 4D Write Pro). 
• Cuando una línea de la tabla y un párrafo tienen diferentes opciones de salto de página, las opciones aplicadas a la línea tienen prioridad. Por ejemplo, cuando un párrafo permite saltos de página, pero su línea padre no, la línea no se dividirá.

La paginación de la tabla se puede controlar por programación o por el usuario. Las acciones disponibles incluyen:

• insertar un salto de página en una tabla:
  • Comando WP INSERT BREAK
  • Acción estándar insertPageBreak
  • Opción Insertar salto de página del menú contextual predeterminado

• insertar un salto de columna en una tabla:
  
  • Comando WP INSERT BREAK
  • Acción estándar insertColumnBreak
  • Opción Insertar salto de columna del menú contextual predeterminado

Cuando se inserta un salto de página o un salto de columna mediante una acción estándar o el menú contextual, se agrega antes del contenido seleccionado: la primera fila de la selección se mueve al principio de la siguiente página o columna. Por ejemplo:

===>

Notas: 

• Sólo las tablas en el cuerpo de un documento pueden dividirse. Los cortes insertados en las tablas en los encabezados y pies de página se ignoran.
• Las tablas no se pueden dividir en diferentes secciones. Insertar un salto de sección en una tabla moverá toda la tabla a la nueva sección.
• Los saltos dentro de las líneas no están permitidos cuando las Líneas de arrastre están activadas. 

4D Write Pro le permite definir hasta cinco líneas de encabezado por tabla. Las líneas de encabezado seleccionadas se repetirán en cada columna o página cuando se produzca un salto de columna o de página.

Los encabezados de la tabla son la(s) primera(s) línea(s) de la tabla. Para definir las líneas de encabezado, puede:

• utilizar la acción estándar headerRowCount (ver Utilizar las acciones estándar 4D Write Pro), o
• utilizar la acción WP SET ATTRIBUTES con wk header row count (en una tabla, ver Tablas), o wk header (en una línea, ver Líneas y columnas). 

Si designa más de cinco líneas como encabezado (o si resulta de una inserción de líneas en un encabezado existente), 4D Write Pro sólo utiliza las cinco primeras líneas como encabezado. Si elimina la(s) línea(s) definida(s) en el encabezado, el número de líneas del encabezado disminuye.

Puede asignar un objeto fórmula como fuente de datos para una tabla y acceder a los valores resultantes desde la tabla utilizando Expresiones con This (ver más abajo). La fórmula de la fuente de datos es procesada por 4D Write Pro cuando se calculan las fórmulas (por ejemplo, cuando se abre el documento, cuando se llama al comando WP COMPUTE FORMULAS, etc.). Esta función aprovecha los contextos de datos (ver WP SET DATA CONTEXT).

Un diseño de tabla basado en una fuente de datos que contiene las siguientes líneas:

Icono	Líneas	Número	Obligatorio	Condiciones	Descripción
	Líneas de encabezado	hasta 5	-	-	Encabezado de tabla estándar, ver Encabezados repetidos
	Línea repetida	1	sí	La fórmula de la fuente de datos debe devolver elementos iterables	Si la tabla no tiene líneas de encabezado y/o líneeas de ruptura, la línea repetida es la primera línea de la tabla; en caso contrario, es la primera línea después del encabezado o las líneas de ruptura. Suele llenarse con expresiones que utilizan This (por ejemplo, This.item.value) que dan acceso a los datos procesados cuando el documento está modo Mostrar valores y la línea está duplicada.
	Líneas de ruptura ordenadas	hasta 5	-	La fórmula de la fuente de datos devuelve elementos iterables	La línea o líneas que aparecen antes o después de la línea repetida. Ver Líneas de ruptura
	Líneas de arrastre inferior	1	-	La fórmula de la fuente de datos debe devolver elementos iterables	La primera línea que sigue a la línea repetida o las líneas de ruptura. Ver Líneas de arrastre
	Otras líneas	ilimitada	-	-	Líneas estándar (no duplicadas)

Ejemplo (Mostrar modo referencias):

Cuando se calculan las fórmulas, la línea duplicada se duplica automáticamente según sea necesario para que coincida con todas las entidades o elementos de la colección devueltos por la fórmula de la fuente de datos:

En todo caso, la siguiente instrucción devuelve el número real de líneas:

Las tablas basadas en fuentes de datos soportan líneas de arrastre inferiores que se muestran automáticamente en la parte inferior de cada página/columna cuando la tabla se divide en más de una página/columna. Una línea de arrastre puede mostrar información adicional basada en los elementos mostrados/impresos anteriormente, gracias a la expresión This.previousItems (ver Expresiones con This). Esta función permite, por ejemplo, añadir líneas de subtotal.

Se muestran las líneas de arrastre:

• cuando una tabla de fuente de datos no cabe en una sola página (o columna)
• en la parte inferior de la tabla
• en la primera página (o primera columna) y en todas las demás excepto en la última.

Importante: las líneas de arrastre sólo están disponibles en las tablas llenadas por una fórmula de fuente de datos que devuelva una colección o una selección de entidades no vacía y en el modo de visualización de valores. En todos los demás casos o cuando la fórmula de la fuente de datos no se ha calculado, una línea de arrastre se muestra como una línea normal.

Para crear líneas de arrastre:

1. En la plantilla de la tabla, añada una línea justo después de la línea repetida o las líneas de ruptura e inserte las fórmulas necesarias en su interior, utilizando, por ejemplo This.previousItems.
2. Active la funcionalidad de arrastre de línes para su documento. Puede:
   - utilizar la acción estándar bottomCarryOverRow (ver Utilizar las acciones estándar 4D Write Pro), o
   - utilizar el comando WP SET ATTRIBUTES con el selector de atributos wk bottom carry over row Tablas. 

Nota: no se permiten saltos de página dentro de las líneas cuando la función de traspaso de líneas está activada (ver Paginación de tablas). Las opciones correspondientes, si se definen, se ignoran.

Las tablas basadas en fuentes de datos soportan una o varias Líneas de ruptura de orden que pueden mostrarse antes o después de la línea repetida. Las Líneas de ruptura de orden le ayudan a dividir visualmente los elementos de la fuente de datos ya ordenados en la tabla en diferentes partes basadas en un valor de fórmula calculado.

Cada vez que cambia el valor de la fórmula, se inserta una nueva línea de ruptura. Por lo tanto, para que las tablas se muestren correctamente, la selección de entidades (o colección) utilizada como fuente de datos de la tabla debe estar ordenada en consecuencia. Por ejemplo, si se desean desgloses por países y ciudades, la fuente de datos debe ordenarse del siguiente modo: ds.people.all().orderBy("country asc, city asc")

El valor de ruptura se define mediante el atributo wk break formula. El valor suele ser una fórmula basada en una propiedad del elemento como "This.item.name'', de lo contrario el valor calculado puede no cambiar nunca, lo que hace que la fórmula de ruptura sea inútil. El atributo wk break formula se ignora si la tabla no tiene fuente de datos o si la línea es un encabezado. Una línea de ruptura debe ser adyacente a la línea repetida (ya sea antes o después), o a otra línea de interrupción, de lo contrario se ignora.

Gracias a la expresión This.breakItems puede utilizar esta funcionalidad, por ejemplo, para mostrar la media total de las líneas repetidas dentro de una línea de interrupción. breakItems es un subconjunto evaluado de la fuente de datos de la tabla, ya sea una selección de entidades si la fuente de datos de la tabla es una selección de entidades, o una colección si la fuente de datos es una colección. Así, dentro de una línea de ruptura, puede escribir: This.breakItems.sum("salario")

Para crear líneas de ruptura:

1. Ordene la fuente de datos con los niveles correspondientes a las rupturas que desea mostrar, por ejemplo, ds.People.all().orderBy("continent asc, country asc, city asc")
2. Dibuje la(s) líneas(s) de ruptura en la plantilla de tabla. Si los saltos se encuentran después de la línea repetida, deben coincidir con el orden inverso de la fuente de datos, y si se encuentran antes de la línea repetida, deben coincidir con el mismo orden de la fuente de datos.
3. Defina el atributo wk break formula para la(s) línea(s) seleccionada(s):

Cuando se utiliza en una fórmula dentro de la tabla, la palabra clave This da acceso a diferentes datos según el contexto:

En cualquier otro contexto, estas expresiones devolverán undefined.

Nota: para más información sobre la inserción de fórmulas, ver WP INSERT FORMULA.

Cuando se llena una tabla desde una fuente de datos, las filas se crean automáticamente cuando se calculan las referencias. Se pueden insertar o eliminar líneas, editar el contenido de las celdas, cambiar el estilo, etc:

Sin embargo, tenga en cuenta que si la fuente de datos de la tabla se vuelve a calcular, toda modificación realizada en las líneas calculadas (excepto en la primera línea) se pierde. Por otro lado, como la primera línea es la línea repetida, cualquier modificación realizada en esta línea se propagará a todas las líneas si se vuelve a calcular la fuente de datos de la tabla. Lo mismo ocurre con las líneas de interrupción, todas las modificaciones realizadas en las líneas de ruptura calculadas se pierden, excepto en el caso de las líneas de ruptura de plantilla (que pueden estar situadas al final o al principio de la tabla).

Por ejemplo:

Después de volver a calcular las expresiones:

Cuando el cursor se inserta en una celda de una tabla llenada con una fuente de datos, aparece un icono de advertencia a la izquierda junto con un consejo que muestra información:

Cuando las fórmulas se muestran como referencias o cuando se guarda el documento, sólo se muestra/guarda la primera fila como plantilla (si las fórmulas no están congeladas).

Cuando se congelan las fórmulas, la tabla se convierte en una tabla estándar y se restablece la fuente de datos de la tabla.

Nota: la acción estándar freezeExpressions no recalcula las fórmulas.