Mecanismo de señales y slots de Python PyQt

Las señales y slots (Signals and Slots) son un mecanismo en PyQt para la comunicación entre objetos, y son una de las características principales del marco Qt. Este mecanismo proporciona una forma flexible y de seguridad de tipos que permite que diferentes objetos se comuniquen entre sí sin necesidad de conocer la implementación específica de los demás.

En pocas palabras:

  • Señal (Signal): notificación emitida cuando ocurre un evento específico
  • Ranura (Slot): función que recibe la señal y responde a ella

¿Por qué se necesitan señales y slots?

En la programación tradicional de GUI, normalmente usamos funciones de devolución de llamada (callbacks) para manejar la interacción del usuario. El mecanismo de señales y slots de PyQt tiene las siguientes ventajas en comparación con las funciones de devolución de llamada:

  1. Bajo acoplamiento: el objeto que emite la señal no necesita saber qué objeto la recibirá
  2. Seguridad de tipos: los tipos de parámetros de señales y slots se verifican al momento de la conexión
  3. Relación de muchos a muchos: una señal puede conectarse a múltiples slots, y un slot puede recibir múltiples señales
  4. Seguridad en hilos: admite comunicación entre hilos

Uso básico

Crear señales

En una subclase personalizada de QObject, se puede usarpyqtSignal()para definir señales:

Ejemplo

from PyQt5.QtCore import QObject, pyqtSignal

class MyEmitter(QObject):
    # Definir una señal sin parámetros
    signal1 = pyqtSignal()
   
    # Definir una señal con un parámetro de cadena
    signal2 = pyqtSignal(str)
   
    # Definir una señal con múltiples parámetros
    signal3 = pyqtSignal(int, str)

Emitir señales

Después de definir la señal, se puede invocar elemit()método para emitirla:

Ejemplo

emitter = MyEmitter()
emitter.signal1.emit()           # Emitir una señal sin parámetros
emitter.signal2.emit("Hello")    # Emitir una señal con un parámetro de cadena
emitter.signal3.emit(123, "abc") # Emitir una señal con múltiples parámetros

Crear funciones slot

Las funciones slot pueden ser cualquier objeto invocable de Python, normalmente métodos de instancia:

Ejemplo

class MyReceiver:
    def slot1(self):
        print("slot1 called")
   
    def slot2(self, text):
        print(f"slot2 called with: {text}")
   
    def slot3(self, number, text):
        print(f"slot3 called with: {number}, {text}")

Conectar señales y slots

Al usar elconnect()método para conectar la señal al slot:

Ejemplo

emitter = MyEmitter()
receiver = MyReceiver()

# Conectar la señal y el slot
emitter.signal1.connect(receiver.slot1)
emitter.signal2.connect(receiver.slot2)
emitter.signal3.connect(receiver.slot3)

Ejemplos de aplicación práctica

Ejemplo 1: Evento de clic de botón

Ejemplo

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

def on_button_clicked():
    print("Button was clicked!")

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

button = QPushButton("Click Me")
button.clicked.connect(on_button_clicked)  # Conectar la señal y el slot

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

app.exec_()

Ejemplo 2: Señal personalizada

Ejemplo

from PyQt5.QtCore import QObject, pyqtSignal

class Worker(QObject):
    progressChanged = pyqtSignal(int)  # Definir una señal con un parámetro de tipo int
   
    def do_work(self):
        for i in range(101):
            self.progressChanged.emit(i)  # Emitir la señal

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"Progress: {value}%")

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

Uso avanzado

Desconexión

Usandodisconnect()el método, se puede desconectar la conexión entre la señal y el slot:

Ejemplo

emitter.signal1.disconnect(receiver.slot1)

Bloquear señales

Impedir temporalmente que el objeto emita todas las señales:

Ejemplo

emitter.blockSignals(True)  # Bloquear señales
# La señal emitida aquí no será transmitida
emitter.blockSignals(False) # Desbloquear

Tipos de conexión de señales y slots

PyQt admite varios tipos de conexión, a través deQt.ConnectionTypese especifican:

  1. Qt.AutoConnection(por defecto)
  2. Qt.DirectConnection
  3. Qt.QueuedConnection
  4. Qt.BlockingQueuedConnection
  5. Qt.UniqueConnection

Ejemplo

from PyQt5.QtCore import Qt

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

Preguntas frecuentes y soluciones

Problema 1: La señal no activa la función slot

Posibles causas:

  1. La señal y el slot no están conectados correctamente
  2. El objeto receptor ha sido destruido
  3. La señal está bloqueada

Solución:

  1. Verifica que el código de conexión sea correcto
  2. Asegúrate de que el objeto receptor siga existiendo
  3. Verifica si hay código que bloquee la señal

Problema 2: Los tipos de parámetros no coinciden

Posibles causas: el tipo o la cantidad de parámetros de la señal y el slot no coinciden

Solución:

  1. Revisa las definiciones de parámetros de la señal y el slot
  2. Usa decoradores@pyqtSlotpara especificar explícitamente los tipos de parámetros del slot.

Ejemplo

from PyQt5.QtCore import pyqtSlot

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

Mejores prácticas

  1. Nombres claros: asigna nombres descriptivos a las señales y slots
  2. Parámetros explícitos: especifica explícitamente los tipos de parámetros de las señales y slots
  3. Gestión de recursos: desconecta a tiempo las conexiones que ya no se necesitan
  4. Seguridad en hilos: para comunicación entre hilos, usaQueuedConnection
  5. Documentación completa: agrega cadenas de documentación (docstrings) a las señales y slots personalizados

El mecanismo de señales y slots es el núcleo de la programación en PyQt; dominarlo mejorará en gran medida la eficiencia y la calidad de tus aplicaciones GUI. Al practicar estos ejemplos y seguir las mejores prácticas, podrás construir aplicaciones PyQt receptivas y con una estructura clara.

Otras extensiones