Aller au contenu

PyQt/QLineEdit

Un livre de Wikilivres.
PyQt
PyQt
PyQt
Introduction
Installation
Concepts de base
Quelques widgets
Utilisation de Qt Designer
Guide de traduction de Qt à PyQt
Annexes
Modifier ce modèle ce sommaire

QLineEdit est un widget représentant une zone d'édition de texte sur une seule ligne. Il permet à l'utilisateur de saisir et modifier du texte avec des fonctions d'édition utiles telles que la possibilité d'annuler et refaire une action, la gestion du copier-coller et du glisser-déposer, ainsi qu'une multitude de raccourcis clavier facilitant l'édition de texte.

Il est possible de transformer la zone de saisie de texte en zone lecture seule grâce à la méthode setReadOnly() ou bien de modifier la manière dont le texte introduit est affiché par un appel à la méthode echoMode() (par exemple ne rien afficher si on demande un mot de passe à l'utilisateur). Ce widget gère aussi les contraintes sur le texte entré, comme par exemple une longueur maximale (méthode maxLength()), ou des contraintes plus générales comme la validation. Elle est mise en place par l'intermédiaire de la méthode setValidator()) (prenant en paramètre un objet de la classe QValidator) ou par l'utilisation d'un masque de saisie avec la méthode setInputMask(). Le texte peut être modifié grâce aux méthodes setText() ou insert(), tandis qu'il peut être récupéré par la méthode text(). Le texte affiché, qui peut être différent du texte entré en fonction du mode d'écho, est quant à lui récupéré grâce à displayText(). Vous pouvez effectuer des sélections sur le contenu avec les méthodes setSelection() et selectAll(), sur lesquelles il est possible d'appliquer les traditionnels couper/copier/coller avec cut(), copy() et paste(). Le texte peut être aligné avec la méthode setAlignment().

Lorsque le texte est modifié par l'utilisateur, le signal textChanged() est émis. Lorsqu'il appuie sur la touche Entrée, c'est returnPressed() qui est émis. Cependant, si une validation du texte est active le signal est émis uniquement si le texte est valide.

Comme expliqué ci-dessus il y a une multitude de raccourcis clavier disponibles sur cette zone de texte. Pour en obtenir la liste, ainsi que tous les détails concernant ce widget, consultez la documentation de référence à l'adresse http://doc.trolltech.com/3.3/qlineedit.html. Un widget relatif à cette zone de saisie est QTextEdit, qui fournit une zone de saisie de texte sur plusieurs lignes et avec des possibilités de mise en page plus importantes. Consultez la section suivante pour obtenir plus d'informations à son sujet.

# Constructeurs pour la classe QLineEdit
QLineEdit ( QWidget parent, str name = "" )
QLineEdit ( QString contents, QWidget parent, str name = "" )
QLineEdit ( QString contents, QString inputMask, QWidget parent, str name = "" )