Primers passos amb Qt (II)

El disseny: un layout vertical amb tres coses

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0">
 <class>Previsio</class>
 <widget class="QWidget" name="Previsio">
  <layout class="QVBoxLayout" name="verticalLayout">
   <item>
    <widget class="QLabel" name="lbText">
     <property name="font"><font><pointsize>24</pointsize></font></property>
     <property name="text"><string>Prem el botó</string></property>
     <property name="alignment"><set>Qt::AlignCenter</set></property>
    </widget>
   </item>
   <item>
    <widget class="QCheckBox" name="cbIcona">
     <property name="text"><string>Icona</string></property>
     <property name="checked"><bool>true</bool></property>
    </widget>
   </item>
   <item>
    <layout class="QHBoxLayout" name="horizontalLayout">
     <item><spacer name="horizontalSpacer"><property name="orientation"><enum>Qt::Horizontal</enum></property></spacer></item>
     <item><widget class="QPushButton" name="btNova"><property name="text"><string>Nova previsió</string></property></widget></item>
     <item><spacer name="horizontalSpacer_2"><property name="orientation"><enum>Qt::Horizontal</enum></property></spacer></item>
    </layout>
   </item>
  </layout>
 </widget>
 <resources/>
 <connections/>
</ui>

• Un QVBoxLayout conté, de dalt a baix: l'etiqueta lbText, la casella cbIcona i una fila horitzontal.
• La fila és un QHBoxLayout amb spacer — botó — spacer: els dos espais elàstics centren el botó. És l'estructura que es veu a l'arbre d'objectes de l'enunciat (ex01).
• Els objectName importen: són els noms de ui->lbText i dels slots on_btNova_clicked. Al constructor, setWindowTitle(...) posa el títol de la finestra.

Un número aleatori

void Previsio::on_btNova_clicked()
{
    int graus;

    graus = QRandomGenerator::global()->bounded(-5, 36);
    ui->lbText->setText(QString("%1 °C").arg(graus));
}

• QRandomGenerator::global()->bounded(a, b) dona un enter de a fins a b - 1: el límit superior no s'inclou. Per a un dau, bounded(1, 7). No cal sembrar-lo.
• QString("%1 °C").arg(graus): %1 és un forat que arg omple amb el número. Amb %1 i %2 i .arg(a).arg(b) se'n poden posar diversos.
• setText escriu el text a l'etiqueta.
• Les captures de codi de l'enunciat fan servir qsrand(), qrand() i trUtf8(), que no existeixen a Qt 6: no compilen. Al pas a pas «Número aleatori» i a «Troba l'error» ho pots veure.

Una llista de noms

    m_noms << "sol" << "núvol" << "pluja" << "neu";

void Previsio::on_btNova_clicked()
{
    int i;

    i = QRandomGenerator::global()->bounded(0, m_noms.size());
    ui->lbText->setText(m_noms.at(i));
}

• QStringList és una llista de cadenes; << hi afegeix elements i at(i) en llegeix un. Els índexs comencen a 0.
• El generador dona l'índex, no el valor: bounded(0, m_noms.size()) és 0, 1, 2 o 3 (size() és 4 i no s'inclou).
• Guarda la llista com a atribut de la classe (m_noms) i omple-la al constructor, una sola vegada.

Tres passos

1. Un fitxer .qrc (al Creator, Add New ▸ Qt ▸ Qt Resource File) que llista les imatges. El prefix i el nom formen la ruta: :/img + icones/sol.png.

   <RCC>
       <qresource prefix="/img">
           <file>icones/sol.png</file>
           <file>icones/nuvol.png</file>
           <file>icones/pluja.png</file>
           <file>icones/neu.png</file>
       </qresource>
   </RCC>

2. Activar rcc al CMakeLists.txt. qt_standard_project_setup() només activa AUTOMOC i AUTOUIC; falta AUTORCC i el .qrc ha d'estar a qt_add_executable:

   qt_standard_project_setup()
   
   set(CMAKE_AUTORCC ON)      # sense això, el .qrc no es converteix en codi
   
   qt_add_executable(previsio
       main.cpp
       previsio.cpp
       previsio.h
       previsio.ui
       icones.qrc             # el fitxer de recursos, llistat com un altre fitxer
   )

3. Carregar-les amb QPixmap i una ruta que comença per :/, i posar-les a l'etiqueta amb setPixmap:

       m_icones << QPixmap(":/img/icones/sol.png")
                << QPixmap(":/img/icones/nuvol.png")
                << QPixmap(":/img/icones/pluja.png")
                << QPixmap(":/img/icones/neu.png");
   
   void Previsio::on_btNova_clicked()
   {
       int i;
   
       i = QRandomGenerator::global()->bounded(0, m_icones.size());
       ui->lbText->setPixmap(m_icones.at(i));
   }

• Un QPixmap és un valor lleuger (comparteix internament les dades): es guarda en un QList<QPixmap> sense new ni delete.
• setPixmap substitueix el text de l'etiqueta, i setText substitueix la imatge: no cal esborrar res abans.
• Sense AUTORCC el programa compila, s'executa i l'etiqueta queda en blanc, sense cap missatge. Prova-ho al pas a pas «Imatge i recursos».

Dos valors i una funció

void Previsio::on_btNova_clicked()
{
    novaPrevisio();
}

void Previsio::on_cbIcona_toggled(bool activa)
{
    m_icona = activa;
    mostra();
}

void Previsio::novaPrevisio()
{
    m_index = QRandomGenerator::global()->bounded(0, m_noms.size());
    mostra();
}

void Previsio::mostra()
{
    if (m_icona)
        ui->lbText->setPixmap(m_icones.at(m_index));
    else
        ui->lbText->setText(m_noms.at(m_index));
}

• L'estat de la finestra són dos valors: m_index (l'últim sorteig) i m_icona (la casella). No hi ha res més.
• mostra() és l'única funció que escriu a l'etiqueta. El botó canvia m_index i crida mostra(); la casella canvia m_icona i crida mostra(). Així, en tornar a marcar la casella, hi surt la imatge del darrer sorteig, sense cap codi extra.
• Els slots són funcions privades (private slots:) amb el nom on_<objectName>_<senyal>, com sempre.

Quin senyal de la casella?

Aquests exemples fan servir toggled(bool) perquè és el més simple (bool activa) i va a totes les versions. Si el Creator et genera on_cbIcona_checkStateChanged(Qt::CheckState estat), és equivalent: m_icona = (estat == Qt::Checked);. Però en un kit anterior a la 6.7 aquest nom no es connectaria (mira «Si surt un error»).

keyPressEvent

void Previsio::keyPressEvent(QKeyEvent *event)
{
    if (event->key() == Qt::Key_Plus)
        ui->btNova->setVisible(true);
    else if (event->key() == Qt::Key_Minus)
        ui->btNova->setVisible(false);
    else
        QWidget::keyPressEvent(event);
}

• Es declara a protected: amb override, i cal #include <QKeyEvent>. Escrit exactament així: qualsevol errada al nom i override ho diu.
• event->key() és un codi (Qt::Key_Plus, Qt::Key_Minus…) que es compara amb ==. setVisible(true) mostra un giny i setVisible(false) l'amaga.
• «Per defecte ha de sortir sense el botó»: al constructor, ui->btNova->setVisible(false);.
• El darrer else és important. QWidget::keyPressEvent(event) marca l'esdeveniment com a ignorat, i així Qt l'ofereix a qui toqui (per exemple, a un diàleg que vol tancar-se amb l'Esc). Si un esdeveniment no s'ignora, es considera atès.

A qui arriba la tecla?

La tecla va primer al giny que té el focus (per exemple, la casella). La casella no en fa res i l'ignora; Qt l'ofereix aleshores al seu pare, el Previsio, i el teu keyPressEvent la rep. Per això funciona encara que el focus estigui en un fill. Però només arriba als pares del giny amb focus: al bloc següent hi ha tres Previsio i només un tindrà el focus.

Si el «+» no et respon, comprova que la finestra té el focus (fes-hi clic) i, mentre proves, pots comparar amb una altra tecla, per exemple Qt::Key_A.

ciutats.cpp

#include "ciutats.h"
#include "ui_ciutats.h"
#include "previsio.h"

Ciutats::Ciutats(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Ciutats)
{
    ui->setupUi(this);
    setWindowTitle("Tres ciutats");

    m_bcn = new Previsio;
    m_gir = new Previsio;
    m_lle = new Previsio;

    ui->vlEsq->addWidget(m_bcn);
    ui->vlCen->addWidget(m_gir);
    ui->vlDre->addWidget(m_lle);

    connect(this, &Ciutats::actualitzaTot, m_bcn, &Previsio::novaPrevisio);
    connect(this, &Ciutats::actualitzaTot, m_gir, &Previsio::novaPrevisio);
    connect(this, &Ciutats::actualitzaTot, m_lle, &Previsio::novaPrevisio);
    connect(ui->btTot, &QPushButton::clicked, this, &Ciutats::actualitza);
}

Ciutats::~Ciutats()
{
    delete ui;
}

void Ciutats::actualitza()
{
    emit actualitzaTot();
}

• Es creen tres Previsio amb new, sense pare, i addWidget les col·loca a cada layout buit i els dona el pare (el Ciutats): ja no cal cap delete.
• actualitzaTot() és un senyal propi, sense implementació (ho fa moc). Es connecta tres cops, un per ciutat, amb novaPrevisio(). Quan s'emet, els tres slots s'executen en l'ordre en què s'han connectat (bcn, gir, lle).
• El botó no toca les ciutats directament: crida actualitza(), que només emet el senyal. Així, altres parts del programa (per exemple, un menú) poden fer el mateix cridant actualitza(), sense saber res de les ciutats.
• novaPrevisio() és un slot públic de Previsio (public slots:), perquè es pot connectar des de fora.

La trampa de la llavor

Una solució freqüent és posar srand(time(NULL)) al constructor de Previsio. Les tres ciutats es construeixen dins del mateix segon, reben la mateixa llavor i el primer rand() és el mateix: en arrencar, les tres previsions són iguals. Amb QRandomGenerator::global() no cal sembrar res. Passa'l pas a pas amb l'opció «srand() a cada constructor».

Un diàleg que conté un giny

#include "ajustos.h"
#include "ui_ajustos.h"
#include "ciutats.h"

Ajustos::Ajustos(QWidget *parent)
    : QDialog(parent)
    , ui(new Ui::Ajustos)
{
    ui->setupUi(this);
    setWindowTitle("Ajustos");

    ui->vlContingut->addWidget(new Ciutats);
}

Ajustos::~Ajustos()
{
    delete ui;
}

• Igual que a la finestra anterior: un layout buit (vlContingut) i un addWidget que hi posa un Ciutats.
• Els botons ja fan «el que és típic»: al .ui hi ha dues connexions, accepted() → accept() i rejected() → reject(). No cal escriure cap slot.
• Modal: exec() mostra el diàleg i no torna fins que es tanca; retorna QDialog::Accepted (1) o QDialog::Rejected (0). L'Esc i la X de la finestra també són «cancel·la».

Ajustos dlg;

if (dlg.exec() == QDialog::Accepted)
    qDebug() << "L'usuari ha acceptat";

finestra.cpp

#include "finestra.h"
#include "ui_finestra.h"
#include "ciutats.h"
#include "ajustos.h"

Finestra::Finestra(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::Finestra)
{
    ui->setupUi(this);
    setWindowTitle("Previsió del temps");

    m_ciutats = new Ciutats;
    ui->vlCentral->addWidget(m_ciutats);
}

Finestra::~Finestra()
{
    delete ui;
}

void Finestra::on_actionActualitza_triggered()
{
    m_ciutats->actualitza();
}

void Finestra::on_actionSurt_triggered()
{
    close();
}

void Finestra::on_actionObreDialeg_triggered()
{
    Ajustos dlg(this);

    dlg.exec();
}

• El menú es dibuixa al Designer: escrius «Opcions» a la barra de dalt i, a sota, «Actualitza» i «Surt». Cada element és una QAction amb el seu objectName (actionActualitza…). Un & davant d'una lletra en fa l'accés ràpid, i «Ctrl+U» és una drecera.
• El senyal d'una acció és triggered(): el slot per nom és on_actionActualitza_triggered. Aquí només crida m_ciutats->actualitza(): el menú fa el mateix que el botó sense duplicar codi, perquè els dos criden la mateixa funció.
• close() tanca la finestra. Com que era l'última, l'aplicació acaba (a.exec() retorna). QApplication::quit() ho fa directament, encara que hi hagi altres finestres obertes.
• Cridar un diàleg (ex10): Ajustos dlg(this); crea el diàleg a la pila amb la finestra com a pare (es mostra centrat sobre ella) i dlg.exec() el manté obert. En acabar la funció, dlg es destrueix sol.
• Si en lloc d'exec() fas dlg.show() amb el diàleg a la pila, no bloqueja: la funció acaba a l'instant i el diàleg desapareix (mira «Troba l'error»).