Componentes JSON&JS (Parte 6 de 12)

JSON Control Object

Cada control posee un archivo JSON denominado "control.json" conteniendo su definición. A continuación describiremos en detalle cada uno de los miembros de este objeto según sus secciones:

name

El nombre es obligatorio; Determina el nombre del control como componente externo y también el nombre de la clase JavaScript en la forma "ctrl_≤nombre≥", por ejemplo para...

 "name": “net_omnis_control1"

...la clase JavaScript sería ctrl_net_omnis_control1. 

 flags

El grupo "flags" es obligatorio. Permite configurar ciertas características del control. Cada miembro de éste grupo es opcional y si son omitidos su valor por defecto será "false", siendo sus miembros válidos los siguientes:

• beforeafterevents y beforeevents  (excluyentes mutuamente) 

Indica si el control admite el uso de "evAfter" y "evBefore", o sólamente "evBefore", respectivamente. Si ambos son omitidos, indicará que el control no soporta ninguno de éstos eventos (véase "events")

•  backcolorandalpha

Indica si el control admite las propiedades "backcolor" y "backalfa". 

•  noenabled

Indica si el control puede no tener habilitada la propiedad. 

•  transparentbackground

Indica que el control posee fondo transparente y que no hace uso de las propiedades "backcolor" y "backalfa". No puede ser usado con "backcolorandalpha" a "true". 

•  hasdefaultborder

Indica si la propiedad "$effect" del control, puede contener el valor "kJSborderDefault". 

•  hasdisplayformat

Indica si el control contiene propiedades en formato de fecha y número. 

•  hasdragevents

Indica si el control permite eventos de arrastrar y soltar (véase "events"). 

Ejemplo:

"flags": {

    "beforeafterevents": true, 

    "backcolorandalpha": true, 

    "noenabled": true, 

    "hasdefaultborder": false, 

    "hasdisplayformat": true, 

    "hasdragevents": true

}, 

 standardproperties

El grupo "standardproperties" es opcional. Contiene las propiedades estándar soportadas por el control; La inclusión de cualquiera de sus miembros significa que el control admitirá la propiedad. Se trata de propiedades básicas aplicables a todos los controles.

Miembros válidos del grupo son: "“dataname", “effect", “bordercolor", “borderradius", “linestyle", “font", "textcolor", "align", “fontstyle", “fontsize", “horzscroll", “vertscroll", "autoscroll" y “dragmode”.

Ejemplo:

"standardproperties": [

     "dataname", 

     "effect", 

     "bordercolor", 

     "borderradius", 

     "linestyle",

],