Índice. Tutor de casilleros Página 1 de 10

Transcripción

1 Página 1 de 10 Índice Tutor de casilleros... 2 Introducción... 2 Proyecto de datos... 2 Definición de los casilleros... 2 Casillero de familias... 2 Casillero de artículos... 4 Interfaz... 5 Formulario FILAS_COLUMNAS... 6 Formulario PRINCIPAL... 6 Formulario PRINCIPAL_FAMILIAS... 7 Formulario PRINCIPAL_ARTICULOS... 8 Evento FAMILIAS_CAMBIO_ITEM... 8 Ejecutando el proyecto... 9

2 Página 2 de 10 Tutor de casilleros Introducción 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. Este tutor es un ejemplo de cómo construir casilleros con columnas/filas auto-calculadas y sincronizados entre sí. Este tutor consta de una única solución que contiene un proyecto de datos y otro de aplicación que hereda el anterior. Proyecto de datos El proyecto de datos contiene los siguientes objetos: Contiene dos tablas enlazadas entre sí: Familias y Artículos, histórica de la anterior. Contiene dos variables globales con persistencia en memoria que permitirán configurar el número de columnas/filas que tendrá cada uno de los casilleros. Además contiene un proceso para generar registros en la aplicación. Definición de los casilleros En el proyecto de aplicación, además de los objetos básicos de interfaz (marco, menú principal, etc.) se han programado dos casilleros. Uno para la tabla de familias y otro para la de artículos. Casillero de familias Las propiedades del objeto 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. Se ha establecido el valor FAMILIAS.

3 Página 3 de 10 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. Se ha establecido el valor Familias. 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. En este caso no hemos activado ningún estilo. Comentarios: Esta propiedad nos permite documentar el uso del casillero. La hemos dejado vacía. Tabla asociada: Tabla de un proyecto de datos heredado cuyos registros van a ser visualizados en el casillero. En este caso seleccionaremos la tabla de FAMILIAS. Formulario: Formulario del proyecto en curso o de un proyecto heredado que será usado para mostrar cada ficha en cada celda del casillero. Se ha seleccionado un formulario asociado a la tabla de familias llamado FAMILIA_CASILLERO. 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. En este caso hemos seleccionado la variable global declarada en el proyecto de datos heredado que se llama FAMILIAS_COL_FIL. 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. En el caso de que el valor establecido en este parámetro sea 0, será 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. 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. 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 sobre el objeto. 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.

4 Página 4 de 10 Personalizado: El menú de contexto del casillero será un objeto menú contenido en el proyecto. En este caso hemos seleccionado el valor Por defecto. 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 de tipo 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. En este caso hemos seleccionado el valor Abrir formulario de modificación. Toolbar: Esta propiedad nos permitirá asociar un objeto de tipo toolbar al casillero. En este caso lo hemos dejado vacío. 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. En este caso se ha seleccionado un formulario llamado FAMILIA. 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. En este caso se ha seleccionado un formulario llamado FAMILIA. Formulario de baja: Formulario del proyecto en curso o de un proyecto heredado que será para eliminar una ficha desde el casillero. En este caso se ha seleccionado un formulario llamado FAMILIA. 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. Este es el valor que hemos seleccionado. Horizontal: El casillero será distribuido en filas. NOTA: El tamaño del casillero tendrá que ser por lo menos, el que permita mostrar una casilla. Casillero de artículos Hemos creado un casillero con unas propiedades similares al de familias pero asociado a la tabla de artículos y usando formularios asociados a la misma tabla. De él solamente vamos a comentar las propiedades más significativas: Columnas/Filas: Hemos seleccionado la variable global declarada en el proyecto de datos heredado que se llama ARTICULOS_COL_FIL.

5 Página 5 de 10 Comando: El comando seleccionado en este caso es Ejecutar proceso y el proceso a ejecutar es un proceso origen ficha de la tabla de artículos, llamado, ARTICULOS_SLOT y que lo único que hace es presentar un mensaje con el nombre del artículo y la familia a la que pertenece: Barra de scroll: En este caso se ha seleccionado el valor Horizontal, es decir, que el casillero en este caso será distribuido en columnas. Interfaz El interfaz de la aplicación en ejecución es el siguiente: El marco principal del proyecto tiene un dock a la izquierda llamado Filas/Columnas. Dicho dock contiene un formulario en el que se editan las variables globales para que el usuario pueda especificar el número de columnas/filas de los casilleros de familias y artículos. También contiene un botón que presentará un formulario con los dos casilleros usando los datos establecidos en ambas variables.

6 Página 6 de 10 En el panel central se muestra un formulario que contiene un control de tipo splitter con dos subformularios, el de la izquierda contiene el casillero de familias y el de la derecha el de artículos. Además tiene programado un evento y una conexión de evento que provocará que, al seleccionar una familia en el casillero de la izquierda, se carguen los artículos correspondientes a la misma en el de la derecha. Bajo cada casillero se muestra un mensaje que indica el número de filas/columnas configurado para el casillero o si han sido calculados de forma automática. En este formulario inicialmente los dos casilleros se generan con el número de filas/columnas automático (recordemos que si el valor del parámetro correspondiente es 0 es el propio sistema quien se encarga de calcular automáticamente el nº de filas/columnas de un casillero). En los puntos siguientes explicaremos cómo se han programado tanto el dock que contiene las variables como el formulario que contiene el casillero. Formulario FILAS_COLUMNAS Se trata del formulario contenido en el dock situado a la izquierda del marco principal del proyecto. En él se editan las variables globales que se usan para establecer el número de filas/columnas del casillero de familias y del de artículos y un botón que simplemente ejecuta una acción que abre el formulario que contiene los casilleros (PRINCIPAL). Formulario PRINCIPAL Se trata del formulario que contiene los casilleros y un evento que los sincroniza.

7 Página 7 de 10 Como habíamos indicado antes, el único control que tiene es un splitter que contiene dos subformularios, uno con el casillero de familias y otro con el de artículos. Formulario PRINCIPAL_FAMILIAS Se trata del subformulario que contiene el casillero de familias: Contiene los elementos siguientes: Un control objeto que presenta un casillero alimentado por proceso que carga las familias. Dicho proceso no tiene tabla de origen pero sí tiene como destino una lista de la tabla de familias: El proceso carga la lista completa de familias y la envía a la salida.

8 Página 8 de 10 Una variable local de tipo numérico llamada FILA_COLUMNA que se usará para almacenar el número de filas/columnas que el usuario haya establecido antes de abrir este formulario. Un control de texto estático que contiene la fórmula siguiente: choose ( FILA_COLUMNA, choose( FILA_COLUMNA > 1, "" + numbertostring(fila_columna, "L", 0) + " columnas", "" + FILA_COLUMNA + " columna"), "Columnas automáticas" ) Si la variable local es igual 0, presentará el texto "Columnas automáticas", en caso contrario presentará un texto indicando el nº de columnas que el usuario haya establecido. Un evento de interfaz que asigna el valor establecido en la variable global correspondiente a la variable local del formulario: Una conexión de evento que dispara el evento anterior a inicializarse el formulario. Formulario PRINCIPAL_ARTICULOS Se trata del subformulario que contiene el casillero de artículos. El formulario es igual que el anterior, lo que cambia es el proceso de carga del casillero de artículos. Este tiene asociado un proceso que no contiene ninguna instrucción. El motivo de hacerlo de este modo es que la carga de los artículos no se hará desde este proceso sino que se hará desde un evento del formulario PRINCIPAL que se lanzará cuando el usuario seleccione una casilla en el casillero de familias, llamado FAMILIAS_CAMBIO_ITEM. Evento FAMILIAS_CAMBIO_ITEM Este evento declarado en el formulario PRINCIPAL es el que realmente se encarga de alimentar el casillero de artículos: Este evento de interfaz es disparado desde la siguiente conexión:

9 Página 9 de 10 El control que la va a disparar será el casillero de familias incluido en el primer subformulario del splitter, y la será el cambio de elemento seleccionado en dicho casillero. Ejecutando el proyecto Al ejecutar el proyecto por primera vez, dado que las variables globales tienen inicialmente valor 0, los casilleros serán construidos de forma automática por el sistema. En el caso de que queramos definir nosotros el número de filas/columnas para cada casillero, especificaremos en el dock de la izquierda el valor deseado en cada variable global y pulsaremos el botón Cargar casilleros; al hacerlo en el panel central se abrirá una nueva ventana con los casilleros aplicada la nueva configuración:

10 Página 10 de 10 Si seleccionamos una familia en el casillero de familias, veremos cómo en el de artículos se cargarán los artículos enlazados con la misma.