LISTBOX GET ARRAYS

4D v20 R7

LISTBOX GET ARRAYS


LISTBOX GET ARRAYS ( {* ;} objeto ; arrNomsCols ; arrNomsEncabezados ; arrVarCols ; arrVarEncabezados ; arrColsVisibles ; arrEstilos {; arrNomsPies ; arrVarsPies} )

Parámetro	Tipo	Descripción
*	Operador	Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es una variable
objeto	Objeto de formulario	Nombre de objeto (si se especifica ) o Variable (si se omite )
arrNomsCols	Array texto	Nombres de objeto de las columnas
arrNomsEncabezados	Array texto	Nombres de objeto de los títulos
arrVarCols	Array puntero	Punteros hacia las variables de las columnas
arrVarEncabezados	Array puntero	Punteros hacia campos o Nil
arrColsVisibles	Array booleano	Visibilidad de cada columna
arrEstilos	Array puntero	Punteros a los arrays o a las variables de estilos de colores y de visibilidad o Nil
arrNomsPies	Array texto	Nombres de los objetos de pies de columna
arrVarsPies	Array puntero	Punteros a las variables de pies de columna

Descripción

El comando LISTBOX GET ARRAYS devuelve un conjunto de arrays sincronizados ofreciendo información sobre cada columna (visible o invisible) del list box designado por los parámetros objeto y *.

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

Una vez se ejecuta el comando:

El array arrNomsCols contiene la lista de los nombres de los objetos para cada columna del list box.
El array arrNomsEncabezados contiene la lista de los nombres de los objetos para cada título de columna del list box.
El array arrVarCols contiene los punteros hacia las variables (arrays) asociadas a cada columna del list box. Para un listbox de tipo selección, arrVarCols contiene:
- Para una columna asociada a un campo, un puntero al campo asociado,
- Para una columna asociada a una variable, un puntero a la variable,
- Para una columna asociada a una expresión, un puntero Nil.
El array arrVarEncabezados contiene punteros hacia las variables asociadas a cada título de columna del list box.
El array arrColsVisibles contiene un valor Booleano para cada columna, indicando si la columna es visible (True) o oculta (False) en el list box.
El array arrEstilos contiene, para un list box de tipo array, cuatro hacia cuatro arrays que permiten aplicar individualmente un estilo, un color de fuente, un color de fondo y un control de visualización personalizado a cada fila del list box. Estos arrays son asociados al list box en la Lista de propiedades del modo Diseño o vía el comando LISTBOX SET ARRAY. Si un array no es especificado para el list box, el elemento correspondiente en arrEstilos contendrá un puntero Nil.
El cuarto del puntero corresponde ya sea a un array booleano (array de líneas ocultas), o a un array entero largo (array utilizado para definir las líneas ocultas, desactivadas y no seleccionables), en función de la implementación utilizada para el array de control de líneas (ver Propiedades específicas de los list box).
Para un list box de tipo selección, colección o selección de entidades, arrEstilos contiene:
- Por cada configuración definida vía una variable, un puntero a la variable,
- Por cada configuración definida vía una expresión, un puntero Nil.

Ver también

LISTBOX Get array
LISTBOX Get property
LISTBOX SET ARRAY