WP Insert table

4D v17

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 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.

Nota: no es posible insertar una tabla dentro de otra tabla (se devuelve un error).

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	Insertar 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

En el parámetro opcional actRango, puede pasar una de las siguientes constantes para especificar si la tabla insertada se incluye o no en el rango:

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.

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 Create 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