TextArea QML Type

Área de introducción de texto multilínea. Más...

• Lista de todos los miembros, incluidos los heredados

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 anexas

• 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 extiende TextEdit con una funcionalidad placeholder text, y añade decoración.

TextArea {
    placeholderText: qsTr("Enter description")
}

TextArea no es desplazable por sí misma. Especialmente en plataformas con restricciones de tamaño de pantalla, a menudo es preferible hacer desplazables páginas enteras de la aplicación. En una página desplazable de este tipo, un TextArea no desplazable puede comportarse mejor que los controles desplazables anidados. Tenga en cuenta, sin embargo, que en este caso la decoración de fondo del área de texto se desplaza junto con el resto del contenido desplazable.

Área de texto desplazable

Si desea que un TextArea sea desplazable, por ejemplo, cuando cubra toda una página de la aplicación, puede colocarla dentro de un ScrollView.

ScrollView {
    id: view
    anchors.fill: parent

    TextArea {
        text: "TextArea\n...\n...\n...\n...\n...\n...\n"
    }
}

Un TextArea que se coloca dentro de un ScrollView hace lo siguiente:

• Establece automáticamente el tamaño del contenido
• Garantiza que la decoración de fondo permanezca en su sitio
• Recorta el contenido

Foco de tabulación

Por defecto, al pulsar la tecla tabulador mientras el TextArea tiene active focus se introduce un carácter tabulador en el propio control. Para hacer que el tabulador pase el foco activo a otro elemento, utilice las propiedades adjuntas de KeyNavigation:

TextField {
    id: textField
}

TextArea {
    KeyNavigation.priority: KeyNavigation.BeforeItem
    KeyNavigation.tab: textField
}

Ver también TextField, Personalizar TextArea, y Controles de Entrada.

Documentación de Propiedades

background : Item

Esta propiedad contiene el elemento de fondo.

Véase también Personalizar TextArea.

bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la inserción inferior para el 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 la razón del último cambio de foco.

hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]

Esta propiedad determina si el área de texto acepta eventos hover. 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 área de texto está sobrevolada.

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 contiene la inserción izquierda para el 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 sugerencia 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 contiene la inserción derecha para el 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 contiene la inserción superior para el fondo.

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

Ver también Control Layout y bottomInset.

Documentación de la propiedad Attached

TextArea.flickable : TextArea

Esta propiedad adjunta un área de texto a Flickable.

Véase también ScrollBar, ScrollIndicator, y Scrollable TextArea.

Documentación sobre señales

pressAndHold(MouseEvent event)

Esta señal se emite cuando se produce una pulsación larga (el retardo depende del plugin de la plataforma). El parámetro event proporciona información sobre la pulsación, incluidas las coordenadas x e y de la pulsación, y qué botón se ha pulsado.

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 área de texto es pulsada por el usuario. El parámetro event proporciona información sobre la pulsación, incluidas las coordenadas x e y de la pulsación, y qué botón se ha pulsado.

Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).

Ver también released y pressAndHold.

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

Esta señal se emite cuando el área de texto es liberada por el usuario. El parámetro event proporciona información sobre la liberación, incluidas las coordenadas x e y de la pulsación, y qué botón se ha pulsado.

Esta señal se introdujo en QtQuick.Controls 2.1 (Qt 5.8).

Ver también pressed y pressAndHold.