icc.ui.textinput

Representa un control de cuadro de texto donde el usuario escribe datos.

Metodos

setText ( string  text );

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


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.


setPassword ( boolean  passwd );
passwdtrue Pone el control en modo password, false pone el control en modo normal.

Setea el modo password del control mostrando * en lugar de los datos ingresados.


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.


boolean isValid ();

Retorna un boolean indicando si el valor en el control es válido acorde a sus propiedades. Por ejemplo si está formateado para mostrar datos de tipo date retorna true si la fecha ingresada es válida. También considera el estado de requerido devolviendo true si hay datos ingresados.


boolean getRequired ();

Devuelve el estado del flag de datos requeridos


boolean getReadOnly ();

Devuelve el estado de solo lectura del control.


string getText ();

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

Eventos

onChange (function( string  text , boolean  valid ) { ... } )

onKeyPress (function( string  text , character  key ) { ... } )
textEl texto actual mostrado en el control.
keyEl carácter correspondiente a la tecla presionada.

Evento disparado cuando el usuario presiona una tecla en el control. Retornando false en este evento se impide que el carácter ingresado se muestre en el control.


onEnterKey (function( string  text , boolean  valid ) { ... } )
textEl texto actual del control.
validtrue o false si los datos ingresados son válidos.

Evento especial para capturar cuando el usuario presiona la tecla enter.


onBlur (function( ) { ... } )

Evento disparado cuando el control pierde el foco del teclado.

Propiedades

string text

Texto editable del control


string datasource

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


string field

Nombre del campo perteneciente al origen de datos de donde se obtienen y guardan los datos


integer maxLength

Limita el largo del texto de entrada.Esta propiedad es seteada automáticamente cuando el control es asignado al campo de un origen de datos.


string tooltip

Texto del tooltip.


integer tabIndex

Orden del foco del teclado al presionar la tecla TAB


boolean enabled

Estado habilitado o deshabilitado.


boolean visible

Controla la visibilidad del control.


boolean readOnly

Estado de solo lectura


boolean multiLine

Con un valor true el control muestra y/o edita el texto en multiples lineas


boolean required

Estado requerido si o no. Se deben ingresar datos en este control para poder grabar. Este valor es seteado automáticamente cuando el control es asignado al campo de un origen de datos


string format

Formato de los datos de entrada

Opciones
Nombre Descripcion
integer Entrada de numeros enteros positivos o negativos
numeric Numeros con coma fija segun el numero de decimales positivos o negativos.
currency Numeros con coma fija segun el número de decimales con separador de miles.
date Entrada en formato fecha según la configuracion regional de la aplicación.
datetime Entrada en formato fecha hora acorde a la configuración regional de la aplicación.
time Formato de entrada de hora y minutos HH:MM
password Entrada de texto con los caracteres ocultos para claves

decimals

Cantida de decimales en los formatos numeric y currency


mask

Máscara de entrada conformada por caracteres que controlan que caracteres son aceptados en una determinada posicion y los que son usados para relleno.

Opciones
Nombre Descripcion
0 Solo se permite ingresar un número 0 - 9
L Solo se permite ingresar letras a - z A - Z
A Letras y números a-z A-Z 0-9
& Permite cualquier caracter en esa posición
otros El cáracter ingresado es colocado automáticamente en esa posicion
Ejemplo
					
0.000.000-0  Documento de identidad uruguaya.

					

string style

Nombre de un estilo predefinido que setea una o mas propiedades.


string foreColor

Color del texto 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 backColor

Color de fondo 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.


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 align

Alineación del texto del control.

Opciones
Nombre Descripcion
left Alinea el texto a la izquierda
right Alinea el texto a la derecha
center Centra el texto en el control.(Solo aplicable a label y textinput)
justify Justifica el texto a lo ancho del control. (Solo aplicable a label y textinput)

object font

Tipografia del texto utilizado.

Miembros de la estructura
Tipo Nombre Descripcion
string name Nombre de la/s tipografía/s utilizada/s ej. 'Arial', 'Verdana'
integer size Tamaño de la letra en pixels
integer weight Peso o grosor de fuente ej 'normal','bold'
string italic Indica si la fuente es italica ej true, false