icc.ui.combobox

Representa un control que permite al usuario seleccionar un único elemento de una lista desplegable.

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.


updateItem ( object  item );
itemObjeto a actualizar.

Actualiza los datos mostrados (texto) de un ítem existente.


rmvItemAtIndex ( integer  index );
indexPosición de ítem a ser eliminado.

Elimina el ítem de la lista en la posición indicada.


rmvItem ( variant  item );
itemPuede ser el objeto previamente agregado al combobox, un número indicando la posición, o un string si el ítem se agregó de esa forma.

Elimina un ítem de la lista indicado por el parámetro ítem.

Ejemplo
					
// Remueve el item cuyo texto sea igual a "Argentina"
combobox1.rmvItem("Argentina");
// Remueve el item ubicado en la posicion 1 de la lista
combobox1.rmvItem(1); 
// Remueve el item comparando internamente objetos.
combobox1.rmvItem(uruguay); 


					

clearAll ();

Elimina todos los items de la lista dejando el combobox vacío.


addItem ( variant  item );
itemÍtem o items a agregar a la lista pudiendo ser cada uno de ellos un objeto, string o número. Si se trata de un objeto se utilizará el contenido del miembro 'text' para mostrar en la lista.
Miembros del objeto.
Tipo Nombre Descripcion
string id
string text Texto a mostrar en la entrada de la lista.

Agrega uno o varios items ( array de items) a la lista del combobox.

Ejemplo
					
combobox1.addItem("Argentina");      
combobox1.addItem({text:"Uruguay",countryId:598}); // Uruguay se mostrará en la lista.
combobox1.addItem(335);
combobox2.AddItem(["Argentina","Brasil","Uruguay","Paraguay","Chile"]); // Array con múltiples items

					

setReadOnly ( boolean  readonly );

Dependiendo del valor del parametro setea el control de manera que sea editable su contenido o no. En el modo read only se aplican los colores de texto y de fondo elejidos a tal efecto para indicar al usuario que no puede realizar cambios.


boolean getReadOnly ();

Devuelve el estado de solo lectura del 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.


setText ( string  text );

Setea el texto de entrada del control, el cual es mostrado al usuario.


string getText ();

Devuelve el texto ingresado por el usuario , undefined si el control está vacío.


getItemAtIndex ( integer  index );
indexPosición en la lista del ítem a obtener.

Devuelve el item indicado por parámetro entero index. El item devuelto será el mismo agregado por el método addItem (objeto,string o numero)


setItem ( variant  item );
itemstring,número u objeto.
Comportamiento según el tipo del parámetro
Nombre Descripcion
string Se posiciona en el ítem correspondiente al texto utilizado como argumento.
número Se posiciona en ítem ubicado en esa posición.
objeto Se ubica en la posición ocupada por el objeto empleado.

Posiciona el combobox en el ítem o posición indicado por el parámetro 'item'


variant getItem ();

Devuelve el ítem actualmente seleccionado en el combobox. En caso de que no haya un ítem seleccionado devuelve undefined.


displayMessage ( variant  message );
messageEl mensaje a mostrar pudiendo ser este un simple string con el texto o un objeto de error obtenido de un datasource.

Muestra un icono en el borde derecho del control y desplega un mensaje cuando el usuario coloca el mouse sobre el. Este icono y mensaje desaparecen automaticamente cuando el usuario modifica el contenido del control.


isValid ();

Devuelve un boolean indicando si el valor del control es válido de acuerdo a sus propiedades. En caso de que el combobox tenga la propiedad "required", devolverá true si hay un ítem seleccionado.


setRequired ( boolean  require );

Cuando el valor del parametro es true el control muestra un indicador de que es necesario escribir datos en este control para poder guardarlos.


boolean getRequired ();

Devuelve el estado del flag de datos requeridos

Eventos

onChange (function( integer  index , string  text , variant  item ) { ... } )
indexNúmero del item seleccionado o -1 en caso de que la selección sea nula.
textContenido de la caja de texto del combobox, generalmente corresponde al texto visible del ítem seleccionado.
itemObjeto, número o string correspondiente al item seleccionado.

Evento producido cuando el usuario selecciona un ítem en el combobox.

Ejemplo
					
// Se asume que el combobox tiene registros de un datasource.
// Al seleccionar un ítem del combobox mostramos información adicional
// del mismo.
combobox1.onChange(function(index,text,item){
    if ( item){
        txNombre.setText(item.nombre);
        txCuenta.setText(item.nrocuenta);
        btnDetalles.setEnabled(true);
    }else{
        txNombre.setText("");
        txCuenta.setText("");
        btnDetalles.setEnabled(false);
    }
});