Saltar al contenido principal
Versión: Siguiente

LISTBOX Get array

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

ParámetroTipoDescripción
*OperadorSi se especifica, objeto es un nombre de objeto (cadena)
Si se omite, objeto es una variable
objetoanyNombre de objeto (si * se especifica) o
Variable (si * se omite)
tipoArrayIntegerTipo de array
ResultadoPointerPuntero al array asociado a la propiedad

Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.

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":

ConstanteTipoValorComentario
lk background color arrayEntero largo1
lk control arrayEntero largo3
lk font color arrayEntero largo0
lk row height arrayEntero largo4(Licencia 4D View Pro requerida)
lk style arrayEntero largo2

El comando devuelve uno de los siguientes valores:

  • Is nil pointer 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