El widget de área de texto permite al usuario del mashup introducir un texto de varias líneas en un mashup.

El tamaño del widget de área de texto varía en función de la versión de ThingWorx:

Cuando se migra a ThingWorx 9.3.2 o una versión posterior, los widgets de área de texto que se muestran como un único widget dentro de un contenedor rellenarán todo el espacio disponible en el contenedor. Este cambio puede afectar al esquema del mashup. Para actualizar el esquema, asegúrese de ajustar el esquema del mashup. Para obtener información, consulte las siguientes secciones.

Por defecto, el área de texto se muestra utilizando las cotas de ancho y altura por defecto. El ancho se define en un valor fijo. Sin embargo, la altura se define en Autosize para permitir que el widget crezca verticalmente. A medida que se escribe, el widget crece para mostrar caracteres adicionales cuando el texto supera el espacio disponible, hasta que se alcance el valor definido en la propiedad MaxNumberOfCharacters. Se pueden añadir widgets adicionales y controlar el esquema mediante las opciones de alineación y distribución del panel Esquema. En la siguiente figura se muestra el widget en un esquema de mashup:

El esquema se divide de la siguiente manera:

El ancho del widget se define en un valor fijo. Sin embargo, la altura se define en Autosize para permitir que el widget se expanda verticalmente cuando el número de caracteres sea mayor que el espacio disponible. Se pueden utilizar las propiedades Width y Height para ajustar el tamaño del widget. Se muestran puntos suspensivos.

Cuando se añade el widget a un mashup nuevo o existente, las cotas por defecto se definen según el tamaño de su contenedor. El widget crece automáticamente para rellenar el espacio disponible dentro del contenedor. Para ajustar las cotas del widget en relación con el esquema, se debe configurar el esquema del contenedor mediante el panel Layout. Cuando el widget se expande en el contenedor, las propiedades Width y Height no se enumeran en el panel Propiedades. Al añadir widgets adicionales al contenedor de área de texto, se restaura el tamaño anterior. En la siguiente figura se muestra el widget en un contenedor dinámico en la versión 9.3.2 o posterior de ThingWorx Platform.

El esquema se divide de la siguiente manera:

El uso de un contenedor independiente para mostrar el widget permite crear esquemas más dinámicos. En la siguiente imagen se muestra el formulario anterior cuando hay más espacio disponible para el mashup. Se debe tener en cuenta que el área de texto crece con su contenedor y los campos de texto conservan el mismo tamaño.

Se puede permitir a los usuarios cambiar el tamaño de un widget de área de texto en tiempo de ejecución activando la propiedad AllowResize. Cuando esta propiedad se define en true, se puede cambiar el tamaño del widget, lo que proporciona a los usuarios más control sobre el espacio de entrada.

Para definir cómo se puede cambiar el tamaño del widget, utilice la propiedad ResizeDirection. Se puede permitir el cambio de tamaño horizontal, vertical o en ambas direcciones. La configuración por defecto es Ambos, que permite a los usuarios ajustar la anchura y la altura del área de texto. De este modo, mejora la facilidad de uso, especialmente cuando los usuarios necesitan introducir o editar texto más largo.

Las propiedades del widget de área de texto se muestran a continuación.

Además de las propiedades de validación comunes, se pueden utilizar las propiedades MaxLength y MinLength para validar el número de caracteres dentro del widget de área de texto.

Se puede personalizar el mensaje de fallo por defecto con las propiedades MaxLengthFailureMessage y MinLengthFailureMessage. Los valores máximos y mínimos se muestran en los mensajes mediante el parámetro ${value}.

Para obtener más información sobre el uso de las propiedades de validación comunes, consulte Aplicación de validación a widgets.

En la siguiente tabla se enumeran las propiedades de validación que están disponibles en el panel Validación.