GrialApl, Transacción Visual
De GrialWIKI
Contenido |
Grial Apl, GrialCont
Descripción General
El Contenedor representa visualmente una transacción, estandarizando el flujo del programa en todos los módulos del sistema. Adicionalmente brinda el servicio de seguridad, conexión y acceso a los controles registrados.
El flujo de programa determinado por este control responde al siguiente esquema:
Codificación Estándar: Inicialización, Centrado y Finalización
Componentes Visuales Requeridos
Dentro de cada GrialCont debe colocarse un objeto "Frame" de VB con el nombre "[Container_Frm-Referencias.doc]", dicho frame contendrá todos los controles involucrados en la transacción. Al iniciarse una transacción, se hace visible el frame "Container_Frm" (y se dispara el evento ContainerFrmShow), permitiendo la operación del usuario. Al finalizar la transacción, se oculta dicho frame (y se dispara el evento ContainerFrmHide). Si al iniciar una transacción, durante el evento ButtonClick, se establece el estado de sólo visualización (NewState=VIEW_MODE), se mostrará el Container_Frm pero deshabilitado. En caso de tener más de un objeto GrialCont dentro de un mismo módulo, debe crearse un array de frames Container_Frm(0..n), uno dentro de cada uno de los objetos GrialCont.
Método Initialize
Se debe invocar el método GrialCont.Initialize en el evento UserDocument_Show (primer evento una vez mostrada la pantalla del módulo).
Formato:
Sub GrialCont.Initialize ( UserDocument_Name As String, Parent_LocationURL As String )
Ejemplo:
GrialCont1.Initialize UserDocument.Name, Parent.LocationUrl
El método Initialize:
- Establece los accesos de seguridad según el usuario
- Prepara la conexión para el acceso a datos
- Prepara la configuración de los controles registrados
Método Center
Se debe invocar este método en el evento UserDocument_Resize para centrar el objeto que contenga al resto de los objetos dentro de la pantalla.
Formato:
Sub GrialCont.Center ( xViewportWidth As Integer, GeneralContainer As Object )
Ejemplo:
GrialCont.Center ViewportWidth, General_GFF GrialCont.Center ViewportWidth, TabGeneral
En el parámetro [GeneralContainer As Object] se indica el objeto que contiene al resto de los objetos de la función, por ejemplo cuando la aplicación presenta inicialmente varios tabs con un contenedor distinto en cada uno de ellos, será el objeto "Tab" el que contenga toda la aplicación.
Método Finalize
Debe ser invocado en el evento UserDocument_Hide (último evento antes de cerrar el formulario). Realiza descargas de los objetos cargados. Su ausencia puede provocar fallas en la salida del módulo.
Formato:
Sub GrialCont.Finalize()
Ejemplo:
Sub UserDocument_Hide
GrialCont.Finalize
End Sub
El método Finalize desconecta los controles registrados para evitar errores de protección general (GPF) en el cierre del documento.
Flujo de Programas, de ButtonClick a BottomButtonClick
El flujo del programa estará determinado por los controles GrialApl incluidos en el módulo. Se presenta a continuación un ejemplo de construcción y codificación de una transacción modelo dentro de un contenedor (GrialApl).
La transacción modelo consiste de un Combo de selección colocado sobre la barra superior de un control GrialApl. Dentro de la zona de edición se colocan los controles necesarios para modificar el conjunto de datos representado por el combo.
