LISTBOX Get array

4D v16.3

LISTBOX Get array


LISTBOX Get array ( {* ;} objeto ; tipoArray ) -> Resultado

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)
tipoArray	Entero largo	Tipo de array
Resultado	Puntero	Puntero al array asociado a la propiedad

Descripción

Nota: este comando sólo funciona con los list box de tipo array.

El comando LISTBOX Get array devuelve un puntero al array tipoArray del list box o de la columna de list box designada por los parámetros objeto y * .

Los arrays de estilo, de color, de color de fondo o de control de líneas pueden estar asociados a los list box de tipo de array o (excepto el array de control de líneas) a las columnas de list box array usando la lista de propiedades en modo Diseño o el comando LISTBOX SET ARRAY.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si no se pasa este parámetro, indica que el parámetro objeto es una variable. En este caso, se pasa una referencia de variable en lugar de una cadena. Puede designar un list box o una columna de list box como parámetro objeto.

Pase en tipoArray, el tipo de array de propiedad a obtener. Puede utilizar una de las siguientes constantes, del tema "Listbox":

Constante	Tipo	Valor	Comentario
lk background color array	Entero largo	1
lk control array	Entero largo	3
lk font color array	Entero largo	0
lk row height array	Entero largo	4	(Licencia 4D View Pro requerida)
lk style array	Entero largo	2

El comando devuelve uno de los siguientes valores:

Nil si ningún array de la propiedad solicitada está asociado a la columna o al list box.
un puntero al array de la propiedad solicitada, definido por el usuario.
un puntero al array de la propiedad solicitada, definido dinámicamente cuando se llama al comando LISTBOX SET ROW COLOR o LISTBOX SET ROW FONT STYLE

Ejemplo

Ejemplos típicos de uso:

 vPtr:=LISTBOX Get array(*;"MyLB";lk font color array)

  // devuelve un puntero al array de colores de fuente

  // asociado al list box "MyLB"

 

 vPtr:=LISTBOX Get array(*;"Col4";lk style array)

  // devuelve un puntero al array de estilos de fuente

  // asociado a la columna de list box "Col4"

Ver también

LISTBOX GET ARRAYS
LISTBOX SET ARRAY