4D Doc Center : LISTBOX Get information

4D v12.4

LISTBOX Get information


LISTBOX Get information ( {* ;} objeto ; info ) -> Resultado

Parámetro	Tipo	Descripción
*		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 títulos y las barras de desplazamiento del objeto list box designado utilizando 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 “List Box”:

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

Las primeras seis constantes son útiles para calcular el tamaño de un área de list box en un formulario.
Cuando utilice las constantes Position listbox hor scrollbar o Position listbox ver scrollbar, el comando LISTBOX Get information 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.

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