Un componente FormGroup se declara en un archivo EGL, que está descrito en Formato fuente
EGL.
Este componente es un componente generable, lo que
significa que debe estar en el nivel superior del archivo y debe tener el mismo nombre que el
archivo.
Un programa solamente puede utilizar formularios que estén asociados con un grupo de
formularios a los que hace referencia la declaración use del programa.
Este es un ejemplo de un componente FormGroup:
FormGroup myFormGroup
{
validationBypassKeys = [pf3],
helpKey = "pf1",
pfKeyEquate = yes,
screenFloatingArea
{
screenSize = [24,80],
topMargin = 0,
bottomMargin = 0,
leftMargin = 0,
rightMargin = 0
},
printFloatingArea
{
pageSize = [60,80],
topMargin = 3,
bottomMargin = 3,
leftMargin = 5,
rightMargin = 5
}
}
use myForm01;
use myForm02;
end
El diagrama de un componente FormGroup es el siguiente:
- FormGroup nombreComponenteGrupoFormularios ... end
- Identifica el componente como un grupo de formularios y especifica el nombre de
componente. Para conocer las reglas de denominación, consulte Convenios de
denominación.
- propiedadesGrupoFormularios
- Una serie de propiedades, cada una separada de la siguiente por una coma. Cada
propiedad se describe más adelante.
- componenteFormulario
- Un formulario de texto o impresión, tal como se describe en Componente de
formulario en formato fuente EGL.
- use nombreComponenteFormulario
- Una declaración use que proporciona acceso a un formulario que no está incorporado en
el grupo de formularios.
Las propiedades del grupo de formularios son las siguientes:
- alias
- Una serie incorporada a los nombres de la salida generada. Si no se especifica un alias, en su
lugar se utiliza el nombre de FormGroup-part .
- validationBypassKeys = [valorTeclaSalto]
- Identifica una o varias pulsaciones de teclas que provocan que el entorno de
ejecución EGL pase por alto validaciones de campos de entrada. Esta propiedad es de
utilidad para reservar una pulsación que finalice el programa rápidamente. Cada opción de
valorTeclaSalto es como se indica a continuación:
- pfn
- El nombre de una tecla F o PF, incluido un número entre 1 y 24.
Nota: Las teclas de función de un teclado de PC son con frecuencia teclas
F, como por ejemplo F1, pero EGL utiliza la terminología
IBM
PF a fin de que (por ejemplo) F1 se denomine PF1.
Si desea especificar más de un valor de tecla, delimite el conjunto de valores
con corchetes y separe cada uno de los valores del siguiente con una coma, como en el ejemplo
siguiente:
validationBypassKeys = [pf3, pf4]
- helpKey = "valorTeclaAyuda"
- Identifica una pulsación de tecla del usuario que provoca que el entorno de ejecución
EGL presente un formulario de ayuda al usuario. La opción
valorTeclaAyuda es como se indica a continuación:
- pfn
- El nombre de una tecla f o pf, incluido un número entre 1 y 24.
Nota: Las teclas de función de
un teclado de PC suelen ser teclas f tales como f1, pero EGL utiliza la
terminología de IBM
pf de forma que, por ejemplo, f1 se denomina pf1.
- pfKeyEquate = yes, pfKeyEquate = no
- Especifica si la pulsación que se registra cuando el usuario pulsa una tecla de
función con un número alto (de PF13 a PF24) es la misma que la pulsación registrada
cuando el usuario pulsa una tecla de función inferior a 12.
Encontrará los detalles en pfKeyEquate.
- screenFloatingArea { propiedades }
- Define el área flotante utilizada para la salida a una pantalla. Para obtener una
visión general de las áreas flotantes, consulte Componente de formulario. Para
conocer detalles sobre las propiedades, consulte la siguiente sección.
- printFloatingArea { propiedades }
- Define el área flotante utilizada para la salida imprimible. Para obtener una visión
general de las áreas flotantes, consulte Componente de formulario. Para conocer
los detalles de propiedades, consulte Propiedades de un área flotante de impresión.