TextArea QML Type

Zone de saisie de texte multiligne. En savoir plus…

• 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 associé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 la classe ` TextEdit ` en y ajoutant une fonctionnalité de défilement ( placeholder text ) et des éléments de décoration.

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

TextArea n’est pas défilable en soi. En particulier sur les plateformes où la taille de l’écran est limitée, il est souvent préférable de rendre l’ensemble des pages de l’application défilables. Sur une telle page défilable, un TextArea non défilable peut s’avérer plus performant que des contrôles défilables imbriqués. Notez toutefois que, dans un tel scénario, la décoration d’arrière-plan de la TextArea défile en même temps que le reste du contenu défilant.

TextArea défilante

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

ScrollView {
    id: view
    anchors.fill: parent

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

Une zone de texte placée à l’intérieur d’une zone de défilement ( ScrollView ) effectue les opérations suivantes :

• Définit automatiquement la taille du contenu
• Garantit que la décoration d’arrière-plan reste en place
• Découpe le contenu

Focalisation via la touche Tab

Par défaut, lorsque vous appuyez sur la touche Tabulation alors que TextArea est associé à un élément active focus, un caractère de tabulation est inséré dans le contrôle lui-même. Pour que la touche Tabulation transfère le focus actif vers un autre élément, utilisez les propriétés suivantes de l'KeyNavigation:

TextField {
    id: textField
}

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

Voir également TextField, Personnalisation de 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 également Personnalisation deTextArea.

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

Cette propriété définit le retrait infé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 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 le curseur se trouve au-dessus de la zone de texte.

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

Voir également hoverEnabled.

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

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

Sa valeur est égale à « background ? background.implicitHeight : 0 ».

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

Voir également 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.

Sa valeur est égale à ` background ? background.implicitWidth : 0`.

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

Voir également implicitBackgroundHeight.

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

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

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

Voir également Control Layout et rightInset.

placeholderText : string

Cette propriété contient la brève 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 également placeholderText.

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

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

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

Voir également Control Layout et leftInset.

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

Cette propriété définit le décalage vers le haut 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 les propriétés associées

TextArea.flickable : TextArea [attached]

Cette propriété associe une zone de texte à un élément ` Flickable`.

Voir également ScrollBar, ScrollIndicator et Scrollable TextArea.

Documentation Signal

pressAndHold(MouseEvent event)

Ce signal est émis lorsqu'un appui prolongé est détecté (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, ainsi que le bouton sur lequel on a 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, ainsi que le bouton sur lequel l'utilisateur a 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 l'utilisateur relâche la zone de texte. Le paramètre event fournit des informations sur le relâchement, notamment les coordonnées x et y du point de pression, ainsi que 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.