INSERT LISTBOX COLUMN

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


INSERT LISTBOX COLUMN ({*; }objeto; posicionCol; nomCol; variableCol; nomTitulo; varTitulo)

ParámetroTipoDescripción
*Si se especifica, objeto es un nombre de objeto (cadena)
Si se omite, objeto es una variable
objetoObjeto de formularioNombre de objeto (si se especifica *) o
Variable (si se omite *)
posicionColNuméricoUbicación de la columna a insertar
nomColCadenaNombre del objeto de la columna
variableColArray | Campo | VarNombre de la variable de la columna
nomTituloCadenaNombre del objeto del título de la columna
varTituloVariable enteraVariable de título de la columna

Descripción

El comando INSERT LISTBOX COLUMN inserta una columna en el list box designado por los parámetros objeto y *.

Si usted pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si omite este parámetro, indica que el parámetro objeto es una variable. En ese caso, no pasa una cadena, sino una referencia de variable. Para mayor información sobre nombres de objetos, consulte la sección Propiedades de los objetos.

La nueva columna se inserta justo en frente de la columna definida por el parámetro posicionCol. Si el parámetro posicionCol es superior al número total de columnas, la columna se añade después de la última columna.

Pase el nombre del objeto y de la variable de la columna insertada en los parámetros nomCol y variableCol.

Con un array tipo list box, el nombre de la variable debe coincidir con el nombre del array cuyo contenido se mostrará en la columna.

Con una selección tipo list box, debe pasar un campo o variable en el parámetro variableCol. El contenido de la columna será entonces el valor del campo o de la variable, evaluado para cada registro de la selección asociada al list box. Este tipo de contenidos sólo puede ser utilizado cuando la propiedad "Fuente de datos" del list box es Selección actual o Selección temporal (ver la sección Gestión de los objetos de tipo list box). Puede utilizar los campos o las variables de tipo cadena, numérico, Fecha, Hora, Imagen y Booleano.

En el contexto de list boxes basadas en selecciones, INSERT LISTBOX COLUMN puede ser utilizado para insertar elementos simples (campos o variables). Si quiere manipular expresiones más complejas (tales como fórmulas o métodos), debe utilizar el comando INSERT LISTBOX COLUMN FORMULA.

Nota: No es posible combinar en un mismo list box columnas de tipo array (fuente de datos array) y columnas de tipo campo o variable (fuente de datos selección).

El nombre de la variable debe corresponder al nombre del array cuyo contenido será mostrado en la columna.

Pase el nombre del objeto y de la variable del título de la columna insertada en los parámetros nomTitulo y varTitulo Parámetros.

Nota: Los nombres de los objetos deben ser únicos en un formulario. Debe asegurarse de que los nombres pasados en los parámetros nomCol y nomTitulo no hayan sido utilizados. De lo contrario, la columna no sea crea y se genera un error.

Ejemplos

1. Nos gustaría añadir una columna al final del list box:

   C_LONGINT(NomVarTitulo;$Ultimo;RecNum)
   ALL RECORDS([Tabla 1])
   $RecNum:=Records in table([Tabla 1])
   ARRAY PICTURE(Imagen;$RecNum)

   $Ultimo:=Get number of listbox columns(*;"ListBox1")+1
   INSERT LISTBOX COLUMN(*;"ListBox1";$Ultimo;"ColumnImagen";Imagen;"imagenTitulo";NomVarTitulo)

2. Nos gustaría añadir una columna a la derecha del list box y asociarle los valores del campo [Transporte]Tarifas :

   $Ultimo:=Get number of listbox columns(*;"ListBox1")+1
    INSERT LISTBOX COLUMN(*;"ListBox1";$Ultimo;"CampoCol";[Transporte]Tarifas;"nomTitulo";varTitulo)

Ver también

DELETE LISTBOX COLUMN, INSERT LISTBOX COLUMN FORMULA.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente