TUTORIAL

PyQt5 Tutorial - Radiobutton

Questo tutorial introduce il widget PyQt5 QRadioButton con esempi: creare pulsanti radio, collegare uno slot al segnale toggled, preselezionare un'opzione e mantenere i gruppi indipendenti.

In questa pagina

Un QRadioButton permette all’utente di scegliere esattamente un’opzione da un insieme, quindi è il widget giusto quando più scelte si escludono a vicenda. Per scelte indipendenti di tipo on/off, usa invece un QCheckBox, perché ogni casella di controllo mantiene il proprio stato. Ogni QRadioButton combina un indicatore rotondo con un’etichetta di testo, e i pulsanti radio che condividono lo stesso widget genitore formano automaticamente un unico gruppo esclusivo: selezionarne uno deseleziona gli altri.

Creare i widget QRadioButton

Passa il testo visibile dell’opzione al costruttore di QRadioButton e aggiungi i pulsanti a un layout come qualsiasi altro widget. Lo script seguente crea una finestra che chiede in quale città vive l’utente, offre New York e Houston e riserva un secondo QLabel per la risposta. Richiede PyQt5 e un display grafico; il controllo importlib.util.find_spec permette al file di terminare correttamente dove PyQt5 non è installato, mentre su un desktop apre la finestra mostrata di seguito.

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

import importlib.util
import sys

if importlib.util.find_spec("PyQt5") is None:
    sys.exit(0)  # PyQt5 is required for the GUI below

from PyQt5.QtWidgets import (
    QApplication,
    QLabel,
    QRadioButton,
    QVBoxLayout,
    QWidget,
)


class basicRadiobuttonExample(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        self.label = QLabel("Which city do you live in?")
        self.rbtn1 = QRadioButton("New York")
        self.rbtn2 = QRadioButton("Houston")
        self.label2 = QLabel("")

        self.rbtn1.toggled.connect(self.onClicked)
        self.rbtn2.toggled.connect(self.onClicked)

        layout = QVBoxLayout()
        layout.addWidget(self.label)
        layout.addWidget(self.rbtn1)
        layout.addWidget(self.rbtn2)
        layout.addWidget(self.label2)

        self.setGeometry(200, 200, 300, 150)

        self.setLayout(layout)
        self.setWindowTitle("PyQt5 Radio Button Example")

        self.show()

    def onClicked(self):
        radioBtn = self.sender()
        if radioBtn.isChecked():
            self.label2.setText("You live in " + radioBtn.text())


if __name__ == "__main__":
    app = QApplication(sys.argv)
    ex = basicRadiobuttonExample()
    sys.exit(app.exec_())

Finestra PyQt5 renderizzata con il titolo “PyQt5 Radio Button Example”, che mostra la domanda “Which city do you live in?”, i pulsanti radio New York e Houston non selezionati e una riga di risultato vuota

La stringa passata al costruttore ("New York", "Houston") diventa il testo disegnato accanto a ciascun indicatore rotondo. self.label pone la domanda, self.label2 inizia come un’etichetta vuota che in seguito riporta la selezione, e QVBoxLayout impila i widget verticalmente nell’ordine in cui vengono aggiunti. setGeometry(200, 200, 300, 150) posiziona e dimensiona la finestra, mentre setWindowTitle() ne imposta il titolo. Poiché il blocco di codice è identico in tutte le lingue, il titolo della finestra e le etichette visibili restano in inglese.

Rispondere al segnale toggled

Un QRadioButton emette il segnale toggled ogni volta che il suo stato di selezione cambia in entrambe le direzioni: una volta con lo stato selezionato quando viene scelto e una volta con lo stato deselezionato per il pulsante che perde la selezione. Collegare entrambi i pulsanti a un unico slot — self.rbtn1.toggled.connect(self.onClicked) e self.rbtn2.toggled.connect(self.onClicked) — è sufficiente per monitorare l’intero gruppo.

Poiché toggled scatta anche per il pulsante deselezionato, lo slot filtra con isChecked() in modo che solo il pulsante appena selezionato aggiorni il risultato. All’interno di onClicked, self.sender() restituisce il widget che ha emesso il segnale, text() legge l’etichetta visibile dell’opzione e self.label2.setText("You live in " + radioBtn.text()) scrive la risposta.

Il segnale toggled trasporta anche il nuovo stato di selezione come valore booleano, quindi uno slot dichiarato come def onClicked(self, checked) può usare quel valore invece di chiamare isChecked(). Controllare isChecked() sul mittente è qui lo schema più semplice, perché rende chiaro quale pulsante ha prodotto il testo.

Interazione nell’esempio di base: la selezione del pulsante radio Houston lo spunta, deseleziona New York e aggiorna l’etichetta del risultato in “You live in Houston”

Impostare una selezione predefinita con setChecked()

Le nuove istanze di QRadioButton partono deselezionate, quindi la finestra si apre senza alcuna opzione selezionata. Per preselezionarne una all’avvio dell’applicazione, chiama setChecked() su quel pulsante: self.rbtn1.setChecked(True).

Modificare lo stato di selezione emette toggled proprio come un clic dell’utente. Se vuoi che la preselezione aggiorni anche i widget dipendenti, come l’etichetta del risultato, chiama setChecked(True) dopo aver collegato il segnale; chiamala prima del collegamento se la selezione iniziale deve rimanere silenziosa.

Creare gruppi indipendenti con QButtonGroup

Tutti i widget QRadioButton con lo stesso genitore appartengono a un unico gruppo implicito, quindi solo uno di essi può essere selezionato alla volta, anche quando i loro segnali toggled sono collegati a slot diversi. Quando una finestra pone più domande indipendenti, racchiudi ogni insieme di opzioni in un QButtonGroup di QtWidgets e registra i pulsanti con addButton(); ogni gruppo ammette così un pulsante selezionato indipendentemente dagli altri. L’esempio seguente chiede sia una città sia uno stato e richiede lo stesso ambiente desktop PyQt5 del primo script:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

import importlib.util
import sys

if importlib.util.find_spec("PyQt5") is None:
    sys.exit(0)  # PyQt5 is required for the GUI below

from PyQt5.QtWidgets import (
    QApplication,
    QButtonGroup,
    QLabel,
    QRadioButton,
    QVBoxLayout,
    QWidget,
)


class basicRadiobuttonExample(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        self.label = QLabel("Which city do you live in?")
        self.rbtn1 = QRadioButton("New York")
        self.rbtn2 = QRadioButton("Houston")
        self.label2 = QLabel("")

        self.label3 = QLabel("Which state do you live in?")
        self.rbtn3 = QRadioButton("New York")
        self.rbtn4 = QRadioButton("Texas")
        self.label4 = QLabel("")

        self.btngroup1 = QButtonGroup()
        self.btngroup2 = QButtonGroup()

        self.btngroup1.addButton(self.rbtn1)
        self.btngroup1.addButton(self.rbtn2)
        self.btngroup2.addButton(self.rbtn3)
        self.btngroup2.addButton(self.rbtn4)

        self.rbtn1.toggled.connect(self.onClickedCity)
        self.rbtn2.toggled.connect(self.onClickedCity)

        self.rbtn3.toggled.connect(self.onClickedState)
        self.rbtn4.toggled.connect(self.onClickedState)

        layout = QVBoxLayout()
        layout.addWidget(self.label)
        layout.addWidget(self.rbtn1)
        layout.addWidget(self.rbtn2)
        layout.addWidget(self.label2)

        layout.addWidget(self.label3)
        layout.addWidget(self.rbtn3)
        layout.addWidget(self.rbtn4)
        layout.addWidget(self.label4)

        self.setGeometry(200, 200, 300, 300)

        self.setLayout(layout)
        self.setWindowTitle("PyQt5 Radio Button Example")

        self.show()

    def onClickedCity(self):
        radioBtn = self.sender()
        if radioBtn.isChecked():
            self.label2.setText("You live in " + radioBtn.text())

    def onClickedState(self):
        radioBtn = self.sender()
        if radioBtn.isChecked():
            self.label4.setText("You live in " + radioBtn.text())


if __name__ == "__main__":
    app = QApplication(sys.argv)
    ex = basicRadiobuttonExample()
    sys.exit(app.exec_())

Finestra PyQt5 renderizzata con due insiemi di opzioni indipendenti: un pulsante radio per la città selezionato sotto “Which city do you live in?” e un pulsante radio per lo stato selezionato sotto “Which state do you live in?”

Il programma crea due istanze di QButtonGroup, self.btngroup1 per i pulsanti della città e self.btngroup2 per i pulsanti dello stato. addButton() registra ogni pulsante radio nel suo gruppo — self.btngroup1.addButton(self.rbtn1) e self.btngroup1.addButton(self.rbtn2) per la coppia di città, self.btngroup2.addButton(self.rbtn3) e self.btngroup2.addButton(self.rbtn4) per la coppia di stati. Senza i gruppi, scegliere Texas deselezionerebbe la città perché tutti e quattro i pulsanti condividono lo stesso genitore; con i gruppi in posizione, ogni domanda conserva il proprio pulsante selezionato e ogni etichetta di risultato si aggiorna in modo indipendente. Anche qui le etichette visibili della finestra restano in inglese, perché il blocco di codice è identico in tutte le lingue.

Una finestra non può dimostrare questa regola in forma testuale, quindi il modello in puro Python che segue riproduce la stessa esclusività: una selezione per gruppo e un secondo gruppo non influenzato dal primo. Esegui questo esempio:

class RadioGroup:
    def __init__(self):
        self.buttons = []
        self.checked = None

    def add(self, label):
        self.buttons.append(label)

    def select(self, label):
        self.checked = label
        return "Selected: " + label


city = RadioGroup()
city.add("New York")
city.add("Houston")

state = RadioGroup()
state.add("New York")
state.add("Texas")

print(city.select("New York"))
print(state.select("Texas"))
print(city.select("Houston"))
print("State group still holds:", state.checked)
Selected: New York
Selected: Texas
Selected: Houston
State group still holds: Texas

QButtonGroup svolge il ruolo del RadioGroup del modello: una nuova selezione sostituisce quella precedente all’interno dello stesso gruppo, mentre l’altro gruppo conserva la propria risposta. Le stringhe stampate dal modello restano in inglese perché il blocco è identico in tutte le lingue.