icc.ui.grid

Representa un control que muestra al usuario datos en forma de tabla.

Metodos

create ();

Crea los objetos necesarios en el navegador.Este metódo es ejecutado automaticamente por el sistema al cargar un formulario realizado por el diseñador.Si está creando mediante código un control para incluir al formulario en tiempo de ejecución es necesario llamar a este metodo.


object getWnd ();

Retorna el objeto html que contiene el control.


setEnabled ( boolean  enabled );

Habilita o habilita este control. En ciertos controles como textinput aplican los colores de fondo y texto correspondientes al estado disabled y el control no muestra su contenido al usuario.


object getItemAtIndex ( integer  index );
indexPosición del item en la grilla con base 0.

Devuelve el item ubicado en una determinada posición de la grilla.


integer getIndex ();

Devuelve la posición del item seleccionado o -1 si no lo hay.


setIndex ( integer  index );
indexPosición del item en la grilla con base 0.

Selecciona el item ubicado en la posición indicada o borra el item seleccionado si la posición no es válida.


array getItems ();

Devuelve un array con la colección de items que contiene la grilla.


updateItem ( object  item );
itemReferencia del objeto a actualizar.

Refresca la información mostrada por la grilla del item indicado


addItem ( object  item );
itemNuevo item o array de items a agregar a la grilla.
Miembros de la estructura
Tipo Nombre Descripcion
variant id Si se proporciona es el identificador unico del item en la grilla

Agrega un item a la grilla

Ejemplo
					
grid1.addItem([
    {id:'AR',name:'Argentina',code:'54'},
    {id:'AR',name:'Argentina',code:'598'},
    
]);

					

clearAll ();

Elimina todos los items de la grilla.


rmvItemAtIndex ( integer  index );
indexPosicion del item a eliminar con base 0.

Elimina el item indicado por el indíce.


rmvItem ( variant  itemid );

Elimina de la grilla el item proporcionado

Ejemplo
Remover el item seleccionado
					
var citem = grid1.getItem();
if(citem)
    grid1.rmvItem(citem);

					

setItem ( variant  item );
itemSelecciona el item indicado.
Opciones
Nombre Descripcion
string Identificador único del item.
integer Indice del item a seleccionar.
object Referencia del objeto a seleccionar ya existente en la grilla.
Ejemplo
					
var argentina = {id:'AR',name:'Argentina',code:'54'};
var uruguay = {id:'AR',name:'Uruguay',code:'598'};

grid1.addItem([argentina,uruguay]);
grid.setItem(0); // Selecciona Argentina
grid.setItem('UY'); // Selecciona uruguay
grid.setItem(argentina);


					

object getItem ();

Devuelve el item seleccionado en la grilla.

Eventos

onChange (function( object  item ) { ... } )
itemItem que ha sido seleccionado.

Indica un cambio en la fila seleccionada de la grilla por parte del usuario.

Ejemplo
					
grid1.onChange(function(item){
    txName.setText(item.name);  // Seteamos el contenido de la caja de texto con
                                // un miembro del item seleccionado.
});

					

onBeforeChange (function( object  newitem , object  olditem ) { ... } )
newitemNuevo item a ser seleccionado.
olditemItem actual seleccionado en la grilla.

Evento disparado antes de que se seleccione un nuevo item en la grilla.Retornando false en este evento impide que la grilla cambie efectivamente de fila.


onRowDblClick (function( object  item ) { ... } )
itemItem correspondiente a la fila.

Cuando el usuario hace doble click sobre una fila de la grilla se dispara este evento.

Propiedades

integer borderWidth

Ancho en pixels del borde del control


string borderColor

Color de borde del control. El color es expresado en formato web #RRGGBB RR(rojo) GG(verde) BB(azul) ej. #FF0000 para el color rojo o en un nombre de color valido ej , green,red,yellow.


string datasource

Nombre del origen de datos desde donde el control obtiene los datos a mostrar


boolean haveHeader

Indica si la grilla muestra la barra de cabezales de columnas. Default = true


object columns

Miembros de la estructura
Tipo Nombre Descripcion
string caption Título de la columna.
integer width Ancho de la columna en pixels.
string field Campo del item a mostrar en esta columna.