SET LIST PROPERTIES

4D v16.3

SET LIST PROPERTIES


SET LIST PROPERTIES ( lista ; apariencia {; icono {; altoLinea {; dobleClic {; multiSeleccion {; editable}}}}} )

Parámetro	Tipo	Descripción
lista	ListRef	Número de referencia de la lista
apariencia	Entero largo	Estilo gráfico de la lista 1 = Lista jerárquica a la Macintosh 2 = Lista jerárquica a la Windows 0 = Aparición auto dependiendo de la plataforma
icono	Entero largo	ID de recurso Mac OS ‘cicn’ o 0 = icono por defecto de la plataforma
altoLinea	Entero largo	Altura mínima de la línea expresada en píxeles
dobleClic	Entero largo	Desplegar/Contraer sublista con doble-clic 0 = Sí, 1= No
multiSeleccion	Entero largo	Selecciones múltiples: 0 = No (por defecto), 1 = Sí
editable	Entero largo	0 = Lista no editable por el usuario, 1 = Lista editable por el usuario (por defecto)

Descripción

El comando SET LIST PROPERTIES define el alto de línea y el funcionamiento de las lista jerárquica cuya referencia se pasa en el parámetro lista.

Nota de compatibilidad: los parámetros apariencia e icono son obsoletos, siempre deben tomar el valor 0.

Nota: si desea personalizar el icono de cada elemento en la lista, utilice el comando SET LIST ITEM PROPERTIES.

Si no pasa el parámetro altoLinea, la altura de línea de una lista jerárquica es determinada por la fuente y el tamaño de fuente utilizado por el objeto. También puede pasar en parámetro altoLinea la altura de línea mínima de la lista jerárquica. Si el valor que pasa es superior a la altura de las líneas definida por la fuente y el tamaño de fuente utilizado, la altura de las líneas de la lista jerárquicas será el valor pasado.Pase 0 para definir la altura por defecto.

Nota: SET LIST PROPERTIES afecta la apariencia de los nodos en la lista jerárquica. Si prefiere personalizar el icono de cada elemento en la lista, utilice el comando SET LIST ITEM PROPERTIES.

El parámetro opcional dobleClic le permite definir que un doble clic en un elemento de la lista padre no provoque el despliegue o contracción de la sublista. Por defecto, un doble clic en un elemento de la lista padre provoca que su lista hijo se expanda o se contraiga. Sin embargo, algunas interfaces de usuario podrían necesita desactivar este mecanismo. Para hacer esto, pase 1 en el parámetro dobleClic.

Sólo se desactivará doble-clic. Los usuarios aún podrán expandir o contraer las sublistas haciendo clic en el nodo de la lista.

Si omite el parámetro dobleClic o pasa 0, se aplica el funcionamiento por defecto.

El parámetro opcional multiSeleccion le permite indicar si la lista debe aceptar selecciones múltiples.

Por defecto, como en versiones anteriores de 4D, usted no puede seleccionar varios elementos de una lista jerárquica simultáneamente. Si quiere que esta función esté disponible para la lista, pase el valor 1 en el parámetro multiSeleccion. En ese caso, las selecciones múltiples pueden efectuarse:

- manualmente, utilizando la combinación de teclas Mayús+clic para una selección continúa o Ctrl+clic (Windows) / comando+clic (Mac OS) para una selección discontinúa,
- por programación, utilizando los comandos SELECT LIST ITEMS BY POSITION y SELECT LIST ITEMS BY REFERENCE.
Si pasa 0 y omite el parámetro multiSeleccion, se aplicará el comportamiento por defecto.

El parámetro opcional editable le permite indicar si la lista debe ser editable por el usuario cuando se muestra como una lista de selección asociada a un campo o a una variable durante la entrada de datos. Cuando la lista es editable, un botón Modificar se añade en la ventana de la lista y el usuario puede añadir, borrar y ordenar los valores a través de un editor específico.
Si pasa 1 u omite el parámetro editable, la lista será editable; si pasa 0, no será editable.

Ejemplo

Desea rechazar la sublista de expandir/contraer al hacer doble clic. Puede escribir en el método de formulario:

 Case of

    :(Form event=On Load)

       hlCities:=Load list("Cities") //cargar la lista de opciones Cities en el objeto de formulario hlCities

       SET LIST PROPERTIES(hlCities;0;0;0;1) //no permitir doble clic para expandir/contraer

 End case

Ver también

GET LIST ITEM PROPERTIES
GET LIST PROPERTIES
SET LIST ITEM PROPERTIES