Controles Registrados

De GrialWIKI

(Diferencias entre revisiones)
Línea 1: Línea 1:
{{Hierarchy header}}
{{Hierarchy header}}
-
Los controles registrados son configuraciones de [[Combos]], [[Grillas]] y [[Trees]] Grial registrados en el servidor mediante el [[ControlWizard]]. La configuración registrada le indica al control qué query realizar para cargar los datos y cómo mostrarlos.
 
-
Se asigna una configuración registrada a un control en un módulo de acuerdo a su nombre o por la propiedad [[ConfigurationName]]. La propiedad ConfigurationName permite tener dos controles (con nombres diferentes) pero que utilicen la misma configuración registrada.
+
<!--
 +
Keys ocultas para llear a esta pagina poniendo "SCB" por ejemplo
 +
scb ste sgr GGP GCT GFF GPR
 +
-->
-
El sufijo del nombre del control registrado determina su tipo:
+
Los controles registrados son configuraciones de [[Combos]], [[Grillas]] y [[Trees]] del Framework Grial, almacenadas en el servidor mediante el módulo "[[Control Wizard]]".
-
*'''       _scb: Standard Combo/Grid'''
+
 
-
*'''       _ste: Standard Tree Controller'''
+
La configuración registrada determina qué query realizará el control para cargar sus datos y qué columnas y en que orden se mostrarán.
-
*'''       _sgr: Standard Grid Controller'''
+
 
 +
 
 +
Al tener controles registrados, y poder reutilizar los controles en el desarrollo de nuevos módulos, se acortan sensiblemente los tiempos de desarrollo, ya que no es necesario volver a codificar el mecanismo para la selección de datos relacionados, ni los mecanismos de búsqueda, ni cómo mostrar los datos, ni cómo mostrar detalles asociados. El control registrado soluciona todos estos requerimientos en forma homogénea en todos los módulos que lo utilizan.
 +
 
 +
Este reuso de código, también facilita la operación para el usuario, ya que para seleccionar un compromiso por ejemplo, siempre lo puede hacer de la misma forma en diferentes módulos.
 +
 
 +
 
 +
Cuando se incluye un control Grial en un módulo, debe cambiarse su nombre, para que coincida con la configuración registrada que se desea aplicar  (propiedad '''Name''').
 +
 
 +
Si se necesita tener dos controles (con nombres diferentes) pero que utilicen la misma configuración registrada, es posible colocar el dato de la configuración en la propiedad [[ConfigurationName]]. Si la propiedad [[ConfigurationName]] tiene valor, se usa ese dato y se ignora la propiedad "Name".
 +
 
 +
 
 +
Dependiendo del tipo de Control Grial que se incluye,
 +
debe indicarse el sufijo correspondiente para que sea reconocido como un control registrado.
 +
 
 +
{| style="border:2px solid gray; padding:20px; width:600px; height:200px"
 +
|+ Sufijos para Controles Registrados
 +
|-
 +
| Sufijo || Código || Significado || Uso |
 +
|- style="border:2px solid gray"
 +
| '''_scb''' ||  SCB || Standard Combo/Grid       || para un [[GrialCombo]], ya sea en modo Combo o modo Grid.
 +
|-
 +
|'''_ste''' ||  STE || Standard Tree Controller || para un GrialTreeController
 +
|-
 +
|'''_sgr''' ||  SGR || Standard Grid Controller || para un GrialGridController (obsoleto)
 +
|}
 +
 
 +
 
 +
 
 +
Todos los controles de un documento que posean estos sufijos serán buscados en el repositorio de Controles Registrados para asignarles la configuración correspondiente. Este proceso se realiza automáticamente durante el GrialCont.Initialize
 +
 
 +
 
 +
Los controles registrados se cargan con datos mediante el método '''GrialCont.LoadData'''. Este método toma una lista de controles registrados (u objetos '''GrialQuery''') y los carga en una sola transacción, según el query de cada control. De este modo se realiza un único acceso al servidor.
 +
 
 +
 
 +
Formato:
 +
'''Sub GrialCont.LoadData ( ParamArray RegistredControls() As Variant )'''
 +
 
 +
 
 +
Ejemplo:
 +
    GrialCont.LoadData PreEjec20_Scb, PreEjec21_scb
 +
 
 +
 
 +
Para otros tipos de controles se recomienda usar los siguiente ''''sufijos'''':       
-
Todos los controles de un documento que posean estos sufijos serán buscados en el repositorio de Controles Registrados para asignarles la configuración correspondiente.
 
-
Para otros tipos de controles se deben usar los siguiente ''''sufijos'''':       
 
-
*'''        _grq o Grq: Grial Query'''
 
*'''        _gpr: Grial Print'''
*'''        _gpr: Grial Print'''
*'''        _ggp: Grial Grid Print'''
*'''        _ggp: Grial Grid Print'''
*'''        _gct: Grial Cross Tree'''
*'''        _gct: Grial Cross Tree'''
 +
*'''        _gff: Grial Function Frame'''
 +
*'''        _tvw: TreeView'''
*'''        _tvw: TreeView'''
*'''        _grx o _grd: Grilla (GridEX de Janus)'''
*'''        _grx o _grd: Grilla (GridEX de Janus)'''
 +
 +
*'''        _grq o Grq: Grial Query'''
*'''        Rst: Recordset'''
*'''        Rst: Recordset'''
 +
*'''        Txt: Text Box'''
*'''        Txt: Text Box'''
*'''        Lb : Label'''
*'''        Lb : Label'''
Línea 25: Línea 72:
*'''        Chk: CheckBox'''
*'''        Chk: CheckBox'''
          
          
-
Los controles registrados se cargan con datos mediante el método '''GrialCont.LoadData'''. Este método acepta una lista de controles registrados (u objetos '''GrialQuery''') y los carga según el query de la configuración realizando un único acceso al servidor.
 
-
Formato:
 
-
'''Sub GrialCont.LoadData ( ParamArray RegistredControls() As Variant )'''
 
-
 
-
Ejemplo:
 
-
    GrialCont.LoadData PreEjec20_Scb, PreEjec21_scb
 
[[Category: Manual de Programación]]
[[Category: Manual de Programación]]
 +
{{Hierarchy footer}}
{{Hierarchy footer}}

Revisión de 16:24 5 abr 2013

Introducción al Framework Grial

Índice


Los controles registrados son configuraciones de Combos, Grillas y Trees del Framework Grial, almacenadas en el servidor mediante el módulo "Control Wizard".

La configuración registrada determina qué query realizará el control para cargar sus datos y qué columnas y en que orden se mostrarán.


Al tener controles registrados, y poder reutilizar los controles en el desarrollo de nuevos módulos, se acortan sensiblemente los tiempos de desarrollo, ya que no es necesario volver a codificar el mecanismo para la selección de datos relacionados, ni los mecanismos de búsqueda, ni cómo mostrar los datos, ni cómo mostrar detalles asociados. El control registrado soluciona todos estos requerimientos en forma homogénea en todos los módulos que lo utilizan.

Este reuso de código, también facilita la operación para el usuario, ya que para seleccionar un compromiso por ejemplo, siempre lo puede hacer de la misma forma en diferentes módulos.


Cuando se incluye un control Grial en un módulo, debe cambiarse su nombre, para que coincida con la configuración registrada que se desea aplicar (propiedad Name).

Si se necesita tener dos controles (con nombres diferentes) pero que utilicen la misma configuración registrada, es posible colocar el dato de la configuración en la propiedad ConfigurationName. Si la propiedad ConfigurationName tiene valor, se usa ese dato y se ignora la propiedad "Name".


Dependiendo del tipo de Control Grial que se incluye, debe indicarse el sufijo correspondiente para que sea reconocido como un control registrado.

Sufijos para Controles Registrados
Sufijo Código Significado
_scb SCB Standard Combo/Grid para un GrialCombo, ya sea en modo Combo o modo Grid.
_ste STE Standard Tree Controller para un GrialTreeController
_sgr SGR Standard Grid Controller para un GrialGridController (obsoleto)


Todos los controles de un documento que posean estos sufijos serán buscados en el repositorio de Controles Registrados para asignarles la configuración correspondiente. Este proceso se realiza automáticamente durante el GrialCont.Initialize


Los controles registrados se cargan con datos mediante el método GrialCont.LoadData. Este método toma una lista de controles registrados (u objetos GrialQuery) y los carga en una sola transacción, según el query de cada control. De este modo se realiza un único acceso al servidor.


Formato:

Sub GrialCont.LoadData ( ParamArray RegistredControls() As Variant )


Ejemplo:

   GrialCont.LoadData PreEjec20_Scb, PreEjec21_scb


Para otros tipos de controles se recomienda usar los siguiente 'sufijos':


  • _gpr: Grial Print
  • _ggp: Grial Grid Print
  • _gct: Grial Cross Tree
  • _gff: Grial Function Frame
  • _tvw: TreeView
  • _grx o _grd: Grilla (GridEX de Janus)
  • _grq o Grq: Grial Query
  • Rst: Recordset
  • Txt: Text Box
  • Lb : Label
  • Cmd: Command Button
  • Opt: Option Button
  • Chk: CheckBox



GrialCrossTree <<< >>> Normas de Programación

Obtenido de "http://wikidev.sanjuan.gob.ar/index.php/Controles_Registrados"
Herramientas personales