TextField QML Type
Champ de saisie de texte sur une seule ligne. Plus d'informations...
| 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 à ligne unique. TextField étend TextInput avec une fonctionnalité placeholder text, et ajoute des décorations.
| Un champ de texte dans son état normal. |
| Un champ de texte dont le focus est actif. |
| Un champ de texte désactivé. |
TextField { placeholderText: qsTr("Enter name") }
Voir également TextArea, Personnaliser 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 l'élément d'arrière-plan n'a pas de taille explicite spécifiée, il suit 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 envisager de lui fournir une taille implicite raisonnable (à moins qu'il ne s'agisse d'un élément tel que Image, qui possède sa propre taille implicite).
Voir aussi Personnaliser TextField.
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.
Remarque : cette propriété n'indique pas si l'élément a active focus, mais la raison pour laquelle l'élément 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 | Un retour de tabulation s'est produit. L'entrée pour cela peut inclure les touches Shift ou Control ; par exemple Shift+Tab. |
Qt.ActiveWindowFocusReason | Le système de fenêtres a rendu cette fenêtre active ou inactive. |
Qt.PopupFocusReason | L'application a ouvert/fermé une fenêtre contextuelle qui a pris/retiré le focus du clavier. |
Qt.ShortcutFocusReason | L'utilisateur a tapé le raccourci d'un copain de l'étiquette. |
Qt.MenuBarFocusReason | La barre de menu a pris le focus. |
Qt.OtherFocusReason | Autre raison, généralement propre à l'application. |
Remarque : préférez 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 champ de texte est survolé.
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 l'indice qui s'affiche sur le site TextField 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 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 le signal
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é.
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 et le bouton 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 le champ de texte est relâché 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 pressé.
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.
