Cosmos. Nuevas funcionalidades de la versión 2.4

Gramática

Eventos

Se han añadido nuevos eventos para los «Forms»:

Nuevo evento de «Form» «OnTimer» («timerId as integer»). Esta notificación se le manda al «Form» cuando ha transcurrido un determinado intervalo de tiempo indicado en el método «SetTimer».
Nuevo evento de «Form» «ExMessage». Esta notificación la recibe un «Form» Cosmos como respuesta a un mensaje de Windows enviado desde un programa externo.
Nuevo evento «On Dragover controlId» («fromCtr as SimpleFormControl, fromItem as integer, var result as integer»). El control manda esta notificación al «Form» cuando se hace «drag» (arrastrar) sobre él. Esta notificación se puede aplicar a los controles de tipo «List Box», «Box Group» y «Button Group» en una screen. En esta notificación se indicarán las acciones a realizar en el control sobre el que se arrastra.
Nuevo evento «On Dragdrop controlId» («item as integer, fromCtr as SimpleFormControl, fromItem as integer, var result as integer»). El control manda esta notificación al «Form» cuando se hace «drop» (soltar) sobre él. Esta notificación se puede aplicar a los controles de tipo «List Box», «Box Group» y «Button Group» en una screen. En esta notificación se indicarán las acciones a realizar en el control sobre el que se suelta el elemento arrastrado.
Nuevo evento de «Grid» «On Click» («col as Integer»). Indica que se ha pulsado en la cabecera de una columna del Grid.

Propiedades

Se han añadido nuevas propiedades a los controles:

«TabStop»: Permite consultar o modificar si un control puede recibir el foco en ejecución.
«Picture»: Nueva propiedad para controles «Edit Field», «Drop Edit», «Text» de «Form» y «Variable» de «Page» (sólo si es de tipo carácter). Permite consultar o modificar la máscara de edición para los controles que pueden tener asociada una variable de tipo «Char».
«Mask»: Permite consultar o modificar la máscara de edición para los controles que pueden tener asociada una variable de tipo «Smallint», «Integer», «Decimal», «Date» y «Time».
«Precision»: Permite consultar o modificar la precisión para los controles que pueden tener asociada una variable de tipo «Decimal».

Compilador de ficheros de mensajes

Ha cambiado la línea de comandos del comando cosmsg.

Nuevas variables de entorno

Se han añadido las siguientes variables de entorno:

DBDATERANGE
Uno de los problemas que trae consigo la entrada en el año 2000 afecta a aquellos programas que solicitan la fecha utilizando dos dígitos para expresar el año.

Hasta ahora, al valor del año introducido se le sumaba siempre 1900. Así, «01/01/98» significaba «01/01/1998», mientras que «01/01/00» significaba «01/01/1900».

El problema radica en que, a partir de ahora, va a ser más habitual que una fecha como «01/01/00» o «01/01/05» se refieran a los años 2000 y 2005, respectivamente, en lugar de a los años 1900 y 1905, como hasta ahora venía sucediendo.

A partir de esta versión, Cosmos incorpora un mecanismo diferente para determinar el año a partir de dos dígitos.
En lugar de considerar el siglo (1900 a 1999) como rango en el que se movían los años de dos dígitos, se tomará el siglo en el que el año actual sea su mitad (por ejemplo, 1948 a 2047). De este modo, las fechas desde el 48 al 99 se consideran 1948 a 1999, y las del 00 al 47 serán fechas del 2000 al 2047. Este rango irá variando automáticamente año a año, de forma que el año en curso sea siempre el centro del rango anual.

Es posible que para alguna aplicación en concreto este rango de años que ahora se va a tomar automáticamente (50 atrás y 50 adelante) no sea conveniente y que se prefiera que se asuman rangos de fechas del tipo 70 atrás y 30 adelante, u otra combinación. Para este caso se ha definido una nueva variable de entorno, denominada «DBDATERANGE», que permite definir este rango. Como valor de la variable «DBDATERANGE» se define el número de años atrás del actual en el que empieza el rango de fechas. Así, si definimos «DBDATERANGE=10» y el año actual es 1998, estaremos considerando un rango de años que va desde el 1988 al 2087.

DATEQUOTED
Esta variable de entorno de conexión indica el carácter que se utiliza para delimitar los campos de tipo «DATE».

Esta variable de entorno se define en la conexión, ya que depende del gestor de base de datos que se utilice.

Para conexiones ODBC con Microsoft Access se debe definir esta variable de entorno de la siguiente forma:

DATEQUOTED = #

Si no se indica esta variable de entorno se utilizará el caracter «"» (comillas dobles).

EDITMODE
Esta variable indica si está activo el modo edición de los «Forms» Cosmos. En modo edición se inhabilitan todas las tablas y solamente se permite editar campos cuando exista una tabla en edición. Al entrar en el «Form» en modo edición sólo se permite activar una tabla en edición a la vez. Su valor puede ser 0 ó 1. Por ejemplo:

EDITMODE = 1

LOOKUPDELAYED
Si tiene el valor 1, en la realización de consultas sobre la base de datos los «lookups» definidos en las columnas de las tablas se resuelven al mostrar los registros. Si se le da el valor 0 los «lookups» se resuelven al realizar la lectura de los registros. Por ejemplo:

LOOKUPDELAYED = 1

QUERYPROGRESSWINDOW
Esta variable indica el tiempo (en segundos) que se esperará para mostrar el cuadro de diálogo de progreso en la realización de consultas sobre la base de datos. Por ejemplo:

QUERYPROGRESSWINDOW = 1

Nuevas DLLs

Esta versión de Cosmos incluye cuatro nuevas DLLs:

Repdll.dll
Incluye las funciones necesarias para leer un repositorio.
Prjdll.dll
Incluye las funciones necesarias para leer un proyecto.
Inwords.Dll
Util32.dll
Incluye las funciones necesarias para acceder a los puertos serie del ordenador.
Cosdoc32.dll
Permite documentar un proyecto y un repositorio.

Nuevas utilidades

La versión 2.4 de Cosmos incorpora las siguientes utilidades:

Un editor de instalaciones («Cosinsed.exe») que permite generar los ficheros de instalación de una aplicación o proyecto Cosmos.
Una utilidad para construir aplicaciones de acceso a bases de datos a través de la «World Wide Web» (www).
Comando «repconv»: Este comando permite volcar un repositorio de binario a ASCII y viceversa. Su sintaxis es la siguiente:

repconv -exp | -imp -crf repositorio_binario -srf repositorio_ascii

Donde:

-exp	Vuelca de binario a ASCII.
-imp	Carga de ASCII a binario.
repositorio_binario	Nombre del repositorio en formato binario, con su «path» completo y su extensión «.crf».
repositorio_ascii	Nombre del repositorio en formato ASCII, con su «path» completo y su extensión «.srf».

Comando «cosprj»: Este comando permite volcar un proyecto de binario a ASCII y viceversa. Su sintaxis es la siguiente:

cosprj -exp | -imp -prj proyecto_binario -srj proyecto_ascii

Donde:

-exp	Vuelca de binario a ASCII.
-imp	Carga de ASCII a binario.
proyecto_binario	Nombre del proyecto en formato binario, con su «path» completo y su extensión «.prj».
proyecto_ascii	Nombre del proyecto en formato ASCII, con su «path» completo y su extensión «.srj».