4D Doc Center : LISTBOX Get information

4D v13.4

LISTBOX Get information


LISTBOX Get information ( {* ;} objeto ; info ) -> 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 )
info	Entero largo	Información a obtener
Resultado	Entero largo	Valor actual

Descripción

El comando LISTBOX Get information devuelve diferente información relacionada con el tamaño y la visibilidad de los encabezados, pies y barras de desplazamiento del objeto 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 .

En el parámetro info, pase un valor indicando el tipo de información que quiere obtener. Puede utilizar un valor o una de las siguientes constantes del tema Listbox:

Constante	Tipo	Valor	Comentario
Listbox display footer	Entero largo	8	0=oculto, 1=se muestra
Listbox display header	Entero largo	0	0=oculto, 1=se muestra
Listbox display hor scrollbar	Entero largo	2	0=oculto, 1=se muestra
Listbox display ver scrollbar	Entero largo	4	0=oculto, 1=se muestra
Listbox footer height	Entero largo	9	Altura en píxeles
Listbox header height	Entero largo	1	Altura en píxeles
Listbox hor scrollbar height	Entero largo	3	Altura en píxeles
Listbox hor scrollbar position	Entero largo	6	Posición del cursor en píxeles
Listbox ver scrollbar position	Entero largo	7	Posición del cursor en píxeles
Listbox ver scrollbar width	Entero largo	5	Ancho en píxeles

Las primeras constantes son útiles para calcular el tamaño de un área de list box mostrada en el formulario.
Cuando utilice las constantes Position listbox hor scrollbar o Position listbox ver scrollbar, el comando devuelve la posición del cursor de desplazamiento en relación con su posición original, es decir el tamaño de la parte oculta de la ventana, expresado en píxeles. Por defecto, esta posición corresponde a 0. Combinando, por ejemplo, con información relativa a la altura de la fila, este valor le permite encontrar el contenido mostrado en el listbox.
La instrucción LISTBOX Get information(vLB;Listbox footer height) devuelve el mismo valor que el comando LISTBOX Get footers height cuando los pies se muestran. Sin embargo, si los pies no se muestran, LISTBOX Get information devuelve 0 mientras LISTBOX Get footers height devuelve la altura, en este caso teórica, de los pies.

Ejemplo

Dado un list box que contiene filas con una altura de 20 píxeles cada una. Se ejecuta la siguiente instrucción:

$scroll:=LISTBOX Get information(*;"Listbox";Position listbox ver scrollbar)

Si, por ejemplo, $scroll devuelve 200, usted puede concluir que la decimoprimera fila es actualmente la primera mostrada en el list box (200/20=10, por lo tanto 10 filas están ocultas).