Elementos formulario de definición de Pantallas

Programa

Nombre de la pantalla y versión. Cuando se modifica una pantalla debe crearse una nueva versión. Una vez comprobado su correcto funcionamiento se elimina la anterior versión.

Núm. de control

Los controles hasta el número 50 son fijos (Ver controles fijos). En una pantalla no deben estar necesariamente todos. A partir del 51 son los específicos de la pantalla. No debe haber huecos a partir del control 51.

Tabulador

Entero que fija el orden de tabulación. Un cero indica que no interviene en la tabulación. En ese caso el control solo adquirirá el foco pinchando con el ratón.

Pestaña

Si la pantalla está organizada por pestañas, indica a que pestaña pertenece el control. La primera pestaña es la 1. Un 0 indica que no pertenece a ninguna.

Observaciones

Observaciones para el programador.

Etiqueta

Indica la etiqueta que mostrará el control. Su valor se toma de la tabla de literales. Se guarda el código del literal. El programa cliente se encarga de mostrar el valor asociado al idioma con el que se ha accedido a la aplicación. (Ver pantalla de inicio).

Referencia

Hace referencia a un número de control y número de función.

Se utiliza para controles que deben realizar una acción sobre un set de datos, por ejemplo fila arriba, fila abajo, etc. En este caso guardamos el control que guarda el cursor asociado al set de datos. El número de función debe ser siempre 1.

Ejemplo. En el control fijo 10 (Lupa de buscar) efectúa un SELECT según la selección introducida por el usuario y guarda el cursor asociado a ese SELECT. Si creamos un botón para navegar sobre los datos, por ejemplo 'fila abajo', deberemos indicarle en referencia el control 10.

Pos. Etiqueta

Posición de la etiqueta para campos caja de texto, tipo 'C', valores posibles:

• 'E': Encima del control
• 'I': A la izquierda del control.
• 'N': Sin etiqueta.

Para campos tipo texto, indica el tamaño o tipo de fuente:

• 'F': Espaciado fijo, para listados.
• 'P': Fuente pequeña.
• 'M': Fuente mediana.
• 'G': Grande.
• 'L': Espaciado fijo, fuente grande

Para campos tipo botón de herramienta, tamaño del botón:

• 'M': Tamaño medio, 24x24 pixels, valor por defecto.
• 'P': Tamaño pequeño, 17x17 pixels.
• 'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.

Núm. de dígitos

Número máximo de dígitos que albergará el control.

Para campos numéricos, no hay que contar comas, puntos de millares y signo.

Para campos fecha, el valor es irrelevante, siempre toma el valor 10.

Posición 1

Posición del control en coordenadas x,y. El punto 0,0 está situado en la esquina superior izquierda de la ventana.

Posición 2

Se utiliza en algunos controles para calcular el rectángulo del control. Controles que la utilizan:

• Texto extenso
• Tipo pantalla.
• Cuadro
• Pestaña

Para los campos “botón de herramienta” , coordenada x : 0. Coordenada y: indica el número de bitmap que debe aparecer en el control. Ver bitmaps de la aplicación.

Para los botones o controles que disponen de hotkey o tecla rápida usaremos la x de la posición 2 para indicar que número de hotkey se trata. Por ejemplo, el control 21 que es la ayuda tiene la hotkey 1, por lo que en posición 2, en la X, tendrá un 1 y para usarlo pulsaremos la tecla F1.

Enlazar control

Si indicamos un número de control, al pasar el control al programa, ejecutará las funciones propias del control y enlazará con las funciones que correspondan al control aquí indicado.

Tipo de Campo

Tipo de control: Caja de texto alfanúmerico, numérico, fecha, botón, cuadro, etc.

Para más información consulta la lista de tipos de campos.

Pertenencia

Indica la pertenencia a una sección de la pantalla, en caso de que las haya. Valores:

• 'B': El control pertenece a la cabecera de la pantalla, en pantallas con estructura Cabecera-Detalle.
• 'D': El control pertenece al detalle en pantallas con estructura Cabecera-Detalle.
• 'L': Pertenece a una línea de la “grid”, en pantallas con “grid”
• 'C': El control es la cabecera de la “grid” de la pantalla.

Nota: Sólo puede haber una grid en una pantalla. El control de cabecera de la grid y sus líneas de detalle deben estar seguidos en un sólo bloque.

Tipos de atributos de campos

Establece el estado del control en la situación de 'Altas', 'Modificaciones', 'Consulta' y 'Seleccionar'. El primer dígito controla el estado y el segundo el aspecto. La segunda columna de atributos de momento no se utiliza pero debe tener los mismos valores que la primera.

• 1er dígito: estado del control.
  • 0: Normal
  • 1: Deshabilitado
  • 2: No visible

• 2º dígito: apariencia del control: fondo y color.
  • 0: Atributo por defecto, normal
  • 1: No se utiliza.
  • 2: Fondo verde claro, letras negras. Si la aplicación resalta el control aparecerá en fondo verde oscuro y letras blancas. Se utiliza para los listados en que pueden seleccionarse lineas.
  • 3: Fondo blanco, letras negras, la aplicación lo resalta como el anterior. Se utiliza alternándolo con el anterior en los listados para que sean más legibles.
  • 4: Fondo verde oscuro, letras negro: Atributo por defecto
  • 5: Fondo azul oscuro, letras blancas. Se utiliza para la barra de título de una ventana.

Contenido

Define el tipo de contenido, la apariencia o el comportamiento dependiendo del tipo de campo

Valores que puede tomar dependiendo del tipo de campo:

• Para campos tipo 'C', cajas de texto, indica el tipo de contenido del campo.
  • 'X': Alfanumérico
  • 'F': Fecha
  • 0: Numérico sin decimales
  • 1,2..9: Numérico con 1,2..9 decimales
  • C: Clave, los dígitos tecleados permanecen ocultos
• Para campos tipo 'M', menú:
  • 'D', campo alineado a la derecha
• Para ampos tipo 'X' , cajas de texto extenso, indica el tipo de letra:
  • 'M', tipo mediano
  • Cualquier otro caso, letra normal
• Para campos tipo 'H', botones de herramienta.
  • 'Y', botón de ayuda
  • 'I', botón que lanza una neva instancia de la aplicación
• Para campos tipo 'X', 'check box':
  • 'B', contenido boleano estricto, es decir 'S' o 'N', si no se indica, admite el espacio

Signo

En campos numéricos indica si los datos llevan signo o no.

Posibles valores:

• 0: Sin signo.
• 1: Con signo.

Editado

Se utiliza en los campos numéricos para indicar si debe mostrarse los números con los puntos separadores de miles.

Posibles valores:

• 0: Sin editar
• 1: Editado

Pasar el control

Indica si al salir del campo se debe pasar el control al servidor para efectuar algún tipo de proceso con los datos y devolvernos una respuesta. En los campos tipo botón su comportamiento debe ser siempre “Pasar el control”.

Posibles valores:

• 0: No pasar el control.
• 1: Pasar el control.

Valor por defecto

Podemos indicar que valor tomará por defecto el campo. Para botones de ayuda, indicamos la página de ayuda que debe mostrarse.

Programación

Código de programa en lenguaje lcf, “indice documentacion lcf”, que se ejecutará al salir del control.

A un control, podemos asignarle una o mas funciones que definiremos en la parte baja de la pantalla de introducción de controles. Estas funciones se ejecutaran en el servidor secuencialmente por orden al salir del control. Podemos alterar ese comportamiento secuencial, introduciendo código de programación en este campo. Siempre que introduzcamos código nuevo o modifiquemos código existente deberemos compilarlo (botón compilar), el servidor lo compilará y nos informará del resultado, si no ha habido errores el programa ya estará activo y se ejecutará al salir del control o al pulsar el control si se trata de un botón.

Botones de ayuda a la programación

Copiar pantalla: Este botón nos permite copiar controles de una pantalla a otra.

Borrar pantalla: Con este botón podemos borrar pantallas enteras o solo algunos controles.

Literales: Este botón nos abre la pantalla de administración de literales donde podemos darlos de alta, borrarlos, modificarlos, etc.

Probar: Con la función probar visualizamos como queda la pantalla que estamos definiendo.

Tabulaciones: Con este botón accederemos a una ventana para poder poner las tabulaciones de los controles de forma automática.

Buscar Referencia: Este botón nos permite buscar las referencias de un texto dentro de la programación y las funciones.

Funciones

• Las funciones efectúan tareas especificas en el servidor de aplicaciones en el ámbito de la sesión iniciada por el usuario en la base de datos.

• Las funciones aquí indicadas se ejecutarán de forma secuencial según su número de orden a menos que hayamos introducido algún código de programación que altere este comportamiento .

• No debe haber huecos en el número de orden de las funciones.

• Para ver todas las funciones implementadas hasta el momento consulta el Indice de funciones