Casillero
El casillero es un objeto que sirve para presentar listas de registros de las tablas.
![](https://doc.velneo.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2FacHvn1mzRpmOMOqsSuAq%2Fblobs%2F1zLpzeCuNl8fbjTOtOpn%2Fres_387.png&width=768&dpr=4&quality=100&sign=644ecb39&sv=1)
El casillero siempre va asociado a una tabla de un proyecto de datos heredado. El flujo es lista de la tabla asociada tanto para la entrada como para la salida.
El casillero está compuesto por una serie de celdas (casillas) distribuidas en forma de filas y columnas. Una celda se corresponde con un registro de una tabla. Una celda permitirá mostrar un formulario concreto de un registro concreto de la tabla a la que pertenece el casillero. Cada celda a su vez es un botón que permite disparar un comando al hacer clic sobre él.
Para crear un objeto de este tipo seleccionar la opción nuevo objeto/casillero del menú objetos de Velneo vDevelop o a través de la galería de objetos.
En este objeto podemos hacer scroll con el dedo en dispositivos móviles.
Propiedades
Identificador
Etiqueta alfanumérica que identifica al objeto. Este identificador será el que se usa para referenciarlo en los inspectores y en las propiedades de otros objetos.
Nombre
Etiqueta alfanumérica que servirá como descriptor del casillero. Es el texto que se presentará al usuario final de la aplicación para referenciar el casillero. Podemos definir una etiqueta por cada idioma presente en el proyecto.
Estilos
Podemos definir los estilos siguientes:
Privado
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Arrastrable para copiar
Cuando la rejilla va a ser el origen en un evento de drag and drop, si está activado este estilo, en ejecución los items arrastrados no serán quitados de la misma tras ejecutar el evento de drop.
Arrastrable para mover
Cuando la rejilla va a ser el origen en un evento de drag and drop, si está activado este estilo, en ejecución los items arrastrados serán quitados de la misma tras ejecutar el evento de drop.
Simple-click dispara
Si este estilo está activado el comando asociado al casillero será disparado al hacer un clic sobre un ítem del casillero. Si este estilo está desactivado el usuario tendrá que hacer doble clic para ejecutar el comando.
Sin barra de título (Sólo diálogos)
Permite omitir la barra de título de la ventana. Solamente funcional en cuadros de diálogo.
Sin menú de sistema
Permite omitir el menú de sistema de la ventana.
Sin botón maximizar
Permite ocultar el botón maximizar de la ventana.
Sin botón minimizar
Permite ocultar el botón minimizar de la ventana.
Sin botón cerrar
Permite ocultar el botón de cierre de la ventana.
Optimizado
Si activamos esta opción, el sistema reducirá el número de conexiones con el servidor que requieren determinados tipos de campo (enlaces a maestro, campos objeto) para mejorar los tiempos de carga del casillero.
Si el casillero tiene activado este estilo, se aplican CSS en las celdas de los casilleros, heredando del css principal o permitiendo la aplicación de css específicos en los casilleros, en caso contrario, no se aplicarán CSS.
Personalizable
Si activamos este estilo, el objeto podrá ser reemplazado por otro del mismo tipo en tiempo de ejecución mediante un objeto reemplazo.
Comentarios
Esta propiedad nos permite documentar el uso del casillero.
Tabla asociada
Tabla de un proyecto de datos heredado cuyos registros van a ser visualizados en el casillero.
Formulario
Formulario del proyecto en curso o de un proyecto heredado que será usado para mostrar cada ficha en cada celda del casillero.
El casillero es cargado solamente en el inicio. Lee los datos de la ficha y crea la celda correspondiente en el casillero, por lo que no es recomendable utilizar en el formulario controles cuya lectura no sea inmediata como los gráficos o como el control visor HTML cuyo contenido sea una url.
Columnas/Filas
Expresión de tipo fórmula que nos permite definir un número fijo de columnas o de filas que tendrá el casillero.
El que sean columnas o filas vendrá determinado por el valor que se establezca en la propiedad Barra de scroll. Si seleccionamos el scroll Horizontal el número indicado en este parámetro será el número de filas del casillero. Si seleccionamos el scroll Vertical el número indicado en este parámetro será el número de columnas del casillero.
Si queremos que sea el propio sistema el que se encargue de calcular el número de columnas/filas automáticamente en tiempo de ejecución en función de tamaño disponible en pantalla para pintar el casillero, entonces estableceremos el valor 0 en este parámetro.
El tamaño que tomarán las casillas y el número de elementos que se presentará por fila y columna vendrá dado por el tamaño del formulario elegido, que será el tamaño mínimo que tendrá cada casilla.
Al tratarse de una fórmula podremos hacer que este valor sea un valor dinámico.
Si en este parámetro usamos un dato variable debemos tener en cuenta que solamente se leerá al crear el casillero. Esto quiere decir que, si una vez en pantalla modificamos el valor de dicho dato, el casillero no será reconstruido. Para que el cambio se haga efectivo será necesario cerrar la vista y volver a lanzar el casillero.
Tipo de menú de contexto
El menú de contexto es el que aparece cuando el usuario final hace clic con el botón derecho del ratón. Los valores posibles son:
Ninguno
El objeto carecerá de menú de contexto.
Por defecto
El objeto dispondrá de un menú de contexto creado automáticamente por el sistema, que contendrá las opciones siguientes:
Alta de ficha: si el objeto tiene asociado un formulario de altas, lo abrirá para que el usuario pueda añadir una ficha.
Modificación de ficha: editará la ficha seleccionada en el formulario de modificación asociado al objeto.
Baja de ficha: abrirá el formulario de bajas asociado al objeto.
Invertir: invierte el orden de la lista, usando para ello el campo por el que se encuentra ordenada.
Filtrar: permite al usuario establecer y aplicar un filtro al objeto.
Ordenar: permite al usuario ordenar la lista por el campo que elija.
Quitar de la lista el seleccionado: quita del objeto el registro que el usuario tenga seleccionado. No lo borra físicamente, sino que simplemente lo quita de la lista.
Por defecto extendido
El objeto dispondrá de un menú de contexto creado automáticamente por el sistema que, además de las opciones del menú por defecto, incluye las siguientes:
Modificar campo…: permitirá al usuario modificar un campo de todos los registro de la lista.
Modificar campo si…: permitirá al usuario modificar un campo de todos los registro de la lista que cumplan una determinada condición.
Exportar a XML: permitirá al usuario exportar los registros de la lista a un fichero XML.
Personalizado
El menú de contexto del objeto será un objeto menú contenido en el proyecto.
Menú de contexto
Esta propiedad solamente estará disponible cuando el valor de la propiedad tipo de menú de contexto sea personalizado. Nos permitirá seleccionar el objeto menú que queramos usar como menú de contexto del casillero.
Comando
El comando es la instrucción que se ejecuta cuando el usuario final hace doble clic con el botón izquierdo del ratón sobre una celda del casillero. Los valores posibles son:
Ninguno
No hará nada.
Editar sobre casillero (obsoleto)
Se activará el formulario incluido en la casilla (el especificado en la propiedad formulario) para la modificación de la ficha correspondiente a la celda pulsada. La edición del formulario se hará en la propia celda. Este método no usa el formulario directamente, sino que presenta una imagen del formulario que se calcula al crear el casillero por lo que, si el formulario contiene controles que no se cargan de forma inmediata como visores html o gráficos, éstos se mostrarán vacíos. Este método está obsoleto y se recomienda usar en su lugar editar sobre el casillero optimizado. Para editar un registro se debe hacer simple clic o doble clic, según esté configurado, para editar un registro.
Ejecutar proceso
Se ejecutará un objeto proceso contenido en el proyecto. El proceso a disparar deberá tener origen ficha de la tabla asociada al casillero.
Editar sobre el casillero optimizado
Similar al método editar sobre casillero (obsoleto) pero que usa directamente el formulario en la casilla y no una imagen del mismo. Además, carga directamente el formulario en edición, por lo que se puede editar directamente sobre él sin tener que hacer clic o doble clic para activarlo. Cuando se elige esta opción, el casillero se pone internamente en modo optimizado, no hace falta configurar ese estilo.
Abrir formulario de modificación
Si en la propiedad formulario de modificación hemos especificado un formulario, este comando abrirá ese formulario en una nueva ventana para que el usuario pueda editar la ficha seleccionada. Si no hay formulario seleccionado, no hará nada.
Proceso
Esta propiedad solamente estará disponible cuando el valor de la propiedad comando sea ejecutar proceso. Nos permitirá seleccionar el objeto proceso que queramos usar como acción al pulsar sobre una celda del casillero. Este objeto proceso deberá tener como origen ficha de la tabla origen del casillero.
Toolbar
Esta propiedad nos permitirá seleccionar el objeto toolbar que queramos adjuntar al casillero.
Posición de la toolbar
Esta propiedad solamente estará disponible cuando se haya seleccionado un objeto toolbar en la propiedad toolbar. Nos permitirá seleccionar la posición donde se aparcará el objeto toolbar. Los valores posibles son:
Arriba
Se aparcará en la parte superior del casillero.
Abajo
Se aparcará en la parte inferior del casillero.
Formulario de alta
Formulario del proyecto en curso o de un proyecto heredado que será usado para dar de alta una ficha desde el casillero.
Formulario de modificación
Formulario del proyecto en curso o de un proyecto heredado que será usado para editar una ficha desde el casillero. Si en la propiedad comando no hemos establecido el valor abrir formulario de modificación, al hacer doble clic sobre un elemento del casillero no se lanzará este formulario sino que se ejecutará el comando declarado en aquella propiedad.
Formulario de baja
Formulario del proyecto en curso o de un proyecto heredado que será para eliminar una ficha desde el casillero.
Timer (Milisegundos)
Es un reloj que permitirá ejecutar automáticamente uno o varios manejadores de evento declarados en el casillero de forma periódica. En este parámetro se indicará el tiempo, en milisegundos, para cada iteración del timer. Si el valor es 0, querrá decir que no se activará el timer.
Barra de scroll
Esta propiedad permite indicar si el casillero será distribuido en filas o en columnas según el número establecido en el parámetro columnas/filas. Los valores posibles son:
Vertical
El casillero será distribuido en columnas.
Horizontal
El casillero será distribuido en filas.
El tamaño del casillero tendrá que ser por lo menos, el que permita mostrar una casilla.