Última actualización
Última actualización
Etiqueta alfanumérica que identifica la columna de la Este identificador será el que se usa para referenciarla en los y en las propiedades de otros objetos.
Etiqueta alfanumérica que servirá como descriptor de la columna. Es el texto que se presentará al usuario final de la apaslicación como título de la columna en el caso de que no se haya establecido valor alguno en la propiedad contenido cabecera. Podemos definir una etiqueta por cada idioma presente en el
Privado
Activado, limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Optimizado
Si activamos esta opción, el sistema reducirá el número de conexiones con el servidor que requieren determinados tipos de (singular, indirecto virtual, indirecto real y hermano contiguo) y fórmulas con campos de maestros o de proceso.
Si el estilo está activado, primero se presentará la rejilla y luego se harán los cálculos de la columna. En caso contrario, hará ambas cosas al mismo tiempo.
Esta propiedad nos permite documentar el uso de la columna de la rejilla.
Anchura, en píxels, de la columna.
Permite configurar si el ancho de la columna va a ser fijo o variable. Los valores posibles son:
Interactivo
En ejecución, la columna se presentará con el ancho dado en el parámetro anterior pero el usuario podrá modificarlo.
Fijo
En ejecución, la columna se presentará con el ancho dado en el parámetro anterior y el usuario no podrá modificarlo.
Máximo disponible
En ejecución, la columna se expandirá o contraerá según la anchura de la ventana o el control donde la rejilla esté situada. Este tipo permitirá que la rejilla ocupe el ancho máximo disponible.
Ancho redimensionable
Para permitir o no que el usuario final pueda cambiar el ancho de la columna.
Si en tiempo de ejecución debido al ancho de una columna su contenido no puede verse al completo, al situar el puntero del ratón sobre la celda se mostrará un tooltip con el contenido completo de la misma.
Permite condicionar la visibilidad de la columna en base a una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.
Permite establecer como título de la cabecera un texto dinámico. Para ello podremos usar el asistente para edición de fórmulas. Pulsar el botón que aparece al editar esta propiedad para abrirlo.
En esta propiedad seleccionaremos el color del texto de la cabecera de la columna. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
Permite configurar la forma en la que el texto de la cabecera será alineado entre los márgenes izquierdo y derecho de la celda. Los valores posibles son:
Izquierda
Derecha
Centrado
Justificado
Permite configurar la forma en la que el texto de la cabecera será alineado entre los los márgenes superior e inferior de la celda. Los valores posibles son:
Arriba
Abajo
Centrado
En esta propiedad indicaremos qué es lo que va a mostrarse en esa columna mediante una fórmula, que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.
Si en la fórmula especificamos únicamente un campo, la columna será tratada según el tipo de campo. Es decir, si el campo es numérico, el contenido de la celda será un número, por lo que, al reordenar por dicha columna, su contenido será ordenado numéricamente; si es un campo alfabético, al reordenar por la columna se ordenará por orden alfabético.
En el caso de que en el parámetro no especifiquemos un campo sino una fórmula con varios campos, variables, etc., el resultado, sea del tipo que sea, siempre será tratado como cadena.
Si en el cuerpo queremos presentar el icono de un campo enlazado a una tabla estática, el asistente de fórmulas no nos dejará seleccionar el icono, pero podremos establecerlo manualmente, para ello, en la lista de campos seleccionaremos el campo enlazado a la tabla estática y le añadiremos el texto ".ICON". Ejemplo: #ESTADO.ICON
En esta propiedad seleccionaremos el color del texto del cuerpo de la columna. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
Permite configurar la forma en la que el texto del cuerpo será alineado entre los márgenes izquierdo y derecho de la celda. Los valores posibles son:
Izquierda
Derecha
Centrado
Justificado
Permite configurar la forma en la que el texto del cuerpo será alineado entre los los márgenes superior e inferior de la celda. Los valores posibles son:
Arriba
Abajo
Centrado
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. Esta propiedad permite activar la edición directa del campo editado en esa columna. En función del tipo de campo, en las propiedades de la columna aparecerán propiedades específicas. En los subcapítulos dedicados a cada tipo de editor, se explicarán las específicas de cada uno.
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. En ella podremos establecer una condición que, si no se cumple, impedirá que el contenido de la celda pueda ser editado. Para facilitar su especificación podemos hacer uso del asistente para edición de fórmulas.
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. En ella podremos establecer qué tipo de control se usará para editar el campo de esa columna. Los valores posibles son:
Por defecto: el sistema usará el tipo de control por defecto para el tipo de campo editado en la columna.
Edición alfabética: para campos alfanuméricos.
TextEditBrowser: control de edición de texto multilínea. Edita campos de tipo objeto texto normal y enriquecido.
Edición numérica: para campos numéricos.
BoundFieldEdit: para campos enlazados a tabla de datos maestra.
Edición fecha/hora: para campos de tipo tiempo.
Edición fecha: para campos de tipo fecha.
Edición hora: para campos de tipo hora.
ComboBox: para campos enlazados a tablas estáticas.
ImageEdit: para campos de tipo objeto dibujo.
Edición fórmula: para campos de tipo objeto fórmula.
Edición senda fichero: para editar campos en los que queramos guardar sendas de ficheros.
Edición senda directorio: para editar campos en los que queramos guardar sendas de directorios.
Los campos de tipo fecha solamente podrán ser editados en modo fecha, ya que no existe la edición de fechas en modo alfanumérico en las rejillas editables.
Si la columna va a presentar un campo numérico, esta propiedad permitirá definir si queremos que se aplique un formato numérico local del sistema operativo en el que se muestra la rejilla o no. Los valores posibles son:
Ninguno: no se aplicará ningún formato.
Local: aplica la configuración de número que se tenga establecida en el sistema en el que se visualiza el dato.
Moneda: aplica la configuración de moneda que se tenga establecida en el sistema en el que se visualiza el dato.
Esta propiedad estará disponible si en las propiedades de la rejilla la propiedad pie activo tiene valor verdadero. Permite configurar la forma en la que el texto del pie será alineado entre los márgenes izquierdo y derecho de la celda. Los valores posibles son:
Izquierda
Derecha
Centrado
Justificado
Esta propiedad estará disponible si en las propiedades de la rejilla la propiedad pie activo tiene valor verdadero. Permite configurar la forma en la que el texto del pie será alineado entre los los márgenes superior e inferior de la celda. Los valores posibles son:
Arriba
Abajo
Centrado
Si la columna es numérica, esta propiedad permitirá definir si queremos que se aplique un formato local del sistema operativo en el que se muestra la rejilla o no. Los valores posibles son:
Ninguno: no se aplicará ningún formato.
Local: aplica la configuración de número que se tenga establecida en el sistema en el que se visualiza el dato.
Moneda: aplica el formato de moneda (número de decimales, separador de miles y decimal) para el idioma en el que se está ejecutando la instancia.
Esta propiedad estará disponible si en las propiedades de la rejilla la propiedad pie activo tiene valor verdadero. En ella configuraremos el número de decimales que deseamos mostrar en el pie.
Esta propiedad estará disponible si en las propiedades de la rejilla la propiedad pie activo tiene valor verdadero. Permite definir qué es lo que se mostrará en el pie. Los valores posibles son:
Sin contenido: el pie de la columna no tendrá contenido.
Suma acumulada de toda la columna: para columnas que muestran campos numéricos. Presenta la suma acumulada de toda la columna.
Fórmula acumulable: el pie de la columna será un número, obtenido de la suma del resultado de la fórmula que indiquemos en el parámetro contenido pie por cada registro de la rejilla. Para su especificación podemos hacer uso del asistente para edición de fórmulas. El cálculo se va haciendo en local, en 2º plano para no bloquear la rejilla.
Fórmula acumulable 3er plano: el pie de la columna será un número, obtenido de la suma del resultado de la fórmula que indiquemos en el parámetro contenido pie por cada registro de la rejilla. Para su especificación podemos hacer uso del asistente para edición de fórmulas. El cálculo se hará en el servidor y se actualizará el dato una vez haya sido calculado. Es más rápido y eficiente que la fórmula acumulable. Recomendado sobre todo para aplicaciones en cloud. Obviamente, en este caso, no podremos hacer uso de variables locales en la fórmula, ya que no viajan entre el cliente y el servidor.
Permite asignar un menú de contexto al control. Los valores posibles son:
Ninguno: en ejecución el control carecerá de menú de contexto.
Por defecto: en ejecución se usará el menú de contexto por defecto del control. No todos los controles por defecto tienen menú de contexto.
Este parámetro solamente estará disponible si en el parámetro anterior hemos seleccionado el valor personalizado. En él seleccionaremos el objeto menú declarado en el proyecto de aplicación o en cualquier proyecto heredado que queremos usar como menú de contexto del control.
Para campos numéricos. Permite anteponer un prefijo al contenido de la columna. Dicho prefijo se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad. Podríamos usarlo, por ejemplo, para indicar el símbolo de la moneda. Esta fórmula solamente será evaluada al crearse la rejilla.
Para campos numéricos. Permite añadir al contenido de la columna un sufijo. Dicho sufijo se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad. Podríamos usarlo, por ejemplo, para indicar el símbolo de la moneda. Esta fórmula solamente será evaluada al crearse la rejilla.
Para columnas de campos numéricos. Permite especificar el nº de decimales que se desea mostrar en la columna. Tiene sentido para recortar el número de decimales con respecto a los definidos en las propiedades del campo; puede suceder que internamente trabajemos con cuatro decimales y al usuario nos interese mostrar solamente dos. En el caso de que especifiquemos un número de decimales mayor al definido en las propiedades del campo/variable, serán despreciados los que sobrepasen el rango establecido. Esta fórmula solamente será evaluada al crearse la rejilla.
El número máximo de decimales permitidos en esta propiedad es de 6.
Si dejamos vacía la propiedad el contenido del campo será presentado con el número de decimales definido en sus propiedades.
A través de este subobjeto se podrá modificar el estilo de visualización de una celda (fuente, color, etc.) en función de una condición.
Sus propiedades son las siguientes:
Etiqueta alfanumérica que identifica de forma unívoca al subobjeto dentro del proyecto. Este identificador será el que usemos para referenciarlo en otras propiedades de otros objetos.
Constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca un objeto no puede haber duplicidad.
Podemos definir una etiqueta por cada idioma presente en el proyecto.
Podemos definir el estilo privado que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Esta propiedad nos permite documentar el uso del objeto.
Permite establecer la condición que se ha de cumplir para que el estilo sea aplicado a una celda de la columna, en base a una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.
En esta propiedad seleccionaremos la fuente que se aplicará a la celda si se cumple la condición establecida en la propiedad anterior. Pulsar el botón que aparece al editar esta propiedad para abrir el selector de fuentes.
En esta propiedad seleccionaremos el color que se aplicará al texto de la celda si se cumple la condición establecida. 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 aplicará al fondo de la celda si se cumple la condición establecida. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.
En el caso de que solamente queramos modificar el color de texto y no el de fondo, lo que tendremos que hacer es usar como color de fondo un color con el 100% de transparencia (canal alfa = 0); de este modo, se respetará el color de fondo definido en las propiedades a la rejilla.
Es posible crear más de una condición de estilo para una misma columna. Lo habitual es se apliquen condiciones excluyentes, por ejemplo, una para aplicar a los valores positivos de un campo y otra para aplicar a los valores negativos del mismo. Pero, en el caso de que las condiciones especificadas no sean excluyentes, es decir, que un mismo registro cumple más de una de las condiciones establecidas, la que prevalecerá será la que se encuentre más arriba en la lista de condiciones de estilo establecidas.
Debemos tener en cuenta que si en un evento de interfaz ejecutado desde una columna de una rejilla editable usamos el comando de instrucción de proceso set retorno proceso = NO, su ejecución solamente hará que no se ejecuten otros eventos asociados asociados a otras columnas editables del registro que esté siendo editado. Por lo tanto, si queremos hacer que no se avance el foco o se cancele la edición del registro al editar una celda de una rejilla tendremos que hacerlo mediante el control de la señal de tecla pulsada (tabulador o enter).
Este control no debe usarse para editar campos de tipo objeto ni de campos enlazados a maestro, ni de campos de tipo booleanos, numéricos, fecha, hora y tiempo. Existen controles específicos para esos tipos de campo.
Al hacer editable una columna con un campo alfanumérico o seleccionar este tipo de editor en una columna editable, podremos configurar las propiedades siguientes:
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. Permite asociar un objeto menú a la columna, este menú podrá ser disparado cuando la celda sea editada usando la combinación de las teclas Shift + F4.
Esta propiedad solamente estará disponible si la columna es editable. Permite incluir dentro de la celda un botón que al pulsarlo desplegará el menú que se haya indicado en la propiedad menú de edición cuerpo.
Los valores posibles son:
Ninguno: en ejecución el control carecerá de menú de botón.
Botón izquierda: el botón será incluido a la izquierda del control.
Botón derecha: el botón será incluido a la derecha del control.
El icono que se usará en el botón será el asignado al objeto menú en sus propiedades y, en caso de no tener dibujo alguno asignado, se presentará un icono interno de la plataforma.
Es posible usar las mismas teclas aceleradoras en los menús incluidos en botones de distintos controles de un mismo formulario pues siempre se ejecutará la acción del control que tenga el foco.
En tiempo de ejecución para desplegar el menú a través del teclado usaremos la combinación de las teclas Shift + F4.
Editor específico para campos de tipo objeto texto y objeto texto enriquecido. Al hacer editable una columna con un campo objeto texto u objeto texto enriquecido, o seleccionar este tipo de editor en una columna editable, podremos configurar las propiedades siguientes:
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. Permite asociar un objeto menú a la columna, este menú podrá ser disparado cuando la celda sea editada usando la combinación de las teclas Shift + F4.
Esta propiedad solamente estará disponible si la columna es editable. Permite incluir dentro de la celda un botón que al pulsarlo desplegará el menú que se haya indicado en la propiedad menú de edición cuerpo. Los valores posibles son:
Ninguno: en ejecución el control carecerá de menú de botón.
Botón izquierda: el botón será incluido a la izquierda del control.
Botón derecha: el botón será incluido a la derecha del control.
Botón oculto: el botón no será visible pero podrán dispararse las acciones contenidas en el menú asociado al mismo usando las teclas aceleradoras definidas en las mismas.
El icono que se usará en el botón será el asignado al objeto menú en sus propiedades y, en caso de no tener dibujo alguno asignado, se presentará un icono interno de la plataforma.
Es posible usar las mismas teclas aceleradoras en los menús incluidos en botones de distintos controles de un mismo formulario pues siempre se ejecutará la acción del control que tenga el foco.
En tiempo de ejecución para desplegar el menú a través del teclado usaremos la combinación de las teclas Shift + F4.
Editor exclusivo para la edición de campos numéricos. El control tiene unos microescrollers (botones arriba y abajo) embebidos, que permitirán modificar el contenido del objeto o sub-objeto asociado, incrementando/decrementando su valor por cada pulsación.
Este control está orientado a la edición, por lo que no debe ser usado para mostrar campos de tipo fórmula numérica. Para este tipo de campos debemos usar otros controles como por ejemplo edición o texto estático.
Al hacer editable una columna con un campo numérico o seleccionar este tipo de editor en una columna editable, podremos configurar las propiedades siguientes:
Esta propiedad solamente estará disponible si en las propiedades de la rejilla se ha activado la propiedad editable. Permite asociar un objeto menú a la columna, este menú podrá ser disparado cuando la celda sea editada usando la combinación de las teclas Shift + F4.
Esta propiedad solamente estará disponible si la columna es editable. Permite incluir dentro de la celda un botón que al pulsarlo desplegará el menú que se haya indicado en la propiedad menú de edición cuerpo. Los valores posibles son:
Ninguno: en ejecución el control carecerá de menú de botón.
Botón izquierda: el botón será incluido a la izquierda del control.
Botón derecha: el botón será incluido a la derecha del control.
Botón oculto: el botón no será visible pero podrán dispararse las acciones contenidas en el menú asociado al mismo usando las teclas aceleradoras definidas en las mismas.
El icono que se usará en el botón será el asignado al objeto menú en sus propiedades y, en caso de no tener dibujo alguno asignado, se presentará un icono interno de la plataforma.
Es posible usar las mismas teclas aceleradoras en los menús incluidos en botones de distintos controles de un mismo formulario pues siempre se ejecutará la acción del control que tenga el foco.
En tiempo de ejecución para desplegar el menú a través del teclado usaremos la combinación de las teclas Shift + F4.
Permite establecer el valor en el que se incrementará/reducirá el contenido del control al pulsar las teclas de movimiento de cursor arriba y abajo o los botones de los microscrollers del control en el caso de que estén visibles. Podremos introducir valores decimales. Si dejamos el valor 0 el sistema asumirá 1 como valor de incremento.