TextArea QML Type
Área de introducción de texto de varias líneas. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- background : Item
- bottomInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - focusReason : enumeration
- hoverEnabled : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - hovered : bool
(since QtQuick.Controls 2.1 (Qt 5.8)) - implicitBackgroundHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitBackgroundWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - leftInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - placeholderText : string
- placeholderTextColor : color
(since QtQuick.Controls 2.5 (Qt 5.12)) - rightInset : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - topInset : real
(since QtQuick.Controls 2.5 (Qt 5.12))
Propiedades adjuntas
- flickable : TextArea
Señales
- pressAndHold(MouseEvent event)
- pressed(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8)) - released(MouseEvent event)
(since QtQuick.Controls 2.1 (Qt 5.8))
Descripción detallada
TextArea es un editor de texto multilínea. TextArea hereda de TextEdit, incorpora la funcionalidad placeholder text y añade elementos decorativos.

TextArea {
placeholderText: qsTr("Enter description")
}TextArea no es desplazable por sí mismo. Especialmente en plataformas con restricciones de tamaño de pantalla, a menudo es preferible que todas las páginas de la aplicación sean desplazables. En una página desplazable de este tipo, un TextArea no desplazable puede comportarse mejor que los controles desplazables anidados. Ten en cuenta, sin embargo, que en tal caso, la decoración de fondo del TextArea se desplaza junto con el resto del contenido desplazable.
TextArea desplazable
Si quieres que un TextArea sea desplazable, por ejemplo, cuando ocupa toda una página de la aplicación, puedes colocarlo dentro de un ScrollView.

ScrollView {
id: view
anchors.fill: parent
TextArea {
text: "TextArea\n...\n...\n...\n...\n...\n...\n"
}
}Un TextArea situado dentro de un ScrollView realiza lo siguiente:
- Ajusta automáticamente el tamaño del contenido
- Garantiza que la decoración de fondo permanezca en su sitio
- Recorta el contenido
Foco de la tecla Tab
De forma predeterminada, al pulsar la tecla Tab mientras el TextArea tiene un active focus, se introduce un carácter de tabulación en el propio control. Para que la tecla Tab pase el foco activo a otro elemento, utiliza las propiedades adjuntas KeyNavigation:
TextField {
id: textField
}
TextArea {
KeyNavigation.priority: KeyNavigation.BeforeItem
KeyNavigation.tab: textField
}Véase también « TextField» , «Personalización de TextArea» y «Controles de entrada».
Documentación de la propiedad
background : Item
Esta propiedad contiene el elemento de fondo.
Nota: Si no se ha especificado un tamaño explícito para el elemento de fondo, este adopta automáticamente el tamaño del control. En la mayoría de los casos, no es necesario especificar el ancho ni la altura de un elemento de fondo.
Nota: La mayoría de los controles utilizan el tamaño implícito del elemento de fondo para calcular el tamaño implícito del propio control. Si sustituyes el elemento de fondo por uno personalizado, también deberías considerar la posibilidad de asignarle un tamaño implícito adecuado (a menos que se trate de un elemento como Image, que tiene su propio tamaño implícito).
Véase también Personalización deTextArea.
bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen inferior del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y topInset.
focusReason : enumeration
Esta propiedad contiene el motivo del último cambio de foco.
Nota: Esta propiedad no indica si el elemento tiene un « active focus », sino el motivo por el que el elemento ha ganado o perdido el foco.
| Constante | Descripción |
|---|---|
Qt.MouseFocusReason | Se ha producido una acción del ratón. |
Qt.TabFocusReason | Se ha pulsado la tecla Tab. |
Qt.BacktabFocusReason | Se ha producido un «Backtab». La entrada correspondiente puede incluir las teclas Mayús o Control; p. ej., Mayús+Tab. |
Qt.ActiveWindowFocusReason | El sistema de ventanas ha activado o desactivado esta ventana. |
Qt.PopupFocusReason | La aplicación ha abierto o cerrado una ventana emergente que ha capturado o liberado el foco del teclado. |
Qt.ShortcutFocusReason | El usuario ha escrito el atajo asociado a una etiqueta |
Qt.MenuBarFocusReason | La barra de menús ha obtenido el foco. |
Qt.OtherFocusReason | Otra razón, normalmente específica de la aplicación. Nota: Es preferible utilizar ` QtQuick.Controls::Control::focusReason ` en lugar de esta propiedad. |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad determina si el área de texto admite eventos de paso del cursor. El valor por defecto es « true ».
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también hovered.
hovered : bool [read-only, since QtQuick.Controls 2.1 (Qt 5.8)]
Esta propiedad indica si el cursor se encuentra sobre el área de texto.
Esta propiedad se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también hoverEnabled.
implicitBackgroundHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura implícita del fondo.
El valor es igual a ` background ? background.implicitHeight : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitBackgroundWidth.
implicitBackgroundWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el ancho implícito del fondo.
El valor es igual a ` background ? background.implicitWidth : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitBackgroundHeight.
leftInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen izquierdo del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y rightInset.
placeholderText : string
Esta propiedad contiene la breve descripción que se muestra en el área de texto antes de que el usuario introduzca un valor.
placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el color de placeholderText.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también placeholderText.
rightInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad establece el margen derecho del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y leftInset.
topInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad define el margen superior del fondo.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también Control Layout y bottomInset.
Documentación de la propiedad adjunta
TextArea.flickable : TextArea [attached]
Esta propiedad asocia un área de texto a un objeto ` Flickable`.
Véase también ScrollBar, ScrollIndicator y Scrollable TextArea.
Documentación de Signal
pressAndHold(MouseEvent event)
Esta señal se emite cuando se produce una pulsación prolongada (el retraso depende del complemento de la plataforma). El parámetro ` event ` proporciona información sobre la pulsación, incluidas las coordenadas x e y de la misma y qué botón se ha pulsado.
Nota: El controlador correspondiente es onPressAndHold.
Véase también pressed y released.
[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)
Esta señal se emite cuando el usuario pulsa sobre el área de texto. El parámetro ` event ` proporciona información sobre la pulsación, incluidas las coordenadas x e y de la misma y qué botón se ha pulsado.
Nota: El controlador correspondiente es onPressed.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también released y pressAndHold.
[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)
Esta señal se emite cuando el usuario suelta el área de texto. El parámetro ` event ` proporciona información sobre la suelta, incluidas las coordenadas x e y del punto de pulsación y qué botón se ha pulsado.
Nota: El controlador correspondiente es onReleased.
Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).
Véase también pressed y pressAndHold.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.