Cuadro de texto

Propiedades de control de cuadro de texto en Studio Web Apps, incluido el texto de sugerencia, el texto predeterminado y la orientación sobre la actualización de los valores de las variables de la aplicación en runtime.

General

• Texto de sugerencia : el texto de ayuda que se mostrará en tiempo de ejecución.

• Texto predeterminado : el contenido predeterminado que se mostrará en tiempo de ejecución. Si esta propiedad está vinculada a una variable de la aplicación, los cambios en el valor predeterminado no se propagarán a la variable de la aplicación.

  • Para actualizar los valores de las variables de la aplicación, debes utilizar una regla Establecer valor .

• Información sobre herramientas: información sobre la herramienta que se mostrará en la zona de texto. Utilízalo para proporcionar información adicional sobre el control.

• Etiqueta : el texto de visualización del control.

• Separador de miles : añade un separador para los controles numéricos, lo que te permite mostrar números grandes en un formato más legible (por ejemplo, 1,000 en lugar de 1000).

• Prefijo : añade una opción de prefijo de moneda para los cuadros de texto numéricos, lo que te permite mostrar un prefijo estático (como $ o USD) a la izquierda del número. El prefijo acepta texto libre de hasta 3 caracteres.

• Hide characters - Available for the Text type only. Use it for passwords and other sensitive input. If selected, the control masks what app users type and shows an icon that reveals the text. Expressions and workflows still receive the real value.

• Obligatorio : si es verdadero, los usuarios de la aplicación deben proporcionar datos en el control. Para marcar el control como obligatorio en tiempo de ejecución, se añade un asterisco * después del texto de la etiqueta.

• Longitud mínima : el número mínimo de caracteres que los usuarios deben introducir.

• Longitud máxima : el número máximo de caracteres que los usuarios deben introducir.

• Patrón (Regex) : la expresión Regex utilizada para validar diferentes patrones de entrada. Utiliza barras diagonales / / para ajustar la expresión Regex, por ejemplo /{REGEX}/. Si se proporciona una expresión regular no válida, no se realizan validaciones en tiempo de ejecución. Consulta los siguientes ejemplos para ver las expresiones Regex válidas:

  Expresión regular	Lo que se valida
  /\d/	El texto debe contener dígitos
  /^\d*$/	El texto debe tener solo dígitos
  /\w/	El texto debe contener caracteres de palabras. Siempre coincide con los caracteres ASCII [A-Za-z0-9_]
  /[A-G]/	El texto debe contener caracteres de A a G
  /^C\d{7}$/	El texto debe comenzar por la letra C seguida de 7 caracteres numéricos.
  /^.{6,10}$/	El texto debe estar entre 6 y 10.
  /[A-H0-5_@?]/	El texto solo contiene caracteres de A a H, 0 a 5, _, @ y ?
  /^4[0-9]{12}(?:[0-9]{3})?$/	El texto es un número de tarjeta de crédito Visa.
  /^3[47][0-9]{13}$/	El texto es un número de tarjeta de crédito American Express.
  /^5[1-5][0-9]{14}|^(222[1-9]|22[3-9]\\d|2[3-6]\\d{2}|27[0-1]\\d|2720)[0-9]{12}$/	El texto es un número de tarjeta de crédito MasterCard.
  /^([+]?\d{1,2}[-\s]?|)\d{3}[-\s]?\d{3}[-\s]?\d{4}$/	El texto es un número de teléfono con el código de país opcional, caracteres especiales opcionales y espacios en blanco.
  /^(0[1-9]|[1-2][0-9]|3[0-1])\/(0[1-9]|1[0-2])\/(\d{4})$/	El texto es una fecha de nacimiento válida en el formato DD/MM/YYYY.

• Mensaje de error personalizado : el texto que se mostrará si la propiedad Requerido se establece en verdadero y el control se deja vacío.

• Oculto : si es verdadero, oculta el control en tiempo de ejecución.

• Deshabilitado : si es verdadero, deshabilita el control en tiempo de ejecución.

Eventos

• Valor cambiado : configura lo que sucede cuando se cambia el texto.

Estilo

• Alineación de control : de forma predeterminada, hereda la alineación principal. Se puede establecer una alineación diferente a la principal. Para volver a la alineación principal, anula la selección de las opciones anuladas.
  Nota:

  La alineación depende del diseño seleccionado para el elemento principal (Vertical u Horizontal).

• Colocación de la etiqueta : de forma predeterminada, la etiqueta se establece para que se muestre en la parte superior del control, en el lado izquierdo. Puedes colocarlo a la izquierda del control, en la misma línea. La propiedad Ancho de etiqueta configura el ancho que debe tener la etiqueta, y la propiedad Espacio entre establece la distancia entre la etiqueta y el control.
• Color de fondo : el color de fondo del control. Puedes establecer un color fijo utilizando el selector de color o definir un valor dinámico utilizando una expresión VB.
• Fuente : los atributos de fuente para la etiqueta y el texto de entrada, como la familia de fuentes, el tamaño, el color o el estilo (negrita, cursiva y subrayado) o la alineación del texto. De forma predeterminada, el control hereda la familia de fuentes del contenedor principal inmediato, que se indica con la palabra clave "heredada".
• Margen: el margen del control. De forma predeterminada, se establece un margen de 4px. Se combinan las propiedades de los márgenes superior/inferior e izquierdo/derecho . Estas propiedades pueden separarse utilizando el botón Enlace situado a la derecha de la sección Margen .
• Tamaño : la anchura y la altura del control. De forma predeterminada, el tamaño está establecido en auto. Para establecer valores mínimos o máximos, selecciona el icono de tres puntos (...). Si el tamaño del control es menor que las opciones, se muestra una barra de desplazamiento.

Propiedades VB

Propiedad VB	Tipo de datos	Descripción
AllowDomain	List(Of String)	Lista de dominios permitidos.
BlockDomain	List(Of String)	Lista de dominios bloqueados.
Type	Cadena	-
PatternRegex	Cadena	Recupera la expresión regular (regex) proporcionada en las propiedades generales del control. Se utiliza para validar la entrada del usuario.
Label	Cadena	La etiqueta del control Cuadro de texto , normalmente el texto que se muestra antes del control.
HintText	Cadena	Texto de marcador de posición que se muestra al usuario sobre el control Cuadro de texto .
Tooltip	Cadena	Texto de información que aparece cuando el usuario pasa el ratón por encima del control.
Value	Cadena	El valor seleccionado actualmente del control Cuadro de texto .
MinLength	Entero	El número mínimo de caracteres que los usuarios deben introducir.
MaxLength	Entero	El número máximo de caracteres que pueden introducir los usuarios.
Required	Booleano	Especifica si el valor del Cuadro de texto es obligatorio.
Hidden	Booleano	Si es verdadero, oculta el control en tiempo de ejecución.
Disabled	Booleano	Si es verdadero, deshabilita la interacción con el control en tiempo de ejecución.
IsValid	Booleano	Comprueba la validez del valor del cuadro de texto . Si es verdadero, indica que es válido.