TextInput QML Type
Affiche une ligne de texte modifiable. Plus...
| Import Statement: | import QtQuick |
| Inherits: |
Propriétés
- acceptableInput : bool
- activeFocusOnPress : bool
- autoScroll : bool
- bottomPadding : real
- canPaste : bool
- canRedo : bool
- canUndo : bool
- color : color
- contentHeight : real
- contentWidth : real
- cursorDelegate : Component
- cursorPosition : int
- cursorRectangle : rectangle
- cursorVisible : bool
- displayText : string
- echoMode : enumeration
- effectiveHorizontalAlignment : enumeration
- font.bold : bool
- font.capitalization : enumeration
- font.contextFontMerging : bool
(since 6.8) - font.family : string
- font.features : object
(since 6.6) - font.hintingPreference : enumeration
- font.italic : bool
- font.kerning : bool
- font.letterSpacing : real
- font.pixelSize : int
- font.pointSize : real
- font.preferShaping : bool
- font.preferTypoLineMetrics : bool
(since 6.8) - font.strikeout : bool
- font.styleName : string
- font.underline : bool
- font.variableAxes : object
(since 6.7) - font.weight : int
- font.wordSpacing : real
- horizontalAlignment : enumeration
- inputMask : string
- inputMethodComposing : bool
- inputMethodHints : enumeration
- leftPadding : real
- length : int
- maximumLength : int
- mouseSelectionMode : enumeration
- overwriteMode : bool
- padding : real
- passwordCharacter : string
- passwordMaskDelay : int
- persistentSelection : bool
- preeditText : string
- readOnly : bool
- renderType : enumeration
- rightPadding : real
- selectByMouse : bool
- selectedText : string
- selectedTextColor : color
- selectionColor : color
- selectionEnd : int
- selectionStart : int
- text : string
- topPadding : real
- validator : Validator
- verticalAlignment : enumeration
- wrapMode : enumeration
Signaux
Méthodes
- clear()
- copy()
- cut()
- deselect()
- ensureVisible(int position)
- string getText(int start, int end)
- insert(int position, string text)
- isRightToLeft(int start, int end)
- moveCursorSelection(int position, SelectionMode mode)
- paste()
- int positionAt(real x, real y, CursorPosition position)
- rect positionToRectangle(int pos)
- redo()
- remove(int start, int end)
- select(int start, int end)
- selectAll()
- selectWord()
- undo()
Description détaillée
Le type TextInput affiche une seule ligne de texte brut modifiable.
TextInput est utilisé pour accepter une ligne de texte en entrée. Des contraintes de saisie peuvent être imposées à un élément TextInput (par exemple, par l'intermédiaire de validator ou inputMask), et le fait de donner à echoMode une valeur appropriée permet d'utiliser TextInput pour un champ de saisie de mot de passe.
Pour réagir à l'acceptation d'un texte par l'utilisateur via les touches Return ou Enter, il convient de gérer le signal accepted(). Lorsque les touches Return ou Enter sont actionnées et que l'entrée de texte perd le focus, le signal editingFinished() est émis. Lorsque le texte est modifié de quelque manière que ce soit par l'utilisateur, le signal textEdited() est émis. Ces signaux doivent être préférés à textChanged() dans la plupart des cas.
Sous macOS, les raccourcis clavier Up/Down pour Home/End sont explicitement désactivés. Si vous voulez de telles liaisons (sur n'importe quelle plateforme), vous devrez les construire en QML.
Voir également TextEdit et Text.
Documentation sur les propriétés
horizontalAlignment : enumeration |
verticalAlignment : enumeration |
Définit l'alignement horizontal du texte dans la largeur et la hauteur de l'élément TextInput. Par défaut, l'alignement du texte suit l'alignement naturel du texte, par exemple un texte lu de gauche à droite sera aligné à gauche.
TextInput n'a pas d'alignement vertical, car la hauteur naturelle est exactement la hauteur de la ligne de texte. Si vous définissez manuellement une hauteur supérieure, TextInput sera toujours aligné verticalement en haut. Vous pouvez utiliser des ancres pour l'aligner comme vous le souhaitez dans un autre élément.
Les valeurs valables pour horizontalAlignment sont TextInput.AlignLeft, TextInput.AlignRight et TextInput.AlignHCenter.
Les valeurs valables pour verticalAlignment sont TextInput.AlignTop (par défaut), TextInput.AlignBottom TextInput.AlignVCenter .
Lorsque vous utilisez la propriété jointe LayoutMirroring::enabled pour reproduire les dispositions d'une application, l'alignement horizontal du texte est également reproduit. Cependant, la propriété horizontalAlignment restera inchangée. Pour demander l'alignement horizontal effectif de TextInput, utilisez la propriété en lecture seule effectiveHorizontalAlignment.
Ces propriétés contiennent l'espace autour du contenu. Cet espace est réservé en plus des propriétés contentWidth et contentHeight.
Les propriétés de remplissage individuelles prennent la valeur de la propriété padding à moins qu'elles ne soient définies explicitement. Par exemple, si padding est défini comme 4 et leftPadding comme 8, 8 sera utilisé comme espace de remplissage à gauche.
Remarque : si une largeur ou une hauteur explicite est attribuée à un site TextInput, il faut veiller à ce qu'elle soit suffisamment grande pour prendre en compte les valeurs de remplissage correspondantes. Par exemple : si topPadding et bottomPadding sont définis à 10, mais que la hauteur de TextInput n'est définie qu'à 20, le texte n'aura pas assez d'espace vertical pour être rendu et apparaîtra tronqué.
acceptableInput : bool |
Cette propriété est toujours vraie, sauf si un validateur ou un masque de saisie a été défini. Si un validateur ou un masque de saisie a été défini, cette propriété ne sera vraie que si le texte actuel est acceptable pour le validateur ou le masque de saisie en tant que chaîne finale (et non en tant que chaîne intermédiaire).
activeFocusOnPress : bool |
Indique si le site TextInput doit être mis en évidence lors d'une pression de la souris. Par défaut, cette option est réglée sur true (vrai).
autoScroll : bool |
Si le site TextInput doit défiler lorsque le texte est plus long que la largeur. Par défaut, cette valeur est fixée à true.
Voir également ensureVisible().
canPaste : bool |
canRedo : bool |
canUndo : bool |
Retourne vrai si TextInput est accessible en écriture et si des opérations précédentes peuvent être annulées.
color : color |
La couleur du texte.
contentHeight : real |
Renvoie la hauteur du texte, y compris la hauteur au-delà de la hauteur qui est couverte si le texte ne tient pas dans la hauteur définie.
contentWidth : real |
Renvoie la largeur du texte, y compris la largeur au-delà de la largeur couverte en raison d'un habillage insuffisant si l'option wrapMode est activée.
cursorDelegate : Component |
Le délégué du curseur dans la page TextInput.
Si vous définissez un cursorDelegate pour un TextInput, ce délégué sera utilisé pour dessiner le curseur au lieu du curseur standard. Une instance du délégué sera créée et gérée par TextInput lorsqu'un curseur sera nécessaire, et la propriété x de l'instance du délégué sera définie de manière à se trouver un pixel avant le coin supérieur gauche du caractère actuel.
Notez que l'élément racine du composant délégué doit être un élément dérivé de QQuickItem ou QQuickItem.
cursorPosition : int |
La position du curseur dans la page TextInput. Le curseur est positionné entre les caractères.
Remarque : dans ce cas, les caractères font référence à la chaîne d'objets QChar, donc à des caractères Unicode de 16 bits, et la position est considérée comme un index dans cette chaîne. Cela ne correspond pas nécessairement aux graphèmes individuels du système d'écriture, car un seul graphème peut être représenté par plusieurs caractères Unicode, comme dans le cas des paires de substituts, des ligatures linguistiques ou des diacritiques.
displayText La situation est différente si echoMode est défini comme TextInput.Password: chaque passwordCharacter est alors un caractère "étroit" (la position du curseur est toujours déplacée de 1), même si le texte contenu dans le TextInput ne l'est pas.
cursorRectangle : rectangle |
Le rectangle où le curseur de texte standard est rendu dans l'entrée de texte. En lecture seule.
La position et la hauteur d'un cursorDelegate personnalisé sont mises à jour automatiquement pour suivre le cursorRectangle lorsqu'il change. La largeur du délégué n'est pas affectée par les modifications du rectangle du curseur.
cursorVisible : bool |
La valeur "true" est attribuée lorsque le site TextInput affiche un curseur.
Cette propriété est activée et désactivée lorsque le site TextInput obtient le focus actif, de sorte que d'autres propriétés peuvent être liées à l'affichage du curseur. Comme elle est définie et désactivée automatiquement, vous devez garder à l'esprit que votre valeur peut être écrasée si vous la définissez vous-même.
Elle peut être définie directement dans un script, par exemple si un KeyProxy peut lui transmettre des touches et que vous souhaitez qu'elle ait l'air active lorsque cela se produit (sans pour autant lui donner le focus actif).
Elle ne doit pas être définie directement sur l'élément, comme dans le code QML ci-dessous, car la valeur spécifiée sera remplacée et perdue en cas de changement de focus.
TextInput { text: "Text" cursorVisible: false }
Dans l'extrait ci-dessus, le curseur devient visible lorsque l'attention est portée sur le site TextInput.
displayText : string |
Il s'agit du texte affiché dans la page TextInput.
Si echoMode est défini sur TextInput::Normal, cette propriété a la même valeur que la propriété TextInput::text. Sinon, cette propriété contient le texte visible par l'utilisateur, tandis que la propriété text contient le texte saisi.
Remarque : contrairement à la propriété TextInput::text, cette propriété contient une entrée de texte partielle provenant d'une méthode d'entrée.
Voir également preeditText.
echoMode : enumeration |
Spécifie comment le texte doit être affiché dans la propriété TextInput.
| Constante | Description |
|---|---|
TextInput.Normal | Affiche le texte tel quel. (par défaut) |
TextInput.Password | Affiche le site passwordCharacter au lieu des caractères réels. Lors de l'édition, les caractères nouvellement saisis sont affichés en clair pendant une courte période spécifiée par la propriété passwordMaskDelay. |
TextInput.NoEcho | N'affiche rien. |
TextInput.PasswordEchoOnEdit | Le contenu est masqué comme pour TextInput.Password. Pendant l'édition, les caractères nouvellement saisis sont affichés en clair tant que la page TextInput est active. |
effectiveHorizontalAlignment : enumeration |
Lors de l'utilisation de la propriété jointe LayoutMirroring::enabled pour refléter les dispositions de l'application, l'alignement horizontal du texte sera également reflété. Cependant, la propriété horizontalAlignment restera inchangée. Pour demander l'alignement horizontal effectif de TextInput, utilisez la propriété en lecture seule effectiveHorizontalAlignment.
font.bold : bool |
Définit si le poids de la police est gras.
font.capitalization : enumeration |
Définit la capitalisation du texte.
| Constante | Description |
|---|---|
Font.MixedCase | le cas normal : aucun changement de capitalisation n'est appliqué |
Font.AllUppercase | modifie le texte pour qu'il soit rendu en majuscules |
Font.AllLowercase | modifie le texte pour qu'il soit rendu en minuscules |
Font.SmallCaps | modifie le texte pour qu'il soit rendu en petites capitales |
Font.Capitalize | modifie le texte pour qu'il soit rendu avec le premier caractère de chaque mot en majusculeTextInput { text: "Hello"; font.capitalization: Font.AllLowercase } |
font.contextFontMerging : bool |
Si la police sélectionnée ne contient pas un certain caractère, Qt choisit automatiquement une police de remplacement similaire qui contient le caractère. Par défaut, ce choix s'effectue caractère par caractère.
Cela signifie que dans certains cas peu courants, plusieurs polices différentes peuvent être utilisées pour représenter une chaîne de texte, même s'il s'agit du même script. En fixant contextFontMerging à true, on essaiera de trouver la police de remplacement qui correspond au plus grand sous-ensemble de la chaîne d'entrée. Cela sera plus coûteux pour les chaînes où des glyphes manquent, mais peut donner des résultats plus cohérents. Par défaut, contextFontMerging est false.
Cette propriété a été introduite dans Qt 6.8.
Voir aussi QFont::StyleStrategy.
font.family : string |
Définit le nom de famille de la police.
Le nom de famille est insensible à la casse et peut éventuellement inclure un nom de fonderie, par exemple "Helvetica [Cronyx]". Si la famille est disponible dans plus d'une fonderie et que la fonderie n'est pas spécifiée, une fonderie arbitraire est choisie. Si la famille n'est pas disponible, une famille sera définie en utilisant l'algorithme de correspondance des polices.
font.features : object |
Applique des valeurs entières à des caractéristiques OpenType spécifiques lors de la mise en forme du texte en fonction du contenu de features. Cela permet un accès avancé au processus de mise en forme des polices et peut être utilisé pour prendre en charge des caractéristiques de polices qui ne sont pas couvertes par l'API.
Les caractéristiques des polices sont représentées par une correspondance entre des balises à quatre lettres et des valeurs entières. Cette valeur entière transmise avec la balise représente dans la plupart des cas une valeur booléenne : Une valeur nulle signifie que la fonctionnalité est désactivée, et une valeur non nulle signifie qu'elle est activée. Pour certaines fonctions de police, cependant, elle peut avoir d'autres interprétations. Par exemple, lorsqu'elle est appliquée à la fonction salt, la valeur est un index qui spécifie l'alternative stylistique à utiliser.
Par exemple, la fonction de police frac convertira les fractions diagonales séparées par une barre oblique (comme 1/2) en une représentation différente. Typiquement, cela implique de faire passer la fraction complète dans une largeur de caractère unique (comme ½).
Si une police supporte la fonctionnalité frac, elle peut être activée dans la mise en forme comme dans le code suivant :
Text { text: "One divided by two is 1/2" font.family: "MyFractionFont" font.features: { "frac": 1 } }
Il est possible d'attribuer des valeurs à plusieurs caractéristiques dans le même mappage. Par exemple, si vous souhaitez également désactiver le crénage pour la police, vous pouvez le désactiver explicitement comme suit :
Text { text: "One divided by two is 1/2" font.family: "MyFractionFont" font.features: { "frac": 1, "kern": 0 } }
Vous pouvez également rassembler les propriétés de la police dans un objet :
Text {
text: "One divided by two is 1/2"
font: {
family: "MyFractionFont"
features: { "frac": 1, "kern": 0 }
}
}Remarque : par défaut, Qt active et désactive certaines fonctions de police en fonction d'autres propriétés de police. En particulier, la fonction kern sera activée/désactivée en fonction de la propriété font.kerning de la police QFont. En outre, toutes les fonctions de ligature (liga, clig, dlig, hlig) seront désactivées si une propriété font.letterSpacing est définie, mais uniquement pour les systèmes d'écriture dans lesquels l'utilisation de la ligature est cosmétique. Pour les systèmes d'écriture où les ligatures sont nécessaires, les caractéristiques resteront dans leur état par défaut. Les valeurs définies à l'aide de font.features remplaceront le comportement par défaut. Si, par exemple, "kern" est défini à 1, le crénage sera toujours activé, même si la propriété font.kerning est définie à false. De même, si la propriété 0 est définie, le crénage sera toujours désactivé.
Cette propriété a été introduite dans Qt 6.6.
Voir aussi QFont::setFeature().
font.hintingPreference : enumeration |
Définit l'indication préférée sur le texte. Il s'agit d'une indication au système de rendu de texte sous-jacent d'utiliser un certain niveau d'indication, et la prise en charge varie selon les plates-formes. Voir le tableau dans la documentation de QFont::HintingPreference pour plus de détails.
Remarque : cette propriété n'a d'effet que lorsqu'elle est utilisée avec le type de rendu TextInput.NativeRendering.
| Constant | Description |
|---|---|
Font.PreferDefaultHinting | Utilise le niveau d'indication par défaut pour la plate-forme cible. |
Font.PreferNoHinting | Si possible, rendez le texte sans indiquer les contours des glyphes. La mise en page du texte sera typographiquement exacte, en utilisant les mêmes mesures que celles utilisées, par exemple, lors de l'impression. |
Font.PreferVerticalHinting | Si possible, rendre le texte sans indication horizontale, mais aligner les glyphes sur la grille de pixels dans le sens vertical. Le texte apparaîtra plus net sur les écrans dont la densité est trop faible pour permettre un rendu précis des glyphes. Mais comme la métrique horizontale des glyphes n'est pas hachurée, la disposition du texte pourra être adaptée à des dispositifs à plus forte densité (tels que les imprimantes) sans affecter les détails tels que les sauts de ligne. |
Font.PreferFullHinting | Si possible, rendez le texte avec des indices dans les directions horizontales et verticales. Le texte sera modifié pour optimiser la lisibilité sur le périphérique cible, mais comme les mesures dépendront de la taille cible du texte, la position des glyphes, des sauts de ligne et d'autres détails typographiques ne seront pas modifiés, ce qui signifie qu'une disposition de texte peut être différente sur des périphériques ayant des densités de pixels différentes.TextInput { text: "Hello"; renderType: TextInput.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting } |
font.italic : bool |
Définit si la police a un style italique.
font.kerning : bool |
Active ou désactive la fonctionnalité OpenType de crénage lors de la mise en forme du texte. La désactivation de cette fonction peut améliorer les performances lors de la création ou de la modification du texte, au détriment de certaines caractéristiques esthétiques. La valeur par défaut est true.
TextInput { text: "OATS FLAVOUR WAY"; font.kerning: false }
font.letterSpacing : real |
Définit l'espacement des lettres pour la police.
L'espacement des lettres modifie l'espacement par défaut entre les lettres individuelles dans la police. Une valeur positive augmente l'espacement des lettres des pixels correspondants ; une valeur négative diminue l'espacement.
font.pixelSize : int |
Définit la taille de la police en pixels.
L'utilisation de cette fonction rend la police dépendante du périphérique. Utilisez pointSize pour définir la taille de la police indépendamment du périphérique.
font.pointSize : real |
Définit la taille de la police en points. La taille en points doit être supérieure à zéro.
font.preferShaping : bool |
Parfois, une police applique des règles complexes à un ensemble de caractères afin de les afficher correctement. Dans certains systèmes d'écriture, tels que les alphabets brahmiques, cela est nécessaire pour que le texte soit lisible, mais dans les alphabets latins, par exemple, il s'agit simplement d'une caractéristique cosmétique. En définissant la propriété preferShaping sur false, toutes ces fonctionnalités seront désactivées lorsqu'elles ne sont pas nécessaires, ce qui améliorera les performances dans la plupart des cas.
La valeur par défaut est true.
TextInput { text: "Some text"; font.preferShaping: false }
font.preferTypoLineMetrics : bool |
concurrence des ensembles de métriques de lignes verticales qui fournissent les ascent, descent et leading de la police. Ces métriques sont souvent appelées métriques win (Windows) et métriques typo (typographie). Bien que la spécification recommande l'utilisation de la métrique typo pour l'espacement des lignes, de nombreuses applications préfèrent la métrique win à moins que le drapeau USE_TYPO_METRICS ne soit défini dans le champ fsSelection de la police. Pour des raisons de compatibilité ascendante, c'est également le cas pour les applications Qt. Ce n'est pas un problème pour les polices qui définissent le drapeau USE_TYPO_METRICS pour indiquer que les métriques typo sont valides, ni pour les polices dont les métriques win et typo correspondent. Cependant, pour certaines polices, la métrique win peut être plus grande que l'interligne préférable et l'indicateur USE_TYPO_METRICS peut être désactivé par erreur. Pour ces polices, le réglage de font.preferTypoLineMetrics peut donner de meilleurs résultats.
Par défaut, preferTypoLineMetrics est false.
Cette propriété a été introduite dans Qt 6.8.
Voir aussi QFont::StyleStrategy.
font.strikeout : bool |
Définit si la police a un style de biffure.
font.styleName : string |
Définit le nom du style de la police.
Le nom du style est insensible à la casse. S'il est défini, la police sera comparée au nom de style plutôt qu'aux propriétés de police font.weight, font.bold et font.italic.
font.underline : bool |
Définit si le texte est souligné.
font.variableAxes : object |
Applique des valeurs à virgule flottante aux axes variables dans les polices variables.
Les polices variables permettent de stocker plusieurs variations (avec des graisses, des largeurs ou des styles différents) dans le même fichier de police. Les variations sont données sous forme de valeurs à virgule flottante pour un ensemble prédéfini de paramètres, appelés "axes variables". Des instances spécifiques sont généralement nommées par le concepteur de la police et, dans Qt Designer, elles peuvent être sélectionnées à l'aide de setStyleName(), tout comme les sous-familles traditionnelles.
Dans certains cas, il est également utile de fournir des valeurs arbitraires pour les différents axes. Par exemple, si une police possède une sous-famille Regular et une sous-famille Bold, vous pouvez souhaiter un poids intermédiaire entre ces deux sous-familles. Vous pouvez alors le demander manuellement en fournissant une valeur personnalisée pour l'axe "wght" de la police.
Text { text: "Foobar" font.family: "MyVariableFont" font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 } }
Si l'axe "wght" est pris en charge par la police et que la valeur fournie se situe dans la plage définie, une police correspondant au poids 550.0 sera fournie.
Il existe quelques axes standard que de nombreuses polices fournissent, tels que "wght" (poids), "wdth" (largeur), "ital" (italique) et "opsz" (taille optique). Chacune d'entre elles a des plages individuelles définies dans la police elle-même. Par exemple, "wght" peut s'étendre de 100 à 900 (QFont::Thin à QFont::Black) tandis que "ital" peut s'étendre de 0 à 1 (de non italique à totalement italique).
Une police peut également choisir de définir des axes personnalisés ; la seule limitation est que le nom doit répondre aux exigences d'un QFont::Tag (séquence de quatre caractères latins-1).
Par défaut, aucun axe variable n'est défini.
Remarque : sous Windows, les axes variables ne sont pas pris en charge si la police GDI optionnelle est utilisée.
Cette propriété a été introduite dans Qt 6.7.
Voir également QFont::setVariableAxis().
font.weight : int |
Le poids demandé pour la police. Le poids demandé doit être un entier compris entre 1 et 1000, ou l'une des valeurs prédéfinies :
| Constante | Description |
|---|---|
Font.Thin | 100 |
Font.ExtraLight | 200 |
Font.Light | 300 |
Font.Normal | 400 (par défaut) |
Font.Medium | 500 |
Font.DemiBold | 600 |
Font.Bold | 700 |
Font.ExtraBold | 800 |
Font.Black | 900TextInput { text: "Hello"; font.weight: Font.DemiBold } |
font.wordSpacing : real |
Définit l'espacement des mots pour la police.
L'espacement entre les mots modifie l'espacement par défaut entre les mots individuels. Une valeur positive augmente l'espacement entre les mots d'un nombre correspondant de pixels, tandis qu'une valeur négative diminue l'espacement entre les mots en conséquence.
inputMask : string |
Permet de définir un masque de saisie sur le site TextInput, limitant les entrées de texte autorisées. Voir QLineEdit::inputMask pour plus de détails, car les mêmes chaînes de masques sont utilisées par TextInput.
Voir également acceptableInput et validator.
inputMethodComposing : bool |
Cette propriété s'applique si le site TextInput dispose d'une entrée de texte partielle provenant d'une méthode d'entrée.
Pendant qu'elle compose, une méthode d'entrée peut s'appuyer sur des événements souris ou clavier provenant de TextInput pour modifier ou valider le texte partiel. Cette propriété peut être utilisée pour déterminer quand désactiver les gestionnaires d'événements susceptibles d'interférer avec le bon fonctionnement d'une méthode de saisie.
inputMethodHints : enumeration |
Fournit des indications à la méthode de saisie sur le contenu attendu de la saisie de texte et sur la manière dont elle doit fonctionner.
La valeur est une combinaison bit à bit de drapeaux, ou Qt.ImhNone si aucun indice n'est défini.
Les drapeaux qui modifient le comportement sont
| Constante | Description |
|---|---|
Qt.ImhHiddenText | Les caractères doivent être cachés, comme c'est généralement le cas lors de la saisie d'un mot de passe. |
Qt.ImhSensitiveData | Le texte tapé ne doit pas être stocké par la méthode de saisie active dans une mémoire persistante telle que le dictionnaire prédictif de l'utilisateur. |
Qt.ImhNoAutoUppercase | La méthode de saisie ne doit pas essayer de passer automatiquement en majuscules à la fin d'une phrase. |
Qt.ImhPreferNumbers | Les chiffres sont préférables (mais pas obligatoires). |
Qt.ImhPreferUppercase | Les lettres majuscules sont préférées (mais pas obligatoires). |
Qt.ImhPreferLowercase | Les lettres minuscules sont préférables (mais pas obligatoires). |
Qt.ImhNoPredictiveText | N'utilisez pas de texte prédictif (c'est-à-dire de recherche dans le dictionnaire) lorsque vous tapez. |
Qt.ImhDate | L'éditeur de texte fonctionne comme un champ de date. |
Qt.ImhTime | L'éditeur de texte fonctionne comme un champ d'heure. |
Les drapeaux qui limitent la saisie (drapeaux exclusifs) sont les suivants :
| Constante | Description |
|---|---|
Qt.ImhDigitsOnly | Seuls les chiffres sont autorisés. |
Qt.ImhFormattedNumbersOnly | Seule la saisie de chiffres est autorisée. Cela inclut le point décimal et le signe moins. |
Qt.ImhUppercaseOnly | Seules les lettres majuscules sont autorisées. |
Qt.ImhLowercaseOnly | Seules les lettres minuscules peuvent être saisies. |
Qt.ImhDialableCharactersOnly | Seuls les caractères adaptés à la composition d'un numéro de téléphone sont autorisés. |
Qt.ImhEmailCharactersOnly | Seuls les caractères adaptés aux adresses électroniques sont autorisés. |
Qt.ImhUrlCharactersOnly | Seuls les caractères adaptés aux URL sont autorisés. |
Masques :
| Constante | Description |
|---|---|
Qt.ImhExclusiveInputMask | Ce masque renvoie une valeur non nulle si l'un des indicateurs exclusifs est utilisé. |
length : int |
Renvoie le nombre total de caractères de l'élément TextInput.
Si l'article TextInput est accompagné d'un article inputMask, la longueur comprendra les caractères du masque et peut différer de la longueur de la chaîne renvoyée par la propriété text.
Cette propriété peut être plus rapide que l'interrogation de la longueur de la propriété text car elle ne nécessite pas de copie ou de conversion des données de chaîne internes de TextInput.
maximumLength : int |
La longueur maximale autorisée du texte dans la propriété TextInput.
Si le texte est trop long, il est tronqué à la limite.
Par défaut, cette propriété contient une valeur de 32767.
mouseSelectionMode : enumeration |
Spécifie comment le texte doit être sélectionné à l'aide de la souris.
| Constante | Description |
|---|---|
TextInput.SelectCharacters | (par défaut) La sélection est mise à jour avec des caractères individuels. |
TextInput.SelectWords | La sélection est mise à jour avec des mots entiers. |
Cette propriété ne s'applique que si selectByMouse est vrai.
overwriteMode : bool |
Indique si le texte saisi par l'utilisateur remplacera le texte existant.
Comme de nombreux éditeurs de texte, le widget de l'éditeur de texte peut être configuré pour insérer ou remplacer le texte existant par le nouveau texte saisi par l'utilisateur.
Si cette propriété vaut true, le texte existant est écrasé, caractère par caractère, par le nouveau texte ; sinon, le texte est inséré à la position du curseur, en déplaçant le texte existant.
Par défaut, cette propriété vaut false (le nouveau texte n'écrase pas le texte existant).
passwordCharacter : string |
Il s'agit du caractère affiché lorsque echoMode a pour valeur Password ou PasswordEchoOnEdit. Par défaut, il s'agit du caractère de mot de passe utilisé par le thème de la plate-forme.
Si cette propriété est définie comme une chaîne comportant plus d'un caractère, le premier caractère est utilisé. Si la chaîne est vide, la valeur est ignorée et la propriété n'est pas définie.
passwordMaskDelay : int |
Définit le délai avant que le caractère visible ne soit masqué par le caractère du mot de passe, en millisecondes.
La méthode de réinitialisation sera appelée en assignant undefined.
persistentSelection : bool |
Indique si le site TextInput doit conserver sa sélection lorsqu'il perd le focus actif au profit d'un autre élément de la scène. La valeur par défaut est false ;
preeditText : string |
Cette propriété contient du texte partiel provenant d'une méthode de saisie.
Pour désactiver le texte partiel résultant des prédictions, activez l'indicateur Qt.ImhNoPredictiveText dans inputMethodHints.
Voir également displayText et inputMethodHints.
readOnly : bool |
Définit si l'utilisateur peut modifier le contenu de TextInput.
Si la valeur readOnly est fixée à true, la saisie de l'utilisateur n'affecte pas la propriété text. Les liaisons ou les tentatives de définition de la propriété text fonctionneront toujours.
renderType : enumeration |
Remplacer le type de rendu par défaut pour ce composant.
Les types de rendu pris en charge sont les suivants
| Constante | Description |
|---|---|
TextInput.QtRendering | Le texte est rendu à l'aide d'un champ de distance évolutif pour chaque glyphe. |
TextInput.NativeRendering | Le texte est rendu à l'aide d'une technique spécifique à la plate-forme. |
TextInput.CurveRendering | Le texte est rendu à l'aide d'un rasterizer de courbes fonctionnant directement sur le matériel graphique. (Introduit dans Qt 6.7.0.) |
Sélectionnez TextInput.NativeRendering si vous préférez que le texte ait un aspect natif sur la plate-forme cible et si vous n'avez pas besoin de fonctions avancées telles que la transformation du texte. L'utilisation de ces fonctions en combinaison avec le type de rendu NativeRendering donnera des résultats médiocres et parfois pixellisés.
TextInput.QtRendering et TextInput.CurveRendering sont des techniques accélérées par le matériel. QtRendering est la plus rapide des deux, mais utilise plus de mémoire et présentera des artefacts de rendu à grande échelle. CurveRendering doit être considéré comme une alternative dans les cas où QtRendering ne donne pas de bons résultats visuels ou lorsque la réduction de la consommation de mémoire graphique est une priorité.
Le type de rendu par défaut est déterminé par QQuickWindow::textRenderType().
selectByMouse : bool |
La valeur par défaut est true.
Si la valeur est vraie, l'utilisateur peut utiliser la souris pour sélectionner du texte de la manière habituelle.
Remarque : dans les versions antérieures à la version 6.4, la valeur par défaut était false; mais si vous activez cette propriété, vous pouvez également sélectionner du texte sur un écran tactile en faisant glisser votre doigt sur l'écran. Cela interférait avec le flicage lorsque TextInput était utilisé à l'intérieur d'un Flickable. Par souci de cohérence avec TextField, selectByMouse signifie désormais ce qu'elle dit : si true, vous pouvez sélectionner du texte en le faisant glisser uniquement à l'aide d'une souris. Si ce changement ne convient pas à votre application, vous pouvez remplacer selectByMouse par false ou importer une ancienne version de l'API (par exemple import QtQuick 6.3) pour revenir au comportement précédent. L'option permettant d'inverser le comportement en modifiant la version d'importation sera supprimée dans une version ultérieure de Qt.
selectedText : string |
Cette propriété en lecture seule fournit le texte actuellement sélectionné dans l'entrée de texte.
Elle est équivalente à l'extrait suivant, mais elle est plus rapide et plus facile à utiliser.
myTextInput.text.toString().substring(myTextInput.selectionStart,
myTextInput.selectionEnd);selectedTextColor : color |
La couleur du texte en surbrillance, utilisée dans les sélections.
selectionColor : color |
La couleur de surbrillance du texte, utilisée derrière les sélections.
selectionEnd : int |
La position du curseur après le dernier caractère de la sélection actuelle.
Cette propriété est en lecture seule. Pour modifier la sélection, utilisez select(start,end), selectAll() ou selectWord().
Voir également selectionStart, cursorPosition, et selectedText.
selectionStart : int |
Position du curseur avant le premier caractère de la sélection actuelle.
Cette propriété est en lecture seule. Pour modifier la sélection, utilisez select(start,end), selectAll() ou selectWord().
Voir également selectionEnd, cursorPosition, et selectedText.
text : string |
Le texte de la page TextInput.
Notez que certains claviers utilisent une fonction prédictive. Dans ce cas, le texte composé par la méthode de saisie ne fait pas partie de cette propriété. La partie du texte liée aux prédictions est soulignée et stockée dans la propriété preeditText. Pour obtenir l'intégralité du texte affiché dans la propriété TextInput, utilisez la propriété displayText.
Voir aussi clear(), displayText, preeditText, accepted(), editingFinished() et textEdited().
validator : Validator |
Permet de définir un validateur sur le site TextInput. Lorsqu'un validateur est défini, le site TextInput n'accepte que les entrées qui laissent la propriété de texte dans un état acceptable ou intermédiaire. Le signal d'acceptation ne sera envoyé que si le texte est dans un état acceptable au moment où l'on appuie sur la touche Entrée.
Les validateurs actuellement pris en charge sont IntValidator, DoubleValidator et RegularExpressionValidator. Un exemple d'utilisation des validateurs est présenté ci-dessous, qui autorise la saisie d'entiers compris entre 11 et 31 dans la saisie de texte :
import QtQuick 2.0 TextInput{ validator: IntValidator{bottom: 11; top: 31;} focus: true }
Voir également acceptableInput et inputMask.
wrapMode : enumeration |
Cette propriété permet d'envelopper le texte à la largeur de l'élément TextInput. Le texte ne sera enveloppé que si une largeur explicite a été définie.
| Constante | Description |
|---|---|
TextInput.NoWrap | (par défaut) aucun habillage n'est effectué. Si le texte ne contient pas suffisamment de nouvelles lignes, contentWidth dépassera la largeur définie. |
TextInput.WordWrap | L'habillage se fait uniquement à la limite des mots. Si un mot est trop long, contentWidth dépassera la largeur fixée. |
TextInput.WrapAnywhere | l'habillage se fait à n'importe quel endroit de la ligne, même s'il se produit au milieu d'un mot. |
TextInput.Wrap | si possible, l'habillage se fait à la limite d'un mot ; sinon, il se fait à l'endroit approprié sur la ligne, même au milieu d'un mot. |
La valeur par défaut est TextInput.NoWrap. Si vous définissez une largeur, pensez à utiliser TextInput.Wrap.
Documentation du signal
accepted() |
Ce signal est émis lorsque la touche Return ou Enter est enfoncée. Notez que si l'entrée de texte est définie par validator ou inputMask, le signal n'est émis que si l'entrée est dans un état acceptable.
Remarque : le gestionnaire correspondant est onAccepted.
Voir également editingFinished() et textEdited().
editingFinished() |
Ce signal est émis lorsque la touche Return ou Enter est pressée ou que l'entrée de texte perd le focus. Notez que si un validateur ou inputMask est défini sur l'entrée de texte et que l'on appuie sur Entrée ou Retour, ce signal ne sera émis que si l'entrée suit le inputMask et que le validateur renvoie un état acceptable.
Remarque : le gestionnaire correspondant est onEditingFinished.
Voir également accepted() et textEdited().
textEdited() |
Ce signal est émis lorsque le texte est modifié. Contrairement à textChanged(), ce signal n'est pas émis lorsque le texte est modifié par programme, par exemple en changeant la valeur de la propriété text ou en appelant clear().
Remarque : le gestionnaire correspondant est onTextEdited.
Voir également accepted() et editingFinished().
Documentation de la méthode
clear() |
Efface le contenu de l'entrée de texte et réinitialise l'entrée de texte partielle d'une méthode d'entrée.
Utilisez cette méthode au lieu de donner à la propriété text la valeur d'une chaîne vide.
Voir également QInputMethod::reset().
copy() |
Copie le texte sélectionné dans le presse-papiers du système.
Remarque : si le mode écho est défini sur un mode autre que Normal, la copie ne fonctionnera pas. Cela permet d'éviter d'utiliser la copie comme méthode de contournement des fonctions de mot de passe de la commande de ligne.
cut() |
Déplace le texte sélectionné dans le presse-papiers du système.
Remarque : si le mode écho est réglé sur un mode autre que Normal, la fonction couper ne fonctionnera pas. Cela permet d'éviter d'utiliser la coupure comme méthode de contournement des fonctions de mot de passe de la commande de ligne.
deselect() |
Supprime la sélection de texte active.
ensureVisible(int position) |
Fait défiler le contenu de l'entrée de texte de manière à ce que le caractère spécifié position soit visible à l'intérieur des limites de l'entrée de texte.
Voir également autoScroll.
Retourne vrai si le sens de lecture naturel du texte de l'éditeur trouvé entre les positions start et end est de droite à gauche.
moveCursorSelection(int position, SelectionMode mode) |
Déplace le curseur sur position et met à jour la sélection en fonction du paramètre facultatif mode. (Pour ne déplacer que le curseur, définissez la propriété cursorPosition ).
Lorsque cette méthode est appelée, elle place également selectionStart ou selectionEnd (selon la position précédente du curseur) à la position spécifiée. Cela vous permet d'étendre ou de réduire facilement la plage de texte sélectionnée.
Le mode de sélection indique si la sélection est mise à jour par caractère ou par mot. S'il n'est pas spécifié, le mode de sélection sera par défaut TextInput.SelectCharacters.
| Constante | Description |
|---|---|
TextInput.SelectCharacters | Place selectionStart ou selectionEnd (selon la position précédente du curseur) à la position spécifiée. |
TextInput.SelectWords | Définit selectionStart et selectionEnd pour inclure tous les mots entre la position spécifiée et la position précédente du curseur. Les mots partiellement compris dans la plage sont inclus. |
Prenons par exemple cette séquence d'appels :
cursorPosition = 5 moveCursorSelection(9, TextInput.SelectCharacters) moveCursorSelection(7, TextInput.SelectCharacters)
Ceci déplace le curseur à la position 5, étend l'extrémité de la sélection de 5 à 9, puis rétracte l'extrémité de la sélection de 9 à 7, en laissant le texte des positions 5 à 7 sélectionné (les 6e et 7e caractères).
La même séquence avec TextInput.SelectWords étendra le début de la sélection à une limite de mot avant ou sur la position 5 et étendra la fin de la sélection à une limite de mot sur ou après la position 9.
paste() |
Remplace le texte sélectionné par le contenu du presse-papiers du système.
Cette fonction renvoie la position du caractère à x et y pixels du coin supérieur gauche de l'entrée texte. La position 0 est avant le premier caractère, la position 1 est après le premier caractère mais avant le deuxième, et ainsi de suite jusqu'à la position text.length, qui est après tous les caractères.
Cela signifie que pour toutes les valeurs x avant le premier caractère, cette fonction renvoie 0, et pour toutes les valeurs x après le dernier caractère, cette fonction renvoie text.length. Si la valeur y est au-dessus du texte, la position sera celle du caractère le plus proche sur la première ligne et si elle est en dessous du texte, la position du caractère le plus proche sur la dernière ligne sera renvoyée.
Le paramètre curseur position spécifie comment la position du curseur doit être résolue :
| Constante | Description |
|---|---|
TextInput.CursorBetweenCharacters | Renvoie la position entre les caractères la plus proche de x. Il s'agit de la valeur par défaut. |
TextInput.CursorOnCharacter | Renvoie la position avant le caractère la plus proche de x. |
Cette fonction prend la position d'un caractère pos et renvoie le rectangle qu'occuperait le curseur s'il était placé à cette position.
Cette fonction est similaire à la définition de cursorPosition, puis à l'interrogation du rectangle du curseur, mais cursorPosition n'est pas modifié.
redo() |
Refait la dernière opération si l'option redo est activée available.
Supprime la section de texte qui se trouve entre les positions start et end de la page TextInput.
Sélectionne le texte compris entre start et end.
Si le début ou la fin est en dehors de la plage, la sélection n'est pas modifiée.
Après l'appel de cette méthode, selectionStart devient le plus petit et selectionEnd le plus grand (quel que soit l'ordre transmis à cette méthode).
Voir également selectionStart et selectionEnd.
selectAll() |
Sélectionne tout le texte.
selectWord() |
Sélectionne le mot le plus proche de la position actuelle du curseur.
undo() |
Annule la dernière opération si l'option undo se trouve à l'adresse available. Désélectionne toute sélection en cours et met à jour le début de la sélection à la position actuelle du curseur.
© 2025 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.