¿Uso de cuadros de texto?

El cuadro de texto es el control básico que permite a los usuarios agregar o modificar datos almacenados en un campo no memo de una tabla.

Para ver ejemplo del uso de cuadros de texto, ejecute SOLUTION.APP en el directorio SAMPLES\SOLUTION y, a continuación, seleccione Cuadro de texto en la sección Controles.

    Para manipular mediante programación el texto que se muestra en el cuadro de texto

·      Establezca o haga referencia a la propiedad Value.

Si establece la propiedad ControlSource para el cuadro de texto, el valor que aparece en el cuadro de texto se almacenará en la propiedad Value del cuadro de texto y en el campo de la tabla o del cursor que se especifique en la propiedad ControlSource.

Validación de datos en un cuadro de texto

Para comprobar o verificar el valor del cuadro de texto, incluya código en el método asociado al evento Valid. Si el valor no es válido, se devolverá falso (.F.). o 0. Si Valid devuelve falso (.F.) se muestra un mensaje de “La entrada no es válida”. Si quiere mostrar su propio mensaje, incluya el comando WAIT WINDOW o la función MESSAGEBOX( ) en el código Valid y devuelva 0.

Por ejemplo, si tiene un cuadro de texto que permite a un usuario escribir la fecha de una cita, puede asegurarse de que la fecha no ha pasado incluyendo el código siguiente en el evento Valid del cuadro de texto:

IF CTOD(THIS.Value) < DATE(           )

          = MESSAGEBOX("Debe escribir una fecha futura",1)

          RETURN 0

ENDIF

Selección de texto cuando el cuadro de texto recibe el enfoque

Para seleccionar todo el texto cuando el usuario escribe en el cuadro de texto usando el teclado, establezca la propiedad SelectOnEntry a verdadero (.T.).

Formato de texto en un cuadro de texto

Puede utilizar la propiedad InputMask para determinar los valores que pueden escribirse en el cuadro de texto y la propiedad Format para determinar cómo se muestran los valores en el cuadro de texto.

Uso de la propiedad InputMask

La propiedad InputMask determina las características de cada carácter escrito en el cuadro de texto. Por ejemplo, puede establecer la propiedad InputMask en 999.999,99 para limitar la entrada del usuario a valores numéricos inferiores a 1.000.000 con dos posiciones decimales. La coma y el punto se mostrarán en el cuadro de texto antes de que el usuario pueda introducir algún valor. Si el usuario presiona una tecla de carácter, el carácter no aparecerá en el cuadro de texto.

Si tiene un campo lógico y desea que un usuario puede introducir “Y” o “N”, pero no “T” o “F”, establezca la propiedad InputMask como “Y”.

Aceptación de contraseñas de usuario en un cuadro de texto

Con frecuencia, en una aplicación es conveniente obtener información segura de un usuario, como una contraseña. Puede utilizar un cuadro de texto para obtener esta información sin que aparezca en la pantalla.

    Para aceptar la entrada del usuario sin mostrar el valor real

·      Establezca la propiedad PasswordChar del cuadro de texto como * o algún otro carácter genérico.

Si establece la propiedad PasswordChar como algo que no sea una cadena vacía, las propiedades Value y Text del cuadro de texto contendrán el valor real que el usuario escribió en el cuadro de texto, pero éste mostrará un carácter genérico para cada tecla que haya presionado el usuario.

Escribir fechas en un cuadro de texto

Los cuadros de texto tienen varias propiedades que se puede establecer para facilitar a los usuarios escribir valores de fecha.

Propiedad             Descripción    

Century              Especifica si los dos primeros dígitos del año se muestran o no.

DateFormat        Formato de la fecha en el cuadro de texto entre quince formatos predefinidos,  como Americano, Alemán, Japonés.

StrictDateEntry             Si se establece StrictDateEntry a 0 - Libre, permite al usuario escribir fechas en formatos más flexibles que el predeterminado 99/99/99.

Propiedades comunes de los cuadros de texto

Las siguientes propiedades de cuadros de texto suelen establecerse en tiempo de diseño.

Propiedad             Descripción

Alignment             Especifica si el contenido del cuadro de texto está alineado a la izquierda, a la derecha, centrado o alineado automáticamente. La alineación automática depende del tipo de datos. Los números, por ejemplo, se alinean a la derecha y los caracteres se alinean a la izquierda.

ControlSource             El campo de tabla o variable cuyo valor se muestra en el cuadro de texto.

InputMask             Especifica la regla de entrada de datos que cada carácter escrito debe seguir. Para obtener información específica sobre InputMask, vea la Ayuda.

SelectOnEntry             Especifica si el contenido del cuadro de texto se selecciona automáticamente cuando el cuadro de texto recibe el enfoque.

TabStop             Especifica si el usuario puede llegar al control tabulando. Si TabStop está establecido a .F., un usuario aún puede seleccionar el cuadro de texto haciendo clic en él.