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:
- Bajo acoplamiento: el objeto que emite la señal no necesita saber qué objeto la recibirá
- Seguridad de tipos: los tipos de parámetros de señales y slots se verifican al momento de la conexión
- Relación de muchos a muchos: una señal puede conectarse a múltiples slots, y un slot puede recibir múltiples señales
- 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
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.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
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
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
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
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
Bloquear señales
Impedir temporalmente que el objeto emita todas las señales:
Ejemplo
# 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:
Qt.AutoConnection(por defecto)Qt.DirectConnectionQt.QueuedConnectionQt.BlockingQueuedConnectionQt.UniqueConnection
Ejemplo
emitter.signal1.connect(receiver.slot1, Qt.QueuedConnection)
Preguntas frecuentes y soluciones
Problema 1: La señal no activa la función slot
Posibles causas:
- La señal y el slot no están conectados correctamente
- El objeto receptor ha sido destruido
- La señal está bloqueada
Solución:
- Verifica que el código de conexión sea correcto
- Asegúrate de que el objeto receptor siga existiendo
- 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:
- Revisa las definiciones de parámetros de la señal y el slot
- Usa decoradores
@pyqtSlotpara especificar explícitamente los tipos de parámetros del slot.
Ejemplo
class MyReceiver:
@pyqtSlot(int)
def slot(self, value):
print(value)
Mejores prácticas
- Nombres claros: asigna nombres descriptivos a las señales y slots
- Parámetros explícitos: especifica explícitamente los tipos de parámetros de las señales y slots
- Gestión de recursos: desconecta a tiempo las conexiones que ya no se necesitan
- Seguridad en hilos: para comunicación entre hilos, usa
QueuedConnection - 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