TextField QML Type
Champ de saisie de texte à une ligne. En savoir plus…
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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))
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
TextField est un éditeur de texte à une seule ligne. TextField étend la classe TextInput en y ajoutant une fonctionnalité de « placeholder text » et en y ajoutant une décoration.
| Un champ de texte à l'état normal. |
| Un champ de texte qui a le focus. |
| Un champ de texte désactivé. |
TextField {
placeholderText: qsTr("Enter name")
}Voir également TextArea, Personnalisation de TextField et Contrôles de saisie.
Documentation sur les propriétés
background : Item
Cette propriété contient l'élément d'arrière-plan.
Remarque : si aucune taille n'est explicitement spécifiée pour l'élément d'arrière-plan, celui-ci adopte automatiquement la taille du contrôle. Dans la plupart des cas, il n'est pas nécessaire de spécifier la largeur ou la hauteur d'un élément d'arrière-plan.
Remarque : la plupart des contrôles utilisent la taille implicite de l'élément d'arrière-plan pour calculer la taille implicite du contrôle lui-même. Si vous remplacez l'élément d'arrière-plan par un élément personnalisé, vous devez également veiller à lui attribuer une taille implicite appropriée (à moins qu'il ne s'agisse d'un élément tel que « Image », qui possède sa propre taille implicite).
Voir également Personnalisation deTextField.
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.
Remarque : cette propriété n'indique pas si l'élément dispose d'active focus, mais la raison pour laquelle il a gagné ou perdu le focus.
| Constante | Description |
|---|---|
Qt.MouseFocusReason | Une action de la souris s’est produite. |
Qt.TabFocusReason | La touche Tab a été enfoncée. |
Qt.BacktabFocusReason | Une action « Retour Tab » s’est produite. La saisie peut inclure les touches Maj ou Ctrl ; par exemple, Maj+Tab. |
Qt.ActiveWindowFocusReason | Le système de fenêtrage a rendu cette fenêtre active ou inactive. |
Qt.PopupFocusReason | L'application a ouvert/fermé une fenêtre contextuelle qui a pris/libéré le focus du clavier. |
Qt.ShortcutFocusReason | L'utilisateur a saisi le raccourci associé à une étiquette |
Qt.MenuBarFocusReason | La barre de menus a pris le focus. |
Qt.OtherFocusReason | Une autre raison, généralement spécifique à l'application. Remarque : privilégiez la propriété ` QtQuick.Controls::Control::focusReason ` à cette propriété. |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Cette propriété détermine si le champ de texte accepte les événements de survol. La valeur par défaut est « false ».
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 du champ 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 l'indication qui s'affiche dans l'TextField e avant que l'utilisateur ne saisisse du texte.
placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]
Cette propriété contient la couleur de l'élément « 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 signaux
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é.
Remarque : le gestionnaire correspondant est onPressAndHold.
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 le champ 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é.
Remarque : le gestionnaire correspondant est onPressed.
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 le champ de texte. Le paramètre ` event ` fournit des informations sur le relâchement, notamment les coordonnées x et y du point de relâchement, ainsi que le bouton sur lequel l'utilisateur a appuyé.
Remarque : le gestionnaire correspondant est onReleased.
Ce signal a été introduit dans QtQuick.Controls 2.1 (Qt 5.8).
Voir également pressed et 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.
