TextArea QML Type

Zone de saisie de texte sur plusieurs lignes. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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))

Propriétés rattachées

• flickable : TextArea

Signaux

• 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))

Description détaillée

TextArea est un éditeur de texte multiligne. TextArea étend TextEdit avec une fonctionnalité placeholder text, et ajoute des décorations.

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

TextArea n'est pas défilable en lui-même. Sur les plates-formes à taille d'écran limitée, il est souvent préférable de faire défiler des pages entières de l'application. Sur une telle page défilante, un TextArea non défilable peut se comporter mieux que des contrôles défilants imbriqués. Notez toutefois que, dans un tel scénario, la décoration d'arrière-plan de la zone de texte défile en même temps que le reste du contenu défilable.

TextArea défilant

Si vous souhaitez rendre un TextArea défilable, par exemple lorsqu'il couvre toute une page d'application, vous pouvez le placer à l'intérieur d'une page ScrollView.

ScrollView {
    id: view
    anchors.fill: parent

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

Un TextArea placé à l'intérieur d'un ScrollView effectue les opérations suivantes :

• définit automatiquement la taille du contenu
• Il veille à ce que la décoration d'arrière-plan reste en place.
• Il découpe le contenu.

Focus sur la tabulation

Par défaut, le fait d'appuyer sur la touche de tabulation lorsque TextArea a active focus entraîne la saisie d'un caractère de tabulation dans le contrôle lui-même. Pour que la tabulation transfère le focus actif à un autre élément, utilisez les propriétés KeyNavigation ci-jointes :

TextField {
    id: textField
}

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

Voir également TextField, Personnaliser TextArea et Contrôles de saisie.

Documentation sur les propriétés

background : Item

Cette propriété contient l'élément d'arrière-plan.

Voir aussi Personnaliser TextArea.

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

Cette propriété définit l'encart inférieur de l'arrière-plan.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi Control Layout et topInset.

focusReason : enumeration

Cette propriété contient la raison du dernier changement de focus.

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

Cette propriété détermine si la zone de texte accepte les événements de survol. La valeur par défaut est true.

Cette propriété a été introduite dans QtQuick.Controls 2.1 (Qt 5.8).

Voir également hovered.

hovered : bool [read-only, since QtQuick.Controls 2.1 (Qt 5.8)]

Cette propriété indique si la zone de texte est survolée.

Cette propriété a été introduite dans QtQuick.Controls 2.1 (Qt 5.8).

Voir aussi hoverEnabled.

implicitBackgroundHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété contient la hauteur implicite de l'arrière-plan.

La valeur est égale à background ? background.implicitHeight : 0.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi implicitBackgroundWidth.

implicitBackgroundWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété définit la largeur implicite de l'arrière-plan.

La valeur est égale à background ? background.implicitWidth : 0.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi implicitBackgroundHeight.

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

Cette propriété définit l'encart gauche de l'arrière-plan.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi Control Layout et rightInset.

placeholderText : string

Cette propriété contient la courte indication qui s'affiche dans la zone de texte avant que l'utilisateur ne saisisse une valeur.

placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété contient la couleur de placeholderText.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi placeholderText.

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

Cette propriété définit l'insertion droite de l'arrière-plan.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir aussi Control Layout et leftInset.

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

Cette propriété définit l'encart supérieur de l'arrière-plan.

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Voir également Control Layout et bottomInset.

Documentation sur la propriété Attached

TextArea.flickable : TextArea

Cette propriété permet d'attacher une zone de texte à un site Flickable.

Voir aussi ScrollBar, ScrollIndicator, et Scrollable TextArea.

Documentation sur les signaux

pressAndHold(MouseEvent event)

Ce signal est émis lors d'un appui long (le délai dépend du plugin de la plateforme). Le paramètre event fournit des informations sur l'appui, notamment les coordonnées x et y de l'appui et le bouton appuyé.

Voir également pressed et released.

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

Ce signal est émis lorsque l'utilisateur appuie sur la zone de texte. Le paramètre event fournit des informations sur l'appui, notamment les coordonnées x et y de l'appui et le bouton appuyé.

Ce signal a été introduit dans QtQuick.Controls 2.1 (Qt 5.8).

Voir également released et pressAndHold.

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

Ce signal est émis lorsque la zone de texte est relâchée par l'utilisateur. Le paramètre event fournit des informations sur le relâchement, notamment les coordonnées x et y de la pression et le bouton sur lequel l'utilisateur a appuyé.

Ce signal a été introduit dans QtQuick.Controls 2.1 (Qt 5.8).

Voir également pressed et pressAndHold.