1. Description du contrôle QLineEdit PyQt5
Le contrôle QLineEdit de PyQt5 est un widget d'interface utilisateur qui permet à l'utilisateur de saisir et d'éditer du texte. Ce contrôle est très flexible et peut être utilisé pour une variété d'applications, notamment pour la saisie de noms d'utilisateurs, de mots de passe, de requêtes de recherche, etc.
Le contrôle QLineEdit est capable de traiter plusieurs types d'entrées de l'utilisateur, tels que le texte brut, les numéros, les dates et les heures. Il peut également être configuré pour afficher du texte masqué, tel que des mots de passe, ou pour limiter la longueur du texte entré.
En plus des fonctions de base de saisie et d'édition de texte, le contrôle QLineEdit dispose également de nombreuses autres fonctionnalités, telles que la sélection et la suppression de texte, la recherche de texte, le déplacement du curseur de texte, la correction automatique, l'historique de saisie et bien plus encore.
Le contrôle QLineEdit peut être personnalisé en utilisant des styles CSS, ce qui permet de le faire correspondre visuellement avec le reste de l'interface utilisateur de l'application. Il peut également être étendu pour inclure des fonctionnalités supplémentaires, telles que la validation du texte entré ou la suggestion automatique de texte.
En résumé, le contrôle QLineEdit de PyQt5 est un élément de base très polyvalent de l'interface utilisateur qui peut être utilisé pour une grande variété d'applications de saisie et d'édition de texte. Sa flexibilité et ses nombreuses fonctionnalités en font un choix populaire pour les développeurs d'applications PyQt5.
2. Création d'un contrôle QLineEdit
Pour créer un contrôle QLineEdit, il suffit d'importer et faire une instanciation sur la classe QLineEdit:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
import sys from PyQt5.QtWidgets import QApplication , QWidget, QLineEdit app = QApplication(sys.argv) win = QWidget() win.setWindowTitle("Example of QLineEdit") win.setGeometry(100 , 100 , 400 , 300) # create a QLineEdit qLine = QLineEdit(win) qLine.setGeometry(50, 100 , 200 , 50) win.show() sys.exit(app.exec_()) |
Ce qui affiche à la sortie:
3. Appliquer un style QSS (Qt Style Sheet) à un champ QLineEdit
La classe QLineEdit est dotée de la méthode setStyleSheet() qui permet d'associer un style Qt Style Sheet (QSS)
Example
|
1 |
qLine.setStyleSheet("background: black; color: yellow; font-size:28px;") |
4. QLineEdit selon l'approche objet
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
import sys from PyQt5.QtWidgets import QApplication , QWidget, QLineEdit class MyWindow(QWidget): def __init__(self , win): super().__init__() self.win = win def build(self): self.win.setWindowTitle("QLineEdit Exemple") self.win.setGeometry(100 , 100 , 500 , 300) # create a QLineEdit self.qLine = QLineEdit(self.win) self.qLine.setGeometry(50 , 50 , 250 , 35) if __name__ == '__main__': app = QApplication(sys.argv) root = QWidget() mywin = MyWindow(root) mywin.build() root.show() sys.exit(app.exec_()) |
5. Manipulation d'un contrôle QLineEdit
Nous allons voir dans ce paragraphe, comment manipuler un contrôle de QLineEdit: comment saisir un texte et récuperer le contenu du contrôle QLineEdit etc. A titre d'exemple nous allons créer une petite application qui demande à l'utilisateur de saisir son nom et lui afficher un message de bienvenue suivie de son nom comme le montre la figure ci-dessous:
Code de l'application
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
import sys from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QPushButton # define the button action def action(): name = qlineName.text() lblResult.setText("Hello : " + name) app = QApplication(sys.argv) widget = QWidget() widget.setGeometry(50,50,320,200) widget.setWindowTitle("Example of QLineEdit App") widget.setGeometry(100 , 100 , 500 , 300) # Label to prompt user to enter his name lblName = QLabel(widget) lblName.setText("Enter Your Name : ") lblName.setGeometry(50 , 100 , 150 , 30) lblName.setStyleSheet("font-size: 14px;") # QLineEdit to enter name qlineName = QLineEdit (widget) qlineName.setGeometry(175 , 100 , 180 , 30) qlineName.setStyleSheet("font-size: 14px;") # Label to display result lblResult = QLabel(widget) lblResult.setText(".........................................") lblResult.setGeometry(175 , 130 , 180 , 30) lblResult.setStyleSheet("font-size: 14px;") # QPushButton to validate operation qbtn = QPushButton(widget) qbtn.setText("Validate") qbtn.clicked.connect(action) qbtn.setGeometry(175 , 170 , 180 , 30) widget.show() sys.exit(app.exec_()) |
Code de l'application selon l'approche objet
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
import sys from PyQt5.QtWidgets import QApplication, QWidget , QLabel, QLineEdit, QPushButton class QLineApp: def action(self): name = self.qlineName.text() self.lblResult.setText("Hello : " + name) def __init__(self , win): super().__init__() self.win = win def build(self): self.win.setWindowTitle("Example of QLineEdit App") self.win.setGeometry(100 , 100 , 500 , 300) # Label to prompt user to enter his name self.lblName = QLabel(self.win) self.lblName.setText("Enter Your Name : ") self.lblName.setGeometry(50 , 100 , 150 , 30) self.lblName.setStyleSheet("font-size: 14px;") # QLineEdit to enter name self.qlineName = QLineEdit (self.win) self.qlineName.setGeometry(175 , 100 , 180 , 30) self.qlineName.setStyleSheet("font-size: 14px;") # Label to display result self.lblResult = QLabel(self.win) self.lblResult.setText(".........................................") self.lblResult.setGeometry(175 , 130 , 180 , 30) self.lblResult.setStyleSheet("font-size: 14px;") # QPushButton to validate operation self.qbtn = QPushButton(self.win) self.qbtn.setText("Validate") self.qbtn.clicked.connect(self.action) self.qbtn.setGeometry(175 , 170 , 180 , 30) if __name__ == '__main__': app = QApplication(sys.argv) root = QWidget() qlineApp = QLineApp(root) qlineApp.build() root.show() sys.exit(app.exec_()) |
6. Liste des méthodes associées au contrôle QLineEdit
Voici une liste non exhaustive des principales méthodes associées au contrôle QLineEdit:
- alignment() : retourne l'alignement actuel du texte dans le champ de texte QLineEdit.
- backspace() : supprime le caractère précédent du curseur de texte.
- clear() : efface le contenu du champ de texte QLineEdit.
- copy() : copie le texte sélectionné dans le champ de texte QLineEdit.
- cursorBackward(bool mark, int steps=1) : déplace le curseur de texte d'un certain nombre de caractères vers l'arrière.
- cursorForward(bool mark, int steps=1) : déplace le curseur de texte d'un certain nombre de caractères vers l'avant.
- cursorPosition() : retourne la position actuelle du curseur de texte dans le champ de texte QLineEdit.
- cut() : coupe le texte sélectionné dans le champ de texte QLineEdit.
- del_() : supprime le caractère suivant du curseur de texte.
- deselect() : annule la sélection de texte dans le champ de texte QLineEdit.
- displayText() : retourne le texte affiché dans le champ de texte QLineEdit, après l'avoir éventuellement modifié selon les règles de la police et de la mise en page.
- echoMode() : retourne le mode d'affichage du texte entré dans le champ de texte QLineEdit.
- hasSelectedText() : retourne True si une partie du texte dans le champ de texte QLineEdit est sélectionné, False sinon.
- home(bool mark) : déplace le curseur de texte au début du champ de texte QLineEdit.
- inputMask() : retourne le masque d'entrée actuellement défini sur le champ de texte QLineEdit.
- insert(QString) : insère le texte spécifié dans le champ de texte QLineEdit à la position actuelle du curseur de texte.
- isReadOnly() : retourne True si le champ de texte QLineEdit est en lecture seule, False sinon.
- maxLength() : retourne le nombre maximal de caractères qui peuvent être entrés dans le champ de texte QLineEdit.
- paste() : colle le texte du presse-papiers dans le champ de texte QLineEdit.
- selectAll() : sélectionne tout le texte dans le champ de texte QLineEdit.
- selectedText() : retourne le texte actuellement sélectionné dans le champ de texte QLineEdit.
- selectionStart() : retourne la position de début de la sélection de texte actuelle dans le champ de texte QLineEdit.
- setAlignment(Qt.Alignment) : définit l'alignement du texte dans le champ de texte QLineEdit.
- setClearButtonEnabled(bool) : active ou désactive le bouton de suppression de texte dans le champ de texte QLineEdit.
- setCursorMoveStyle(Qt.CursorMoveStyle) : définit le style de déplacement du curseur de texte dans le champ de texte QLineEdit.
- setCursorPosition(int) : définit la position du curseur de texte dans le champ de texte QLineEdit.
- setDragEnabled(bool) : active ou désactive la possibilité de faire glisser le texte dans le champ de texte QLineEdit.
- setEchoMode(QLineEdit.EchoMode) : définit le mode d'affichage du texte entré dans le champ de texte QLineEdit.
- setFrame(bool) : active ou désactive le cadre entourant le champ de texte QLineEdit.
- setInputMask(QString) : définit un masque d'entrée pour le champ de texte QLineEdit.
- setMaxLength(int) : définit le nombre maximal de caractères qui peuvent être entrés dans le champ de texte QLineEdit.
- setPlaceholderText(QString) : définit un texte d'invite à afficher dans le champ de texte QLineEdit lorsque celui-ci est vide.
- setReadOnly(bool) : définit si le champ de texte QLineEdit est en lecture seule ou non.
- setSelection(int, int) : définit une sélection de texte dans le champ de texte QLineEdit, en spécifiant la position de début et la longueur de la sélection.
- setText(QString) : définit le texte affiché dans le champ de texte QLineEdit.
- setTextMargins(int left, int top, int right, int bottom) : définit les marges de texte pour le champ de texte QLineEdit.
- setValidator(QValidator) : définit un validateur pour le champ de texte QLineEdit.
- text() : retourne le texte entré dans le champ de texte QLineEdit.
- textMargins() : retourne les marges de texte actuellement définies pour le champ de texte QLineEdit.
- undo() : annule la dernière opération de modification de texte dans le champ de texte QLineEdit.
- validator() : retourne le validateur actuellement défini pour le champ de texte QLineEdit.
Younes Derfoufi
CRMEF OUJDA
