Rejilla
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
La rejilla es un objeto que sirve para presentar listas de registros de las .
La rejilla siempre va asociada a una tabla de un . El flujo es lista de la tabla asociada tanto para la entrada como para la salida.
La rejilla está compuesta por una serie de celdas distribuidas en forma de filas y columnas. Una fila se corresponde con un registro de una tabla y una columna con un campo de la tabla. Una celda, por tanto, permitirá mostrar un dato concreto de un registro concreto de la tabla.
Para crear una rejilla usaremos la opción nuevo objeto del menú objeto o a través de la galería de objetos (Tecla F6) de
Sus propiedades son:
Etiqueta alfanumérica que identifica al objeto. Este identificador será el que se usa para referenciarlo en los y en las propiedades de otros objetos.
Etiqueta alfanumérica que servirá como descriptor de la rejilla. Es el texto que se presentará al usuario final de la aplicación para referenciar la rejilla.
Podemos definir una etiqueta por cada idioma presente en el .
Podemos definir los estilos siguientes:
Que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Si la rejilla tiene asociado un formulario de modificación, si este estilo está activado al hacer un clic sobre un ítem de la rejilla éste será editado en el formulario correspondiente. Si este estilo está desactivado el usuario tendrá que hacer doble clic para editar la ficha.
Permite omitir la barra de título de la ventana. Solamente funcional en cuadros de diálogo.
Permite omitir el menú de sistema de la ventana.
Permite ocultar el botón maximizar de la ventana.
Permite ocultar el botón minimizar de la ventana.
Permite ocultar el botón de cierre de la ventana.
Esta propiedad nos permite documentar el uso de la rejilla.
Tabla de un proyecto de datos heredado cuyos registros van a ser visualizados en la rejilla.
Formulario del proyecto en curso o de un proyecto heredado que será para editar una ficha desde la rejilla.
Formulario del proyecto en curso o de un proyecto heredado que será para eliminar una ficha desde la rejilla.
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:
La rejilla carecerá de menú de contexto.
La rejilla dispondrá de un menú de contexto creado automáticamente por el sistema, que contendrá las opciones siguientes:
Alta de ficha: Si la rejilla 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 a la rejilla.
Baja de ficha: Abrirá el formulario de bajas asociado a la rejilla.
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 a la rejilla.
Ordenar: Permite al usuario ordenar la lista por el campo que elija.
Quitar de la lista el seleccionado: Quita de la rejilla el registro que el usuario tenga seleccionado. No lo borra físicamente, sino que simplemente lo quita de la lista.
La rejilla 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.
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 de la rejilla.
Multiselección: Esta propiedad tiene dos valores posibles: Falso y Verdadero. Permitirá que en tiempo de ejecución se pueda realizar una selección múltiple de registros en la rejilla.
Permite configurar qué cabeceras de la rejilla serán visualizadas. Los valores posibles son:
Se mostrará horizontalmente, en la parte superior de la rejilla, un encabezado con los títulos de cada columna y verticalmente, en la parte izquierda de la rejilla, un encabezado que mostrará la posición física que cada registro ocupa el en fichero. Este valor no estará disponible si e la rejilla se le ha activado la propiedad pie activo.
Se mostrará horizontalmente, en la parte superior de la rejilla, un encabezado con los títulos de cada columna.
Se mostrará verticalmente, en la parte izquierda de la rejilla, un encabezado que mostrará el valor del campo ID de cada registro. Este valor no estará disponible si e la rejilla se le ha activado la propiedad pie activo.
No se mostrará ningún encabezado.
Esta propiedad sólo es visible si la propiedad multiselección tiene el valor verdadero y la propiedad modo ver cabeceras tiene el valor vertical u horizontal y vertical. Nos permite hacer que la cabecera vertical se comporte como si fuese un checkbox que permite marcar y desmarcar el registro haciendo clic de ratón en dicha columna. Si esta propiedad está desactivada, los registros los seleccionaremos haciendo clic con el puntero del ratón y manteniendo pulsada la tecla control, si se desean añadir más registros a la selección.
Esta propiedad tiene dos valores posibles: Falso y Verdadero. Si el valor es verdadero permitirá que en tiempo de ejecución el usuario pueda tanto crear como modificar los registros directamente en la rejilla. Esta misma propiedad, una vez activada, habrá que activarla a las columnas que deseemos que puedan editar los usuarios finales.
Altura, en píxels, que tendrá la sección de la cabecera de la rejilla. Si aplicamos un valor 0, hará que tanto en edición como ejecución se calcule su tamaño automáticamente en función del tipo de letra y aplicándose los márgenes por defecto del estilo visual usado.
La cabecera de una rejilla es creada a modo de botón tridimensional. En esta propiedad seleccionaremos el color de la cara de la cabecera. Por defecto, se tomará el color para ventana de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
La cabecera de una rejilla es creada a modo de botón tridimensional. En esta propiedad seleccionaremos el color de luz de la cabecera. Por defecto, se tomará el color para luz de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
La cabecera de una rejilla es creada a modo de botón tridimensional. En esta propiedad seleccionaremos el color de la cara de la cabecera. Por defecto, se tomará el color para sombra de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
Altura, en píxels, que tendrá la sección del cuerpo de la rejilla. Si aplicamos un valor 0, hará que tanto en edición como ejecución se calcule su tamaño automáticamente en función del tipo de letra y aplicándose los márgenes por defecto del estilo visual usado.
En esta propiedad seleccionaremos el color de fondo del cuerpo. Por defecto, se tomará el color base de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
En esta propiedad seleccionaremos el color de fondo para las líneas pares del cuerpo. El color seleccionado en la propiedad anterior será el que se use para las líneas impares. Por defecto, se tomará el color base alternativo de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
En esta propiedad seleccionaremos el color que se usará para pintar las líneas que delimitan cada celda de la rejilla. Por defecto, se tomará el color para texto ventana de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
Esta propiedad tiene dos valores posibles: Falso y Verdadero. Permitirá mostrar un pie para presentar, por ejemplo, un texto o la suma acumulada de una columna.
Esta propiedad solamente estará disponible cuando el valor de la propiedad pie activo sea verdadero. Nos permitirá definir la altura, en píxels, que tendrá la sección del pie de la rejilla. En el caso de querer mostrar esta sección, tendremos que especificar su altura en píxels.
Esta propiedad solamente estará disponible cuando el valor de la propiedad pie activo sea verdadero. Seleccionaremos el color de fondo para el pie. Por defecto, se tomará el color base de la paleta asociada a la rejilla. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
Se trata de una propiedad de carácter informativo, no puede ser modificada. Muestra el ancho total de la rejilla.
Cuando creamos una rejilla se abra el asistente para su creación.
En el primer paso del asistente tendremos que establecer las propiedades siguientes:
Habrá que seleccionar una tabla de un proyecto de datos heredado en la lista que se presenta.
Etiqueta alfanumérica que servirá como descriptor del campo. Se usará para presentar información del campo en objetos. El programa propone por defecto el nombre plural de la tabla.
Formulario asociado para dar altas en la tabla.
Formulario asociado para modificar un registro de la tabla.
Formulario asociado para borrar un registro de la tabla.
Pulsar el botón “siguiente” para ir al siguiente paso o el botón “cancelar” para abortar la creación de la rejilla.
Los campos seleccionados aparecerán en la lista de campos seleccionados del asistente y se verán desactivados en la lista de campos seleccionables.
Las columnas de la rejilla serán creadas siguiendo el mismo orden que tengan los campos en el panel de campos seleccionados.
Pulsar el botón “siguiente” para ir al siguiente paso o el botón “retroceder” para volver al paso anterior o el botón “cancelar” para abortar la creación de la rejilla.
El siguiente paso es la configuración del aspecto visual de la rejilla.
Las propiedades a cumplimentar son:
Selección de la paleta de colores que usará la rejilla. Podremos elegir entre cualquiera de las paletas del sistema o las paletas declaradas en el proyecto.
En la parte inferior del asistente se muestra una vista previa de la rejilla, según los valores seleccionados en ambas propiedades.
Pulsar el botón “siguiente” para ir al siguiente paso o el botón “retroceder” para volver al paso anterior o el botón “cancelar” para abortar la creación de la rejilla.
En el último paso del asistente se muestra el identificador con el que la rejilla será creada. Usará el nombre dado a la rejilla en el primer paso del asistente.
Pulsar el botón “siguiente” para ir al siguiente paso o el botón “retroceder” para volver al paso anterior o el botón “cancelar” para abortar la creación de la rejilla.
La rejilla será añadida a la lista de objetos del proyecto.
Como puede observarse en la imagen anterior, se muestra una previsualización de la misma en el dock central y sus propiedades en el panel de propiedades de Velneo vDevelop.
Para editar las propiedades de una columna, simplemente bastará con hacer un clic sobre la cabecera de la misma en el editor de rejillas.
La columna que se encuentre editada se diferenciará del resto de las columnas en el editor por aparecer un triángulo en la cabecera y un área de selección dentro de la primera línea del cuerpo de la misma:
En la primera fila se muestra el ancho, en píxels, de cada columna.
Podremos cambiar el ancho de una columna haciendo clic con el puntero del ratón sobre el margen derecho de una celda y, sin soltar el botón del ratón, desplazándolo a izquierda o derecha:
Además, el editor de rejillas incluye una toolbar que incluye los comandos siguientes:
Cuando la rejilla va a ser el origen en un evento de drag and si está activado este estilo, en ejecución los items arrastrados no serán quitados de la misma tras ejecutar el evento de drop.
Cuando la rejilla va a ser el origen en un evento de drag and si está activado este estilo, en ejecución los ítems arrastrados serán quitados de la misma tras ejecutar el evento de drop.
del en curso o de un proyecto heredado que será usado para dar de alta una ficha desde la rejilla.
Personalizado: El menú de contexto de la rejilla será un objeto contenido en el proyecto.
Si seleccionamos una en este parámetro, cada vez que usemos esta rejilla, ésta llevará embebida la toolbar seleccionada, que podrá situarse, o bien encima o bien debajo de la rejilla.
Es un reloj que permitirá ejecutar automáticamente uno o varios declarados en la rejilla 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.
El siguiente paso es la selección de a presentar en la rejilla.
Para añadir un campo hacer doble clic sobre el mismo en la lista del campos seleccionables que se presenta en la parte superior del asistente o pulsar el botón .
Para añadir todos los campos de la tabla pulsar el botón .
Para quitar un campo de la lista de campos seleccionados tendremos que seleccionarlo y pulsar el botón .
Para quitar todos los campos de la lista de campos seleccionados pulsar el botón .
Para subir una posición un campo en el panel de campos seleccionados tendremos que seleccionarlo y pulsar el botón.
Para bajar una posición un campo en el panel de campos seleccionados tendremos que seleccionarlo y pulsar el botón .
incorpora un editor para facilitar la modificación de las propiedades de una rejilla. Para abrirlo bastará con hacer doble clic sobre un objeto de tipo rejilla y será mostrado en el panel central de Velneo vDevelop.
Mostrar las propiedades de la rejilla: Cuando estamos visualizando las propiedades de una columna pulsaremos este comando para cambiar a la visualización de las propiedades de la rejilla.
Añadir columna: Añade una columna al final de la rejilla.
Insertar columna: Inserta una columna en la rejilla, a la derecha de la columna seleccionada.
Borrar columna: Elimina la columna seleccionada.
Mostrar/ocultar: Muestra/oculta una columna en el editor desde la que se podrá modificar la altura de las filas de la rejilla.
Ancho de título: Redimensiona el ancho de una columna en función del tamaño del texto contenido en su cabecera.
Ancho de contenido: Redimensiona el ancho de una columna en función del tamaño del contenido del cuerpo.
Mover izquierda: Mueve la columna seleccionada una posición a la izquierda.
Mover derecha: Mueve la columna seleccionada una posición a la derecha.
