4D v16.3Gestión programada de los objetos de tipo List box |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
Gestión programada de los objetos de tipo List box
|
Comandos Prop. de los objetos | Objeto | Columna | Encabezado de columna | Pie de columna |
OBJECT MOVE | X | |||
OBJECT GET COORDINATES | X | X | X | X |
OBJECT SET RESIZING OPTIONS | X | |||
OBJECT GET RESIZING OPTIONS | X | |||
OBJECT GET BEST SIZE | X | |||
OBJECT SET FILTER | X | |||
OBJECT SET FORMAT | X | X | ||
OBJECT SET ENTERABLE | X | |||
OBJECT SET LIST BY NAME | X | |||
OBJECT SET TITLE | X | |||
OBJECT SET COLOR | X | X | X | X |
OBJECT SET RGB COLORS | X | X | X | X |
OBJECT SET FONT | X | X | X | X |
OBJECT SET FONT SIZE | X | X | X | X |
OBJECT SET FONT STYLE | X | X | X | X |
OBJECT SET HORIZONTAL ALIGNMENT | X | X | X | X |
OBJECT Get horizontal alignment | X | X | X | X |
OBJECT SET VERTICAL ALIGNMENT | X | X | X | X |
OBJECT Get vertical alignment | X | X | X | X |
OBJECT SET VISIBLE | X | X | X | X |
OBJECT SET SCROLLBAR | X | |||
OBJECT SET SCROLL POSITION | X |
Nota: con list boxes de tipo array, es posible especificar el estilo, color de fuente, color de fondo y visibilidad para cada línea por separado. Esto se administra por medio de arrays asociados con el list box en la lista de propiedades. Puede recuperar los nombres de estos arrays por programación utilizando el comando LISTBOX GET ARRAYS.
Es posible añadir un método de objeto al objeto list box en su conjunto y/o a cada columna de la list box.
Los métodos de objeto se llaman en la siguiente orden:
Cuando el comando OBJECT SET VISIBLE se utiliza con un encabezado o un pie de list box, se utiliza en todos los encabezados o todos los pies del objeto List box, sin importar el elemento individual especificado por el comando.
Por ejemplo, la instrucción OBJECT SET VISIBLE(*;"encabezado3";False) ocultará todos los encabezados del objeto List box al cual pertenece el encabezado3 y no únicamente este encabezado.
Note que para poder manejar la visibilidad de estos objetos utilizando el comando OBJECT SET VISIBLE, debe haber sido mostrados en el list box a nivel del editor de formularios (la opción Mostrar encabezados y/o Mostrar pies debe estar seleccionada para el objeto).
La función OBJECT Get pointer utilizada con la constante Object with focus u Object current (antiguas funciones Focus object y Self) puede ser utilizada en el método de objeto de un list box o de una columna de list box.
Devuelven un puntero al list box, la columna(1) list box o la variable del encabezado en función del tipo de evento de formulario. La siguiente tabla detalla este funcionamiento:
Evento | Objeto foco | Objeto actual |
On Clicked | list box | columna |
On Double Clicked | list box | columna |
On Before Keystroke | columna | columna |
On After Keystroke | columna | columna |
On After Edit | columna | columna |
On Getting Focus | columna o list box (*) | columna o list box (*) |
On Losing Focus | columna o list box (*) | columna o list box (*) |
On Drop | list box source | list box (*) |
On Drag Over | list box source | list box (*) |
On Begin Drag Over | list box | list box (*) |
On Mouse Enter | list box (**) | list box (**) |
On Mouse Move | list box (**) | list box (**) |
On Mouse Leave | list box (**) | list box (**) |
On Data Change | columna | columna |
On Selection Change | list box (**) | list box (**) |
On Before Data Entry | columna | columna |
On Column Moved | list box | columna |
On Row Moved | list box | list box |
On Column Resize | list box | columna |
On Open Detail | Nil | list box (**) |
On Close Detail | Nil | list box (**) |
On Header Click | list box | encabezado |
On Footer Click | list box | footer |
On After Sort | list box | encabezado |
(*) Cuando el foco se modifica dentro de un list box, se devuelve a la columna un puntero. Cuando el foco se modifica a nivel del formulario, se devuelve un puntero al list box. En el contexto de un método de objeto de columna, se devuelve un puntero a la columna.
(**) No ejecutado en el contexto de un método de objeto de columna.
(1) Cuando se devuelve un puntero a una columna, el objeto al cual se apunta depende del tipo del list box. Con un array de tipo list box, la función OBJECT Get pointer devuelve un puntero al array). El mecanismo de punteros de 4D permite conocer el número del elemento del array modificado. Por ejemplo, suponiendo que el usuario modificó la quinta fila de la columna col2:
$Column:=OBJECT Get pointer(Object with focus)
` $Column contiene un puntero a col2
$Fila:=$Column-> `$Fila igual a 5
En el caso de un list box de tipo selección, la función OBJECT Get pointer devuelve:
El comando OBJECT SET SCROLL POSITION (tema “Propiedades de los objetos") puede utilizarse con un objeto de tipo list box. Ese comando permite desplazar las líneas de la list box para mostrar la primera línea seleccionada o una línea específica.
El comando EDIT ITEM (tema “Gestión de entrada”) le permite pasar a modo edición una celda de un objeto list box.
Cuando se aplica a un listbox en modo selección, el comando REDRAW (tema "Interfaz del usuario") dispara la actualización de los datos mostrados en el list box.
El comando Displayed line number (tema "Selecciones") funciona en el contexto del evento de formulario On Display Detail para un objeto list box.
Los eventos de formulario específicos están destinados a facilitar la gestión programada del list box, en particular con lo relacionado a las operaciones de arrastrar y soltar y ordenar. Para mayor información, consulte la descripción del comando Form event.
La gestión de arrastrar y soltar de datos en los list boxes está soportada por los comandos Drop position y DRAG AND DROP PROPERTIES. Estos comandos han sido adaptados especialmente para los list boxes.
Tenga cuidado en no confundir arrastrar y soltar con mover filas y columnas, soportado por los comandos LISTBOX MOVED ROW NUMBER y LISTBOX MOVED COLUMN NUMBER.
Para que una celda de list box sea editable, ambas de las siguientes condiciones deben cumplirse:
Imaginemos por ejemplo un list box que contiene dos arrays, de tipo fecha y texto. El array fecha no es editable pero el array texto es editable si la fecha no ha pasado.
Este es el método de la columna arrText:
Case of
:(Form event=On Before Data Entry) // una celda obtiene el foco
LISTBOX GET CELL POSITION(*;"lb";$col;$row)
// identificación de la celda
If(arrDate{$row}<Current date) // si la fecha es anterior a la de hoy
$0:=-1 // la celda NO es editable
Else
// de lo contrario, la celda es editable
End if
End case
Nota: a partir de 4D v13, el evento On Before Data Entry se devuelve antes de On Getting Focus.
Con el fin de preservar la coherencia de los datos para los list box de tipo selección, todo registro modificado se guarda tan pronto como se valida la celda (si está definido el trigger On saving an existing record se llama) luego se ejecuta el evento On Data Change. La secuencia típica de eventos generada durante la entrada o la modificación de datos es la siguiente:
Acción | Secuencia de eventos |
Una celda pasa a modo edición | On Before Data Entry / On Getting Focus |
Su valor se modifica | On Before Keystroke / On After Keystroke / On After Edit |
Un usuario valida y sale de la celda (tab, clic, etc.) | Save (trigger On saving an existing record) / On Data Change / On Losing Focus |
Por defecto, la list box administra automáticamente la ordenación estándar de columnas en caso de clic en el encabezado. Una ordenación estándar es una ordenación alfanumérica de valores de la columna, de forma alterna ascendente/descendente con cada clic. Todas las columnas siempre se sincronizan automáticamente.
Puede evitar las ordenaciones de usuario estándar deseleccionando la propiedad “Ordenable” del list box.
Por defecto, el list box maneja automáticamente las ordenaciones estándar de columnas en caso de clic en el encabezado. Una ordenación estándar es una ordenación alfanumérica de los valores de la columna, alternamente ascendente/descendente con cada clic sucesivo. Todas las columnas siempre se sincronizan automáticamente.
Usted puede prohibir ordenar al usuario estándar deseleccionando la propiedad "Ordenable" para el listbox.
Nota: la propiedad “Ordenable” únicamente afecta la ordenación del usuario estándar; el comando LISTBOX SORT COLUMNS no tiene en cuenta esta propiedad.
El valor de la variable asociada al título de la columna le permite administrar información adicional: la ordenación actual de la columna (lectura) y la visualización de la flecha de ordenación.
Es posible fija el valor de la variable (por ejemplo, Titulo2:=2) para “forzar” la visualización de la flecha de ordenación. La ordenación de la columna misma no se modifica en este caso; está en manos del desarrollador manejarlo.
Nota: el comando OBJECT SET FORMAT ofrece un soporte específico para los íconos en los encabezados de list box, útil cuando desea trabajar con un icono de ordenación personalizado.
La gestión de selecciones se efectúa de manera diferente para los list box de tipo array y de tipo selección.
• List box de tipo selección: las selecciones son administradas por intermedio de un conjunto llamado por defecto $ListboxSetX (X comienza en 0 y se incrementa en función del número de list box en el formulario), puede modificarlo si es necesario. Este conjunto se define en las propiedades del list box. Es mantenido automáticamente por 4D: si el usuario selecciona una o más filas en el list box, el conjunto se actualiza inmediatamente. Por otra parte, también es posible utilizar los comandos del tema "Conjuntos" con el fin de modificar por programación la selección del list box.
• List box de tipo array: el comando SELECT LISTBOX ROW puede utilizarse para seleccionar por programación una o más filas del list box.
La variable asociada al objeto List box se utiliza para obtener, fijar o almacenar las selecciones de filas del objeto.
Esta variable corresponde a un array de booleanos que es creada y mantenida automáticamente por 4D. El tamaño de este array se determina por el tamaño del list box: contiene el mismo número de elementos que el array más pequeño asociado a las columnas.
Cada elemento de este array contiene True si la fila correspondiente se selecciona y de lo contrario False. 4D actualiza los contenidos de este array dependiendo de las acciones del usuario. A la inversa, usted puede modificar el valor de los elementos de este array para modificar la selección en el list box.
Por otra parte, no es posible insertar o borrar filas en este array; tampoco es posible digitar filas nuevamente.
Nota: el comando Count in Array puede utilizarse para conocer el número de las filas seleccionadas.
Por ejemplo, este método permite invertir la selección de esta primera fila del list box (tipo array):
ARRAY BOOLEAN(tBListBox;10)
` tBListBox es el nombre de la variable asociada al list box en el formulario
If(tBListBox{1}=True)
tBListBox{1}:=False
Else
tBListBox{1}:=True
End if
Es posible imprimir list boxes a partir de 4D v12. Están disponibles dos modos de impresión: modo previsualización, el cual puede permite imprimir un list box como un objeto de formulario y el modo avanzado, permite controlar la impresión del objeto list box mismo dentro del formulario. Note que la apariencia "Impresión" está disponible para los objetos list box en el editor de formularios.
La impresión de un list box en modo previsualización consiste en imprimir directamente el list box con el formulario que lo contiene utilizando los comandos de impresión estándar o el comando de menú Print. El list box se imprime como está en el formulario. Este modo no permite controlar con precisión la impresión del objeto; en particular, no permite imprimir todas las líneas de un list box que contenga más líneas de las que pueda mostrar.
En este modo, la impresión de los list box se efectúa por programación, vía el comando Print object (los formularios proyecto y los formularios tabla se tienen en cuenta). El comando LISTBOX GET PRINT INFORMATION se utiliza para controlar la impresión del objeto.
En este modo:
Hay varios modos distintos de configurar los colores de fondo, colores de fuente y estilos de fuente para los list boxes:
Se observan principios de prioridad y de herencia.
propiedades del objeto list box o columna, el uso de arrays o métodos para el list box o por columna y definición a nivel de celdas (si son de texto multiestilo).
Cuando una misma propiedad se define en más de un nivel, el orden de prioridad es el siguiente:
Prioridad elevada | Celda (si texto multiestilo) |
Array/métodos de columna | |
Array/métodos de listbox | |
Propiedades de la columna | |
Prioridad baja | Propiedades del list box |
Por ejemplo, si define un estilo de caracteres en las propiedades del list box y otro utilizando un array de estilo para la columna, se tendrá en cuenta este último.
Dado un list box cuyas filas tienen un color alterno gris/gris claro, definido en las propiedades del list box. Un array de color de fondo también se ha definido para el list box con el fin de cambiar el color de las filas en las que al menos un valor es negativo por naranja:
<>_BgndColors{$i}:=0x00FFD0B0 // orange
<>_BgndColors{$i}:=-255 // valor por defecto
A continuación, vamos a colorear los valores negativos de color naranja oscuro. Para ello , se define un array de color de fondo para cada columna, por ejemplo ample <>_BgndColor_1, <>_BgndColor_2 and <>_BgndColor_3. Los valores de estos arrays serán prioritarios sobre los definidos en las propiedades del list box, así como las del array general de color de fondo:
<>_BgndColorsCol_3{2}:=0x00FF8000 // naranja oscuro
<>_BgndColorsCol_2{5}:=0x00FF8000
<>_BgndColorsCol_1{9}:=0x00FF8000
<>_BgndColorsCol_1{16}:=0x00FF8000
Puede obtener el mismo resultado utilizando los nuevos comandos LISTBOX SET ROW FONT STYLE y LISTBOX SET ROW COLOR. Tienen la ventaja de que le permite evitar tener que predefinir los arrays de
estilo/color de las columnas: son creados dinámicamente por los comandos.
Para cada atributo (estilo, color y color de fondo), la herencia se aplica cuando se utiliza el valor por defecto:
De esta manera, si quiere que un objeto herede el valor del atributo de un nivel superior, pase la constante lk inherited (valor por defecto) al comando de definición o directamente en el elemento del array de estilo/color correspondiente.
Dado un listbox que contiene una estilo de fuente estándar con colores alternativos:
Puede realizar las modificaciones siguientes:
Puede definir las propiedades de interfaz "oculta", "desactivada" y "seleccionable" para cada línea de list box de tipo array.
Estas funcionalidades se pueden manejar por medio del Array de control de líneas, el cual puede designar utilizando el comando LISTBOX SET ARRAY o vía la Lista de propiedades:
Un array de control de líneas debe ser de tipo Entero largo e incluir el número de líneas que el list box. Para obtener más información, consulte la sección Propiedades específicas de los list box.
Cada elemento del Array de control de líneas define el estado de la interfaz de la línea correspondiente en el list box. Tres propiedades de interfaz están disponibles usando las constantes del tema "List box":
Constante | Tipo | Valor | Comentario |
lk row is disabled | Entero largo | 2 | La línea correspondiente se desactiva. El texto y los controles tales como casillas de selección se atenúan o se ponen grises. Las áreas de entrada de texto editables ya no son editables. Valor por defecto: Activado |
lk row is hidden | Entero largo | 1 | La línea correspondiente está oculta. Ocultar las líneas sólo afecta la visualización del list box. Las líneas ocultas siguen presentes en los arrays y pueden ser manipuladas por programación. Los comandos del lenguaje, más concretamente LISTBOX Get number of rows o [#cmd id="971"/], no tienen en cuenta el estado visible/oculto de las líneas. Por ejemplo, en un list box con 10 líneas donde las primeras 9 líneas se ocultan, LISTBOX Get number of rows devuelve10. Desde el punto de vista del usuario, la presencia de líneas ocultas en un list box no es visiblemente discernible. Sólo líneas visibles pueden ser seleccionadas (por ejemplo utilizando el comando Seleccionar todo). Valor por defecto: Visible |
lk row is not selectable | Entero largo | 4 | La línea correspondiente no se puede seleccionar (resaltarla no es posible). Las áreas de entrada de texto editables ya no son editables a menos de que la opción "Editar en clic único" esté activada. Los controles tales como casillas de selección y listas siguen siendo funcionales sin embargo. Este parámetro se ignora si el modo de selección del list box es "Ninguno". Valor por defecto: seleccionable |
Para cambiar el estado de una línea, sólo tiene que pasar las constantes apropiadas en el elemento correspondiente. Por ejemplo, si o quiere que la línea #10 sea seleccionable, puede escribir:
aLControlArr{10}:=lk row is not selectable
Puede definir varias propiedades de la interfaz a la vez:
aLControlArr{8}:=lk row is not selectable+lk row is disabled
Tenga en cuenta que la definición de una propiedad para un elemento anula cualquier otro valor de este elemento (si no reinicializa). Por ejemplo:
aLControlArr{6}:=lk row is disabled+lk row is not selectable //define la línea 6 como desactivada Y no seleccionable
aLControlArr{6}:=lk row is disabled //define la línea 6 como desactivado pero seleccionable nuevamente
Es posible poner directamente el resultado de una petición SQL en un list box de tipo array. Esta función ofrece un medio rápido de visualizar el resultado de peticiones SQL. Sólo pueden utilizarse las peticiones de tipo SELECT. Este mecanismo no puede utilizarse con una base SQL externa.
Esto funciona de acuerdo a los siguientes principios:
Ejemplo
Queremos recuperar todos los campos de la tabla PERSONAS y ubicar su contenido en el list box cuyo nombre de variable es vlistbox. En el método de objeto de un botón (por ejemplo), es suficiente escribir:
Begin SQL
SELECT * FROM PEOPLE INTO <<vlistbox>>
End SQL
Producto: 4D
Tema: List Box
Modificado: 4D v15 R4
Manual de lenguaje 4D ( 4D v16)
Manual de lenguaje 4D ( 4D v16.1)
Manual de lenguaje 4D ( 4D v16.2)
Manual de lenguaje 4D ( 4D v16.3)