4D Doc Center : LISTBOX GET ARRAYS

4D v13.4

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 cadena	Nombres de objeto de las columnas
arrNomsEncabezados	Array cadena	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 cadena	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 los tres punteros hacia los tres arrays que permiten aplicar un estilo específico, un color de fuente y un color de fondo a cada fila del list box. Estos arrays son asociados en el list box en la Lista de propiedades del entorno Diseño. Si un array no es especificado para el list box, el elemento correspondiente en arrEstilos contendrá un puntero Nil.
Para un list box de tipo selección, 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.