Mécanisme de signaux et slots de PyQt en Python

Les signaux et slots sont un mécanisme dans PyQt permettant la communication entre objets, et c'est l'une des fonctionnalités principales du framework Qt. Ce mécanisme offre un moyen flexible et sûr au niveau des types pour que différents objets communiquent entre eux sans avoir besoin de connaître leurs implémentations spécifiques.

En termes simples :

  • Signal: une notification émise lorsqu'un événement spécifique se produit
  • Slot: une fonction qui reçoit des signaux et y répond

Pourquoi les signaux et les slots sont-ils nécessaires ?

Dans la programmation GUI traditionnelle, nous utilisons généralement des fonctions de rappel pour gérer les interactions utilisateur. Par rapport aux fonctions de rappel, le mécanisme de signaux et de slots de PyQt présente les avantages suivants :

  1. Couplage faible: L'objet qui envoie le signal n'a pas besoin de savoir quel objet le recevra
  2. Sécurité de type: Les types de paramètres des signaux et des slots sont vérifiés au moment de la connexion
  3. Relation plusieurs-à-plusieurs: Un signal peut se connecter à plusieurs slots, et un slot peut recevoir plusieurs signaux
  4. Sécurité des threads: Prend en charge la communication entre threads

Utilisation de base

Création de signaux

Dans une sous-classe QObject personnalisée, vous pouvez utiliserpyqtSignal()pour définir des signaux :

Exemple

from PyQt5.QtCore import QObject, pyqtSignal

class MyEmitter(QObject):
    # Définir un signal sans paramètres
    signal1 = pyqtSignal()
   
    # Définir un signal avec un paramètre de type chaîne
    signal2 = pyqtSignal(str)
   
    # Définir un signal avec plusieurs paramètres
    signal3 = pyqtSignal(int, str)

Émission de signaux

Après avoir défini un signal, vous pouvez appeler laemit()méthode du signal pour l'émettre :

Exemple

emitter = MyEmitter()
emitter.signal1.emit()           # Émettre un signal sans paramètres
emitter.signal2.emit("Hello")    # Émettre un signal avec un paramètre de type chaîne
emitter.signal3.emit(123, "abc") # Émettre un signal avec plusieurs paramètres

Création de fonctions de slot

Les fonctions de slot peuvent être n'importe quel objet Python appelable, généralement des méthodes d'instance :

Exemple

class MyReceiver:
    def slot1(self):
        print("slot1 appelé")
   
    def slot2(self, text):
        print(f"slot2 appelé avec : {text}")
   
    def slot3(self, number, text):
        print(f"slot3 appelé avec : {number}, {text}")

Connexion des signaux et des slots

Utilisezconnect()la méthode du signal pour connecter le signal à un slot :

Exemple

emitter = MyEmitter()
receiver = MyReceiver()

# Connecter le signal au slot
emitter.signal1.connect(receiver.slot1)
emitter.signal2.connect(receiver.slot2)
emitter.signal3.connect(receiver.slot3)

Exemples d'applications pratiques

Exemple 1 : Événement de clic sur un bouton

Exemple

from PyQt5.QtWidgets import QApplication, QPushButton, QVBoxLayout, QWidget

def on_button_clicked():
    print("Le bouton a été cliqué !")

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

button = QPushButton("Cliquez-moi")
button.clicked.connect(on_button_clicked)  # Connecter le signal au slot

layout.addWidget(button)
window.setLayout(layout)
window.show()

app.exec_()

Exemple 2 : Signal personnalisé

Exemple

from PyQt5.QtCore import QObject, pyqtSignal

class Worker(QObject):
    progressChanged = pyqtSignal(int)  # Définir un signal avec un paramètre int
   
    def do_work(self):
        for i in range(101):
            self.progressChanged.emit(i)  # Émettre le signal

class Window(QWidget):
    def __init__(self):
        super().__init__()
        self.worker = Worker()
        self.worker.progressChanged.connect(self.update_progress)
       
    def update_progress(self, value):
        print(f"Progression: {value}%")

window = Window()
window.worker.do_work()

Utilisation avancée

Déconnexion

Utilisez ladisconnect()méthode pour déconnecter un signal d'un slot :

Exemple

emitter.signal1.disconnect(receiver.slot1)

Blocage des signaux

Bloquer temporairement l'émission de tous les signaux par l'objet :

Exemple

emitter.blockSignals(True)  # Bloquer les signaux
# Les signaux émis ici ne seront pas délivrés
emitter.blockSignals(False) # Débloquer les signaux

Types de connexion pour les signaux et les slots

PyQt prend en charge plusieurs types de connexion, spécifiés viaQt.ConnectionType:

  1. Qt.AutoConnection(par défaut)
  2. Qt.DirectConnection
  3. Qt.QueuedConnection
  4. Qt.BlockingQueuedConnection
  5. Qt.UniqueConnection

Exemple

from PyQt5.QtCore import Qt

emitter.signal1.connect(receiver.slot1, Qt.QueuedConnection)

Problèmes courants et solutions

Problème 1 : Le signal ne déclenche pas la fonction de slot

Causes possibles:

  1. Le signal et le slot ne sont pas correctement connectés
  2. L'objet récepteur a été détruit
  3. Le signal est bloqué

Solutions:

  1. Vérifiez si le code de connexion est correct
  2. Assurez-vous que l'objet récepteur existe toujours
  3. Recherchez du code qui bloque les signaux

Problème 2 : Incompatibilité de type de paramètre

Causes possibles: Les types de paramètres ou le nombre de paramètres du signal et du slot ne correspondent pas

Solutions:

  1. Vérifiez les définitions des paramètres du signal et du slot
  2. Utilisez le décorateur@pyqtSlotpour spécifier explicitement les types de paramètres du slot

Exemple

from PyQt5.QtCore import pyqtSlot

class MyReceiver:
    @pyqtSlot(int)
    def slot(self, value):
        print(value)

Bonnes pratiques

  1. Nommage clair: Donnez des noms descriptifs aux signaux et aux slots
  2. Paramètres explicites: Spécifiez explicitement les types de paramètres des signaux et des slots
  3. Gestion des ressources: Déconnectez en temps voulu les connexions qui ne sont plus nécessaires
  4. Sécurité des threads: Utilisez pour la communication entre threadsQueuedConnection
  5. Documentation complète: Ajoutez des docstrings pour les signaux et les slots personnalisés

Le mécanisme de signaux et de slots est au cœur de la programmation PyQt. Le maîtriser améliorera grandement l'efficacité et la qualité de votre développement d'applications GUI. En pratiquant ces exemples et en suivant les bonnes pratiques, vous serez en mesure de créer des applications PyQt réactives et bien structurées.

Autres extensions