1. Controls d'ús comú.

1.1. Controls a PySide6

Els controls són els elements bàsics i principals per crear interfícies d'usuari a Qt. Podeu mostrar informació, rebre informació de l'usuari i contenir altres controls de forma agrupada. Un control que no està incrustat en un control pare es mostra en forma de finestra independent.

Vegem la implementació de “Hola Món!” amb PySide6.

Exemple

Python
# Importem les classes QApplication, QLabel i QWidget
# del mòdul QtWidgets del paquet PySide6
from PySide6.QtWidgets import QApplication, QLabel, QWidget

class Finestra(QWidget):
    '''
    Classe Finestra, hereta de QWidget, component base.
    '''

    # Constructor de la classe Finestra
    def __init__(self):
        # Crida al constructor de la superclasse
        super().__init__()
        # Assignem el títol de la finestra
        self.setWindowTitle("finestra")
        # Creem una etiqueta amb la finestra com a parent.
        self.etiqueta1 = QLabel("Hola món!", self)

if __name__ == "__main__":
    # Cada aplicació serà una sola instància de QApplication.
    app = QApplication([])
    # Creem un objecte Finestra.
    finestra1 = Finestra()
    # Mostrem la Finestra, per defecte els controls estan ocults.
    finestra1.show()
    # Iniciem el bucle d'esdeveniments.
    app.exec()

L'aspecte que presenta en executar-lo en un escriptori Kde és el d'una finestra com la següent:

Finestra

Dins la finestra estarà continguda tota la interfície de l'usuari. En aquest cas, només conté un component QLabel sense interacció possible, ja que és una etiqueta que mostra un text.

Cada aplicació gràfica tindrà almenys una finestra, però en podrà tenir més. Això ho veurem en seccions posteriors de la unitat. Normalment una aplicació acabarà en tancar la darrera de les finestres.

Algunes coses que cal tenir en compte del codi:

En aquest cas heretem de la classe QWidget per crear la nostra pròpia finestra. super() es refereix a la classe de què s'hereta.
Els controls estan ocults per defecte. Si els passem el parent en la seua creació es mostraran en mostrar el parent. En cas contrari els podem mostrar amb el mètode show, però es mostraran com una finestra independent.
Per accedir o canviar les propietats dels widgets ho fem a través dels seus mètodes públics. Els mètodes d'assignació de valors a propietats, setters, comencen per set seguit del nom de la propietat que volem assignar (setText, setAlignement, setSizePolicy, ...), mentre que els de lectura de valors, getters, solen començar pel nom de la propietat a llegir (text, alignement, sizePolicy, ...).

1.2. Esdeveniments

Cada interacció de l'usuari amb la interfície, per exemple un clic de ratolí, un doble clic, l'ús d'una tecla, etc. generarà un esdeveniment. Aquest esdeveniment serà afegit a la cua d'esdeveniments (event queue) per ser gestionat.

El bucle d'esdeveniments (event loop), que és un bucle infinit, comprovarà a cada iteració si hi ha esdeveniments pendents de ser gestionats. En cas de ser així, l'esdeveniment serà gestionat pel gestor d'esdeveniments (event handler) que executarà el vostre manejador. Quan aquest acaba, el control torna al bucle d'esdeveniments per esperar més esdeveniments.

El bucle d'esdeveniments estarà gestionat per l'objecte QApplication i es llançarà en executar el mètode exec(). En fer clic sobre l'aspa, gestionarà l'esdeveniment de tancar, de manera que la finestra es tancarà i l'aplicació acabarà.

1.3. Senyals i ranures

A l'aplicació de l'exemple anterior, en produir-se un esdeveniment sobre l'etiqueta, l'aplicació no executava cap funcionalitat associada a aquest esdeveniment. Necessitem connectar els esdeveniments a alguna funcionalitat concreta. A Qt, això s'implementa mitjançant senyals i ranures (són l'equivalent a on_click, on_change... en Flet)

Signals

Un senyal (signal) a Qt s'emet quan l'usuari produeix un esdeveniment.

Slots

Les ranures (slots) són escoltadors de senyals que s'executaran en llançar-se l'emissió del senyal al qual estan connectats.

Exemple

Python
'''
"Exemple de signal-slot"
'''
from PySide6.QtWidgets import QApplication, QPushButton, QMainWindow

class FinestraPrincipal(QMainWindow):
    '''
    Classe FinestraPrincipal, hereta de QMainWindow.
    El QMainWindow és un component pensat per ser
    la finestra principal d'una aplicació.
    '''

    def __init__(self):
        super().__init__()
        self.setWindowTitle("finestra")
        self.boton1 = QPushButton("Fes clic!", self)
        # Configurem el botó com a element principal de la finestra.
        # Això és perquè estem usant un QMainWindow. No calia
        # passar-li el parent en la seua creació.
        self.setCentralWidget(self.boton1)
        # Connectem l'esdeveniment clic del botó a la ranura clic_de_boton
        self.boton1.clicked.connect(self.clic_de_botó)

    # Definim la ranura que s'executarà amb el clic del botó
    def clic_de_botó(self):
        print("Senyal de clic rebut -> Execució de la ranura")

if __name__ == "__main__":
    app = QApplication([])
    finestra1 = FinestraPrincipal()
    finestra1.show()
    app.exec()

Ara, l'aspecte de l'aplicació serà el mateix, però en fer clic sobre el botó, la consola des de la qual hem llançat l'aplicació mostrarà el text “Senyal de clic rebut -> Execució de la ranura”.

Exemple slot

Slots predefinits

Alguns controls tenen ranures predefinides que podem fer servir directament.

Per exemple, el control QLabel té els següents slots predefinits:

clear
setMovie(movie)
setNum(num)
setPicture(picture)
setPixmap(pixmap)
setText(text)

Com veus, alguns dels slots predefinits esperen rebre algun paràmetre. A la documentació pots veure que algunes senyals s'acompanyen d'alguns valors quan es produeixen, de forma que podem connectar directament senyals i ranures que es passen informació entre ells.

Per exemple:

Python
self.label = QLabel()
self.input = QLineEdit()
self.input.textChanged.connect(self.label.setText)

1.4. Principals controls en formularis

A la primera unitat vam veure un llistat de controls habituals juntament amb el seu ús habitual. Farem un llistat amb els controls més habituals de PySide6 usats en formularis, juntament amb algun dels seus senyals i funcions més útils. Pel nom de les funcions se'n pot deduir l'ús i el comportament. Veurem i practicarem amb exemples de molts d'ells en altres apartats de la unitat. Per obtenir una llista completa i més informació de cadascun, cal consultar la documentació de PySide6.

Widgets