Casillero

Casillero
El casillero es un objeto que sirve para presentar listas de registros de las tablas.

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 esta 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 hacer doble clic sobre el icono correspondiente de la galería de objetos (Tecla Insert).

Sus propiedades son:

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 que 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.

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.

Columnas/Filas: Expresión de tipo fórmula que nos permite definir un número fijo de colunmas 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.

NOTA: 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 casillero carecerá de menú de contexto.
Por defecto: El casillero dispondrá de un menú de contexto creado automáticamente por el sistema.
Personalizado: El menú de contexto del casillero 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: 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.
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.
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 toolbarLos 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.

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.