Versión: 21

Objeto List Box

List box de tipo array

En un list box de tipo array, cada columna debe estar asociada a un array unidimensional 4D; se pueden utilizar todos los tipos de array, a excepción de los arrays de punteros. El número de líneas se basa en el número de elementos del array.

Por defecto, 4D asigna el nombre "ColumnX" a cada columna. Puede cambiarlo, así como las otras propiedades de la columna, en las propiedades de las columnas. El formato de visualización de cada columna también puede definirse mediante el comando OBJECT SET FORMAT.

Los list boxes de tipo array pueden mostrarse en modo jerárquico, con mecanismos específicos.

Con los list box de tipo array, los valores introducidos o mostrados se gestionan utilizando el lenguaje 4D. También puede asociar una lista de opciones con una columna para controlar la entrada de datos. Los valores de las columnas se gestionan mediante comandos de alto nivel de List box (como LISTBOX INSERT ROWS o LISTBOX DELETE ROWS), así como comandos de manipulación de arrays. Por ejemplo, para inicializar el contenido de una columna, puede utilizar la siguiente instrucción:

ARRAY TEXT(varCol;size)

También puede utilizar una lista:

LIST TO ARRAY("ListName";varCol)

Atención: cuando un objeto List box contiene varias columnas de diferentes tamaños, sólo se mostrará el número de elementos del array (columna) más pequeño. Debe asegurarse de que cada array tenga el mismo número de elementos que los demás. Además, si una columna del list box está vacía (esto ocurre cuando el array asociado no fue declarado o dimensionado correctamente con el lenguaje), el list box no muestra nada.

List box de tipo selección

En este tipo de list box, cada columna puede estar asociada a un campo (por ejemplo [Employees]LastName) o a una expresión. La expresión puede basarse en uno o más campos (por ejemplo, [Employees]FirstName+" "[Employees]LastName) o puede ser simplemente una fórmula (por ejemplo String(Milliseconds)). La expresión también puede ser un método proyecto, una variable o un elemento de array. Puede utilizar los comandos LISTBOX SET COLUMN FORMULA y LISTBOX INSERT COLUMN FORMULA para modificar columnas por programación.

El contenido de cada fila se evalúa según una selección de registros: la selección actual de una tabla o una selección temporal.

En el caso de un list box basado en la selección actual de una tabla, cualquier modificación realizada desde la base de datos se refleja automáticamente en el list box, y viceversa. Por lo tanto, la selección actual es siempre la misma en ambos lugares.

List box colección o entity selection

En este tipo de list box, cada columna debe estar asociada a una expresión. El contenido de cada línea se evalúa entonces por elemento de la colección o por entidad de la selección de entidades.

Cada elemento de la colección o cada entidad está disponible como un objeto al que se puede acceder a través de la palabra clave This. Una expresión de columna puede ser una ruta de propiedad, un método proyecto, una variable o cualquier fórmula, accediendo a cada entidad u objeto elemento de colección a través de This, por ejemplo This.<propertyPath> (o This.value en caso de una colección de valores escalares). La expresión también puede ser un método proyecto, una variable o un elemento de array.

Cuando la fuente de datos es una entity selection, cualquier modificación realizada del lado del list box se guarda automáticamente en la base de datos. Por otro lado, las modificaciones realizadas en la base de datos son visibles en el list box después de que se hayan recargado las entidades modificadas.

nota

Cuando se eliminan entidades, sus referencias permanecen en la selección de entidades con un valor undefined, por lo que aparecen filas en blanco en el list box. En este caso, puede llamar a la función .clean() para obtener una nueva selección de entidades pero sin las referencias de entidades eliminadas.

Cuando la fuente de datos es una colección, toda modificación realizada en los valores del list box se refleja en la colección. Cuando la fuente de datos es una colección, toda modificación realizada en los valores del list box se refleja en la colección. Por ejemplo:

myCol:=myCol.push("new value") //mostrar el nuevo valor en el list box

Propiedades soportadas

Las propiedades soportadas dependen del tipo de list box.

Propiedad	List box array	List box selección	List box colección o entity selection
Color de fondo alterno	X	X	X
Color de fondo	X	X	X
Negrita	X	X	X
Expresión del color de fondo		X	X
Estilo de línea de borde	X	X	X
Inferior	X	X	X
Colección o entity selection		X	X
Redimensionamiento automático de columnas	X	X	X
Elemento actual			X
Posición actual del elemento			X
Fuente de datos	X	X	X
Nombre del formulario detallado		X
Mostrar encabezados	X	X	X
Mostrar pies de página	X	X	X
Doble clic en la fila		X
Arrastrable	X	X	X
Soltable	X	X	X
Enfocable	X	X	X
Fuente	X	X	X
Color de fuente	X	X	X
Expresión de color de fuente		X	X
Tamaño de fuente	X	X	X
Altura (list box)	X	X	X
Altura (encabezados)	X	X	X
Altura (pies de página)	X	X	X
Ocultar líneas en blanco adicionales	X	X	X
Ocultar rectángulo de enfoque	X	X	X
Ocultar resaltado de selección	X	X	X
List Box jerárquico	X
Conjunto de resaltado		X
Alineación horizontal	X	X	X
Color de línea horizontal	X	X	X
Relleno horizontal	X	X	X
Barra de desplazamiento horizontal	X	X	X
Tamaño horizontal	X	X	X
Itálica	X	X	X
Izquierda	X	X	X
Tabla maestra		X
Expresión info Meta			X
Método	X	X	X
Líneas móviles	X
Selección temporal		X
Número de columnas	X	X	X
Número de columnas bloqueadas	X	X	X
Número de columnas estáticas	X	X	X
Nombre del objeto	X	X	X
Derecha	X	X	X
Array de colores de fondo de fila	X
Array de control de filas	X
Array color de fuente de fila	X
Altura de línea	X
Array altura de línea	X
Array de estilo de línea	X
Elementos seleccionados			X
Modo de selección	X	X	X
Edición con un solo clic	X	X	X
Ordenable	X	X	X
Acción estándar	X
Expresión de estilo		X	X
Superior	X	X	X
Transparente	X	X	X
Tipo	X	X	X
Subrayado	X	X	X
Variable o Expresión	X	X
Alineación vertical	X	X	X
Color de línea vertical	X	X	X
Relleno vertical	X	X	X
Barra de desplazamiento vertical	X	X	X
Tamaño vertical	X	X	X
Visibilidad	X	X	X
Ancho	X	X	X

Las columnas, los encabezados y los pies de list box soportan propiedades específicas.

Eventos de formulario soportados

Evento formulario	Propiedades adicionales devueltas (ver Evento formulario para las propiedades principales)	Comentarios
On After Edit	column columnName row
On After Keystroke	column columnName row
On After Sort	columna nombreColumna headerName	*Las fórmulas compuestas no se pueden ordenar. (por ejemplo, This.firstName + This.lastName)_
On Alternative Click	column columnName row	List box array únicamente
On Before Data Entry	column columnName row
On Before Keystroke	column columnName row
On Begin Drag Over	column columnName row
On Clicked	column columnName row
On Close Detail	fila	List box Selección actual y Selección temporal únicamente
On Collapse	column columnName row	List box jerárquicos únicamente
On Column Moved	columnName newPosition oldPosition
On Column Resize	columna columnName nuevoTamaño tamañoantiguo
On Data Change	column columnName row
On Delete Action	fila
On Display Detail	isRowSelected row
On Double Clicked	column columnName row
On Drag Over	area areaName columna columnName fila
On Drop	column columnName row
On Expand	column columnName row	List box jerárquicos únicamente
On Footer Click	columna nombreColumna footerName	List box arrays, selección actual y selección temporal únicamente
On Getting Focus	column columnName row	Propiedades adicionales devueltas sólo al editar una celda
On Header Click	columna nombreColumna headerName
On Load
On Losing Focus	column columnName row	Propiedades adicionales devueltas sólo cuando la modificación de una celda se completa
On Mouse Enter	area areaName columna columnName fila
On Mouse Leave
On Mouse Move	area areaName columna columnName fila
On Open Detail	fila	List box Selección actual y Selección temporal únicamente
On Row Moved	newPosition oldPosition	List box array únicamente
On Scroll	horizontalScroll verticalScroll
On Selection Change
On Unload
On Validate

Propiedades adicionales

Los eventos formulario de los objetos list box o columnas de list box pueden devolver las siguientes propiedades adicionales:

Propiedad	Tipo	Descripción
area	text	Área de objeto list box ("header", "footer", "cell")
areaName	text	Nombre del área
column	entero largo	Número de columna
columnName	text	Nombre de la columna
footerName	text	Nombre del pie
headerName	text	Nombre del encabezado
horizontalScroll	entero largo	Positivo si el desplazamiento es hacia la derecha, negativo si es hacia la izquierda
isRowSelected	boolean	True si la línea está seleccionada, de lo contrario False
newPosition	entero largo	Nueva posición de la columna o línea
newSize	entero largo	Nuevo tamaño (en píxeles) de la columna o línea
oldPosition	entero largo	Posición anterior de la columna o línea
oldSize	entero largo	Tamaño anterior (en píxeles) de la columna o línea
row	entero largo	Número de línea
verticalScroll	entero largo	Positivo si el desplazamiento es hacia abajo, negativo si es hacia arriba

Si un evento se produce en una columna o línea "fake" que no existe, se suele devolver una cadena vacía.

List box de tipo array​

List box de tipo selección​

List box colección o entity selection​

Propiedades soportadas​

Eventos de formulario soportados​