WP Insert table

4D v20 R7

WP Insert table


WP Insert table ( objRango ; modo {; actRango {; numCol {; numFilas}}} ) -> Resultado

Parámetro	Tipo	Descripción
objRango	Objeto	Rango
modo	Entero largo	Modo de inserción
actRango	Entero largo	Modo de actualización de rango
numCol	Entero largo	Número de columnas a definir en la tabla
numFilas	Entero largo	Número de filas a definir en la tabla
Resultado	Objeto	Objeto de referencia de tabla

Descripción

El comando WP Insert table inserta una nueva tabla en objRango de acuerdo con el modo de inserción especificado y devuelve el nuevo objeto tabla correspondiente. Opcionalmente, puede pasar un parámetro actRango así como también un número predefinido de columnas y filas en numCol y numFilas.

En objRango, pase:

un rango, o
un elemento (tabla / párrafo / cuerpo / encabezado / pie / imagen en línea / sección / subsección), o
documento 4D Write Pro.

Nota: si objRango es una tabla, la nueva tabla insertada reemplazará o se insertará antes o después de la misma, según el modo utilizado. Insertar una tabla dentro de otra tabla no es posible.

En el parámetro modo, pase una de las siguientes constantes para indicar el modo de inserción que se utilizará para la tabla en el documento:

Constante	Tipo	Valor	Comentario
wk append	Entero largo	2	Inserta contenidos al final del rango
wk prepend	Entero largo	1	Insertar contenidos al principio del rango
wk replace	Entero largo	0	Remplazar el contenido de la página

Si objRango es un rango, puede utilizar el parámetro opcional actRango, para pasar una de las siguientes constantes para especificar si la tabla insertada se incluye o no en el rango resultante:

Constante	Tipo	Valor	Comentario
wk exclude from range	Entero largo	1	Contenidos insertados no incluidos en el rango actualizado
wk include in range	Entero largo	0	Contenido insertado incluido en el rango actualizado (predeterminado)

Si no pasa un parámetro actRango, de forma predeterminada, la tabla insertada se incluye en el rango resultante.

If targetObj is not a range, rangeUpdate is ignored.

Puede pasar en numCol y numFilas el número de columnas y filas a definir en la tabla. Por defecto, si se omiten numCol y numFilas, se crea una nueva tabla con columna 0 y fila 0. A continuación, podrá agregar estos elementos utilizando el comando WP Table append row.

El comando devuelve la nueva tabla como un objeto de tabla, que puede pasar a continuación a los demás comandos de tabla WP. La tabla se crea con los atributos predeterminados de fuente, borde y color que puede personalizar utilizando el comando WP SET ATTRIBUTES.

Ejemplo

En un documento en blanco, usted desea agregar una nueva tabla con 3 columnas y 2 filas:

 C_OBJECT($WPRange;$WPTable)

 $WPRange:=WP Text range(WParea;wk start text;wk end text)

 $WPTable:=WP Insert table($WPRange;wk append;wk exclude from range;3;2)

Resultado:

Ver también

WP Table append row
WP Table get rows