4D Documentation

Edit

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:

  • when using Add Subrecord and Edit Subrecord standard actions applied to the list box (see Using standard actions),
  • when a row is double-clicked and the Double-click on Row property is set to "Edit Record" or "Display Record".

Gramática JSON

NombreTipos de datosValores posibles
detailFormcadena
  • Name (string) of table or project form
  • POSIX path (string) to a .json file describing the form
  • Object describing the form
    •

    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
    doubleClickInRowActioncadena"editSubrecord", "displaySubrecord"

    Objetos soportados

    List Box

    Conjunto resaltado

    List box del tipo selección

    This property is used to specify the set to be used to manage highlighted records in the list box (when the Arrays data source is selected, a Boolean array with the same name as the list box is used).

    4D creates a default set named ListBoxSetN where N starts at 0 and is incremented according to the number of list boxes in the form. If necessary, you can modify the default set. It can be a local, process or interprocess set (we recommend using a local set, for example $LBSet, in order to limit network traffic). A continuación, 4D lo mantiene automáticamente. If the user selects one or more rows in the list box, the set is updated immediately. If you want to select one or more rows by programming, you can apply the commands of the “Sets” theme to this set.

    • The highlighted status of the list box rows and the highlighted status of the table records are completely independent.
    • If the “Highlight Set” property does not contain a name, it will not be possible to make selections in the list box.

    Gramática JSON

    NombreTipos de datosValores posibles
    highlightSetcadenaNombre del conjunto

    Objetos soportados

    List Box

    Locked columns and static columns

    Locked columns and static columns are two separate and independent functionalities in list boxes:

    • Locked columns always stay displayed to the left of the list box; they do not scroll horizontally.
    • Static columns cannot be moved by drag and drop within the list box.

    You can set static and locked columns by programming, refer to List Box in the 4D Language Reference manual.

    Estas propiedades interactúan de la siguiente manera:

    • If you set columns that are only static, they cannot be moved.

    • If you set columns that are locked but not static, you can still change their position freely within the locked area. However, a locked column cannot be moved outside of this locked area.

    • If you set all of the columns in the locked area as static, you cannot move these columns within the locked area.

    • You can set a combination of locked and static columns according to your needs. For example, if you set three locked columns and one static column, the user can swap the two right-most columns within the locked area (since only the first column is static).

    Número de columnas bloqueadas

    Number of columns that must stay permanently displayed in the left part of the list box, even when the user scrolls through the columns horizontally.

    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 de forma dinámica 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

    A 4D array controlling the display of list box rows.

    You can set the "hidden", "disabled" and "selectable" interface properties for each row in an array-based list box using this array. It can also be designated using the LISTBOX SET ARRAY command.

    The row control array must be of the Longint type and include the same number of rows as the list box. Each element of the Row Control Array defines the interface status of its corresponding row in the list box. Three interface properties are available using constants in the "List Box" constant theme:

    ConstanteValorComentario
    lk row is disabled2The corresponding row is disabled. The text and controls such as check boxes are dimmed or grayed out. Enterable text input areas are no longer enterable. Valor por defecto: Activado
    lk row is hidden1The corresponding row is hidden. Hiding rows only affects the display of the list box. The hidden rows are still present in the arrays and can be managed by programming. The language commands, more particularly LISTBOX Get number of rows or LISTBOX GET CELL POSITION, do not take the displayed/hidden status of rows into account. For example, in a list box with 10 rows where the first 9 rows are hidden, LISTBOX Get number of rows returns 10. From the user’s point of view, the presence of hidden rows in a list box is not visibly discernible. Only visible rows can be selected (for example using the Select All command). Valor por defecto: Visible
    lk row is not selectable4The corresponding row is not selectable (highlighting is not possible). Enterable text input areas are no longer enterable unless the Single-Click Edit option is enabled. Controls such as check boxes and lists are still functional however. This setting is ignored if the list box selection mode is "None". Valor por defecto: Seleccionable

    To change the status for a row, you just need to set the appropriate constant(s) to the corresponding array element. For example, if you do not want row #10 to be selectable, you can write:

     aLControlArr{10}:=lk row is not selectable

    You can define several interface properties at once:

     aLControlArr{8}:=lk row is not selectable + lk row is disabled

    Note that setting properties for an element overrides any other values for this element (if not reset). Por ejemplo:

     aLControlArr{6}:=lk row is disabled + lk row is not selectable 
 //sets row 6 as disabled AND not selectable
 aLControlArr{6}:=lk row is disabled 
 //sets row 6 as disabled but selectable again

    Gramática JSON

    NombreTipos de datosValores posibles
    rowControlSourcecadenaNombre 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 línea cambia su estado (entre seleccionada o no).
      Las teclas de flecha arriba y abajo seleccionan la línea anterior/siguiente de 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
    selectionModecadena"multiple", "single", "none"

    Objetos soportados

    List Box

    ← JerarquíaObjetos →