<Table>.Add (Función)

Condiciones de uso
Características de una fila
Posición de la fila agregada
Límites: Número máximo de filas mostradas
Notas adicionales
Agregar filas
Entrada en cascada
Control Tabla/Tabla TreeView archivo de datos : Modificaciones en el archivo de datos relacionado
Control Tabla/Tabla TreeView archivo de datos : Agregar varias filas
Añadiendo un Record en un control Tabla navegando y soltando un gatillo
Control Tabla\Tabla TreeView archivo de datos en edición
Agregar imágenes

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

<Table>.Add (Función)

Agrega una fila en:

un control Tabla,
un control Tabla TreeView,
un control Combo Box "con tabla" (control Tabla mostrado en un control Combo Box).

Observación: Se recomienda utilizar la función <Tabla>.AddLine. La función <Tabla>.AddLine permite agregar:

TAB en las columnas,
todo tipo de valores en las columnas.

Versiones 18 y posteriores

Esta función permite manipular los controles Tabla TreeView en sitios WEBDEV y PHP.

Nueva funcionalidad versión 18

Esta función permite manipular los controles Tabla TreeView en sitios WEBDEV y PHP.

Esta función permite manipular los controles Tabla TreeView en sitios WEBDEV y PHP.

Versiones 19 y posteriores

Esta función ahora está disponible en el código Navegador para los controles Tabla en modo navegador.

Nueva funcionalidad versión 19

Esta función ahora está disponible en el código Navegador para los controles Tabla en modo navegador.

Versiones 20 y posteriores

Esta función ahora está disponible para aplicaciones Android.

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Nueva funcionalidad versión 20

Esta función ahora está disponible para aplicaciones Android.

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Esta función ahora está disponible para aplicaciones Android.

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Ejemplo

// Add "Moore", "Vince" and "06/21/72"
// at the end of the "TABLE_CustomerTable" control
ResAdd = TABLE_CustomerTable.Add("Moore" + TAB + "Vince" + TAB + "06/21/72")

Sintaxis

<Result> = <Table control>.añadir([<Row>])

<Result>: Boolean

True si se agregó el elemento,
False en caso contrario.

<Table control>: Control name

Nombre del control a manipular. Este control puede corresponder a:
un control Tabla.
un control Tabla TreeView.
un control Combo Box con tabla.

<Row>: Optional character string

Fila por agregar. Esta fila tiene el siguiente formato:

<Element of column 1> + TAB + <Element of column 2> + TAB + ...

Si no se especifica este parámetro, se agregará una fila vacía en el control.. Para un control archivo de datos, se tienen en cuenta los valores por defecto definidos en el archivo de datos relacionado.

Observaciones

Condiciones de uso

<Table>.Add puede ser usado en:

un control archivo de datos o memoria,
un control de selección única o de selección múltiple.
Recordatorio: La selección múltiple no está disponible en los controles Tabla en modo clásico.

Esta función está disponible para los controles Tabla en modo Ajax, los controles Tabla en modo clásico y los controles Tabla TreeView..

Esta función solo está disponible para los controles Tabla en modo navegador.

El control Tabla TreeView no está disponible.

Los controles Tabla archivo de datos no están disponibles en edición. <Table>.Add no puede ser usado en una navegación control Tabla.

Características de una fila

Cada elemento agregado se convierte en el tipo de columna relacionada.
Para no especificar ningún valor para un elemento, utilice una cadena vacía ("") o 0 (según el tipo de columna).. Por ejemplo:

TABLE_CustomerTable.Add("Moore" + TAB + "Vince" + TAB + "" + TAB + "06/21/72")
Si un elemento corresponde al resultado de un cálculo, la expresión numérica debe estar entre paréntesis.. Por ejemplo:

TABLE_CalculationTable.Add((53+29) + TAB + (83-21))

Posición de la fila agregada

De forma predeterminada, la fila se agrega al final de las filas que se muestran en el control.

Caso especial:

Si se ordena el control con la función <Tabla>.ordenación, la fila agregada se posiciona en el control de acuerdo con el orden que se haya definido.
Si es el usuario quien ordena el control, el orden no se tiene en cuenta al insertar la fila.. La fila se agrega al final del control.

Límites: Número máximo de filas mostradas

El número máximo de filas que se pueden mostrar en un control Tabla o Tabla TreeView está limitado por la cantidad de memoria disponible (máximo teórico: 2 mil millones de filas).

Sin embargo, no se recomienda utilizar controles Tabla o Tabla TreeView con un gran número de filas por motivos de rendimiento y facilidad de uso (por ejemplo, el tiempo necesario para rellenar el control).

Notas adicionales

Para agregar una fila en una posición específica de un control Tabla o Tabla TreeView, utilice la función <Tabla>.InsertLine.
Si la fila agregada es la primera fila del control, esta fila se convierte en la fila activa.

Agregar filas

La propiedad ..NewLine permite saber si la fila seleccionada se creó con la función <Table>.Add (..NewLine = True).

Entrada en cascada

Para realizar una entrada en cascada, utilice la función <Table>.Add en el evento "Salida de una fila" del control Tabla de la siguiente manera:

IF TABLE_CustomerTable..NewLine THEN
TABLE_CustomerTable.Add()
END

Este modo de funcionamiento solo está disponible para los controles Tabla en modo Ajax..

Control Tabla/Tabla TreeView archivo de datos : Modificaciones en el archivo de datos relacionado

Si la entrada en cascada está habilitada, el archivo de datos relacionado con el control se modifica automáticamente cuando el usuario pasa a la siguiente fila.
Si la entrada en cascada no está habilitada, el archivo de datos relacionado con el control no se modifica.. Para escribir el contenido del fila agregado en el archivo de datos de relacionado, debe usarse <Tabla>.Save después de <Table>.Add.

Observaciones:

La opción "Entrada de datos en cascada (Agregar)" puede ser seleccionada en la pestaña "Detalles" del control description.
La entrada en cascada no está disponible en los controles Tabla archivo de datos con acceso directo.. Esta opción está disponible en los controles Tabla memoria y en los controles Tabla archivo de datos cargados en memoria.
Versiones 19 y posteriores
La entrada en cascada solo está disponible en los controles Tabla archivo de datos Ajax..
Nueva funcionalidad versión 19
La entrada en cascada solo está disponible en los controles Tabla archivo de datos Ajax..
La entrada en cascada solo está disponible en los controles Tabla archivo de datos Ajax..

Control Tabla/Tabla TreeView archivo de datos : Agregar varias filas

Cada vez que se llame a la función <Table>.Add en un control Tabla o Tabla TreeView archivo de datos, se crear una fila virtual en el control.. La información se guardará en el archivo de datos de relacionado sólo cuando se llame a <Tabla>.Save.

Si se llama a la función <Table>.Add sucesivamente en el mismo proceso sin llamar a la función <Tabla>.Save, solo la PRIMERA llamada es efectiva (las siguientes llamadas son ignoradas). Solo se agrega una fila al control Tabla/Tabla TreeView archivo de datos.

Este modo de funcionamiento está disponible solo para los controles Tabla archivo Ajax.

Añadiendo un Record en un control Tabla navegando y soltando un gatillo

Se puede disparar un trigger al agregar un registro a un control Tabla archivo de datos.. Consulte la documentación sobre la función HDescribeTrigger para obtener más detalles.

Este modo de funcionamiento está disponible solo para los controles Tabla archivo Ajax.

Control Tabla\Tabla TreeView archivo de datos en edición

Si se llama a la función <Table>.Add:

En un control Event, el cursor se posiciona automáticamente en la primera columna para editar en el fila añadido.
En un Event que no pertenece al control, (o en otro Process) se debe usar ReturnToCapture para reanudar la entrada en la Tabla o control Tabla TreeView.

Agregar imágenes

Para añadir un Image en una tabla o control Tabla TreeView:

indique directamente el nombre y la ruta completa de la imagen que se agregará.
Por ejemplo:

TABLE_MyTable.Add("C:\MyDocuments\MyImage.BMP")
indique la ruta y el nombre de la imagen que se agregará. La ruta es relativa al directorio "<Nombre_del_Proyecto>_WEB".
Por ejemplo:

// Adds the image found in the "WB_MyApp_WEB" directory
TABLE_MyTable.Add("MyImage.BMP")

Observación: La columna debe ser de tipo Imagen, de lo contrario, la imagen agregada no se mostrará correctamente.

Componente : wd250obj.dll

Ver también

Versión mínima requerida

Versión 23

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 06/05/2020

Señalar un error o enviar una sugerencia | Ayuda local