Créez une interface graphique Qt pour vos scripts Python

Par Jean-François GAZET le 30 mars 2016

Un script Python en ligne de commande c’est bien, mais la majorité des utilisateurs préfèrent utiliser une belle fenêtre avec des cases à cocher et des boutons.

Tkinter est la bibliothèque graphique d’origine pour Python. Il existe aussi Qt, un framework multiplateforme. Le logiciel Qt Designer permet de créer des interfaces graphiques dans un environnement convivial. Il suffit de glisser-déposer les composants.

Installation

Linux

Téléchargez et installez la version Open Source de Qt sur le site officiel.

Installez PyQt5, le module libre liant le langage Python avec la bibliothèque Qt :

sudo apt-get install python3-pyqt5

Installez l’utilitaire pyuic5 qui permet de convertir une interface graphique en code Python :

sudo apt-get install pyqt5-dev-tools

Python 3 est normalement installé par défaut.

Windows

Téléchargez et installez :

Création de l’interface

Démarrez Qt Creator.

Cliquez sur Nouveau projet, choisissez Application Qt avec widgets puis kit Desktop pour une application “ordinateur de bureau”. Laissez les autres paramètres par défaut.

On va ignorer le code C++ généré automatiquement. Ce qui nous intéresse c’est le fichier mainwindow.ui. Pour information, il s’agit d’un fichier XML décrivant la fenêtre et ses composants. Double-cliquez dessus pour passer en mode Design :

Créons une fenêtre avec une liste d’éléments (QListWidget) et un bouton :

Il est possible d’avoir un aperçu du résultat en cliquant sur le bouton suivant en bas à gauche :

En ligne de commande, placez-vous dans le dossier du projet et tapez :

pyuic5 mainwindow.ui -x -o gui.py

Vous disposez maintenant d’un script Python nommé gui.py contenant tout le code nécessaire pour exécuter l’interface graphique. Vous pouvez le visualiser par curiosité, mais il est inutile de le modifier, car vous l’écraserez avec la commande précédente à chaque mise à jour de l’interface.

Le script est exécutable et affiche la fenêtre :

python3 gui.py

Nous donne :

Mais le bouton ne fonctionne pas et la liste est vide ! Et oui, c’est à vous de coder les actions que vous souhaitez effectuer sur ces objets.

Voici un script qui utilise cette fenêtre, remplit la liste avec des chiffres et définit des évènements lorsqu’on clique sur les composants. Nommez-le comme vous voudrez :

#!/usr/bin/python3
# -*- coding: utf-8 -*-

from PyQt5 import QtWidgets
import gui  # import du fichier gui.py généré par pyuic5

class MyWindow(QtWidgets.QMainWindow):

    def __init__(self, parent=None):
        QtWidgets.QMainWindow.__init__(self, parent)
        self.ui = gui.Ui_MainWindow()
        self.ui.setupUi(self)
        
        # un clic sur le bouton appellera la méthode 'action_bouton'
        self.ui.pushButton.clicked.connect(self.action_bouton)

        # on rempli la liste avec des chiffres
        for i in range(20):
            self.ui.listWidget.addItem(str(i))

        # un clic sur un élément de la liste appellera la méthode 'on_item_changed'
        self.ui.listWidget.currentItemChanged.connect(self.on_item_changed)

        # on affiche un texte en bas de la fenêtre (status bar)
        self.ui.statusBar.showMessage("coucou")
    
    def action_bouton(self):
        print('Appui bouton.')

    def on_item_changed(self):
        print(self.ui.listWidget.currentItem().text())

if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec_())

Vous pouvez faire évoluer votre fenêtre dans Qt Creator, ajouter des éléments, modifier leur taille… et recommencer les étapes ci-dessus.


Partagez cet article


A lire également Tous les articles