Saltar al contenido principal
Versión: 20 R5

List Box


Columnas

Colección de columnas del list box.

Gramática JSON

NombreTipos de datosValores posibles
columnscolección de objetos columnaContiene las propiedades de las columnas de list box

Para ver una lista de las propiedades que soportan los objetos columna, consulte la sección Propiedades específicas de la columna.

Objetos soportados

List Box


Nombre formulario detallado

List box del tipo selección

Especifica el formulario que se utilizará para modificar o mostrar los registros individuales del list box.

Se muestra el formulario especificado:

Gramática JSON

NombreTipos de datosValores posibles
detailFormstring
  • Nombre (cadena) de la tabla o formulario proyecto
  • Ruta POSIX (cadena) a un archivo .json que describe el formulario
  • Objeto que describe el formulario
  • Objetos soportados

    List Box


    Doble clic en línea

    List box del tipo selección

    Define la acción a realizar cuando un usuario haga doble clic en una línea en el list box. Las opciones disponibles son:

    • No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática.
    • Editar registro: al hacer doble clic en una línea se muestra el registro correspondiente en el formulario detallado definido para el list box. El registro se abre en modo de lectura-escritura para que pueda ser modificado.
    • Mostrar registro: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado.

    > Double-clicking an empty row is ignored in list boxes.

    Independientemente de la acción seleccionada/elegida, se genera el evento de formulario On Double clicked.

    Para las dos últimas acciones, también se genera el evento de formulario On Open Detail. On Close Detail se genera cuando un registro mostrado en el formulario detallado asociado al list box está a punto de cerrarse (independientemente de que el registro se haya modificado o no).

    Gramática JSON

    NombreTipos de datosValores posibles
    doubleClickInRowActionstring"editSubrecord", "displaySubrecord"

    Objetos soportados

    List Box


    Conjunto resaltado

    List box del tipo selección

    Esta propiedad se utiliza para especificar el conjunto a utilizar para gestionar los registros resaltados en el list box (cuando se selecciona la fuente de datos Arrays, se utiliza un conjunto booleano con el mismo nombre que el list box).

    4D crea un conjunto por defecto llamado ListBoxSetN donde N empieza en 0 y se incrementa según el número de list boxes en el formulario. Si es necesario, puede modificar el conjunto por defecto. Puede ser un conjunto local, proceso o interproceso (recomendamos utilizar un conjunto local, por ejemplo $LBSet, para limitar el tráfico de red). A continuación, 4D lo mantiene automáticamente. Si el usuario selecciona una o varias líneas en el list box, el conjunto se actualiza inmediatamente. Si desea seleccionar una o varias líneas por programación, puede aplicar a este conjunto los comandos del tema "Conjuntos".

    • El estado de resaltado de las líneas del list box y el estado de resaltado de los registros de la tabla son completamente independientes.
    • Si la propiedad "Conjunto resaltado" no contiene un nombre, no será posible realizar selecciones en el list box.

    Gramática JSON

    NombreTipos de datosValores posibles
    highlightSetstringNombre del conjunto

    Objetos soportados

    List Box


    Columnas bloqueadas y columnas estáticas

    Las columnas bloqueadas y las columnas estáticas son dos funcionalidades distintas e independientes en los list boxes:

    • Las columnas bloqueadas siempre se muestran a la izquierda del list box; no se desplazan horizontalmente.
    • Las columnas estáticas no pueden moverse arrastrándolas y soltándolas dentro del list box.

    Puede definir columnas estáticas y bloqueadas por programación, consulte la sección "List Box" en el manual de Lenguaje 4D.

    Estas propiedades interactúan de la siguiente manera:

    • Si define columnas que sólo son estáticas, no se pueden mover.

    • Si define columnas bloqueadas pero no estáticas, puede seguir cambiando su posición libremente dentro del área bloqueada. Sin embargo, una columna bloqueada no puede moverse fuera de esta área bloqueada.

    • Si define todas las columnas del área bloqueada como estáticas, no podrá mover estas columnas dentro del área bloqueada.

    • Puede definir una combinación de columnas bloqueadas y estáticas según sus necesidades. Por ejemplo, si define tres columnas bloqueadas y una columna estática, el usuario puede intercambiar las dos columnas situadas más a la derecha dentro del área bloqueada (ya que sólo la primera columna es estática).

    Número de columnas bloqueadas

    Número de columnas que deben permanecer visualizadas permanentemente en la parte izquierda del list box, incluso cuando el usuario se desplaza horizontalmente por las columnas.

    Gramática JSON

    NombreTipos de datosValores posibles
    lockedColumnCountintegermínimo: 0

    Objetos soportados

    List Box

    Número de columnas estáticas

    Número de columnas que no se pueden mover durante la ejecución.

    Gramática JSON

    NombreTipos de datosValores posibles
    staticColumnCountintegermínimo: 0

    Objetos soportados

    List Box


    Número de columnas

    Define el número de columnas del list box.

    Puede añadir o eliminar columnas dinámicamente por programación, utilizando comandos como LISTBOX INSERT COLUMN o LISTBOX DELETE COLUMN.

    Gramática JSON

    NombreTipos de datosValores posibles
    columnCountintegermínimo: 1

    Objetos soportados

    List Box


    Array de control de líneas

    List box de tipo array

    Un array 4D que controla la visualización de las líneas del list box.

    Puede definir las propiedades de interfaz "oculta", "desactivada" y "seleccionable" para cada línea de un list box basado en arrays utilizando este array. También puede ser designado utilizando el comando LISTBOX SET ARRAY.

    El array de control de líneas debe ser de tipo Longint e incluir el mismo número de líneas que el list box. Cada elemento del Array de control de líneas define el estado de la interfaz de su línea correspondiente en el list box. Hay tres propiedades de interfaz disponibles utilizando constantes en el tema de constantes "List Box":

    ConstanteValorComentario
    lk row is disabled2La línea correspondiente está desactivada. El texto y los controles, como las casillas de selección, aparecen atenuados o en gris. Las áreas de entrada de texto introducibles ya no lo son. Valor por defecto: Activado
    lk row is hidden1La línea correspondiente está oculta. Ocultar las líneas sólo afecta a la visualización del list box. Las líneas ocultas siguen presentes en los arrays y pueden gestionarse por programación. Los comandos de lenguaje, más concretamente LISTBOX Get number of rows o LISTBOX GET CELL POSITION, no tienen en cuenta el estado mostrado/oculto de las líneas. Por ejemplo, en un list box con 10 líneas en el que las 9 primeras líneas están ocultas, LISTBOX Get number of rows devuelve 10. Desde el punto de vista del usuario, la presencia de líneas ocultas en un list box no es visiblemente perceptible. Sólo pueden seleccionarse las líneas visibles (por ejemplo, utiliznado el comando Seleccionar todo). Valor por defecto: Visible
    lk row is not selectable4La línea correspondiente no es seleccionable (no es posible resaltarla). Las áreas de entrada de texto ya no se pueden modificar a menos que esté activada la opción Single-Click Edit. Sin embargo, los controles como las casillas de verificación y las listas siguen siendo funcionales. Esta configuración 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, basta con definir la(s) constante(s) adecuada(s) en el elemento array correspondiente. Por ejemplo, si no 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 configuración de las propiedades de un elemento anula cualquier otro valor de este elemento (si no se restablece). 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 desactivada pero seleccionable nuevamente

    Gramática JSON

    NombreTipos de datosValores posibles
    rowControlSourcestringNombre del array de control de líneas

    Objetos soportados

    List Box


    Modo de selección

    Designa la opción para permitir a los usuarios seleccionar líneas:

    • Ninguna: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción Edición con un solo clic esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario On Selection Change.
    • Simple: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un Ctrl+clic (Windows) o Comando+clic (macOS) en una fila cambia su estado (entre seleccionado o no).
      Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario On Selection Change se genera cada vez que se cambia la línea actual.
    • Múltiple: en este modo se pueden seleccionar varias líneas simultáneamente.

    Gramática JSON

    NombreTipos de datosValores posibles
    selectionModestring"multiple", "single", "none"

    Objetos soportados

    List Box