How QT signals with parameters works

Question

can someone tell me how exactly signals with parameters work? I mean... if i have declared signal f.e.:

void sign1(int)

how should i specify what integer i want to send with that signal? Also, can i declare signal with multiple arguments? Like:

void sign2(int, int)

And again... i want to send with sign2 two out of four variables that i have. Is that possible, and how it should be done? To specify my question below is a little more detailed example:

class Board
{
  signals: 
    void clicked(int, int);
  private:
    int x1{4}; int x2{4}; int x3{5}; int x4{8};
}

and there is board.ui file with pushbutton. After pushbutton is clicked i want to send to the slot for example x1 and x3. Example:

connect(ui->button, SIGNAL(clicked(int, int)), obj2, slot2); 

I hope that it's somehow clear. I will really appreciate your help.

Answer 1

The rule for signal/slot connection may be formulated as the following:

You can ignore signal arguments, and you cannot create slot arguments from nothing

What does it mean? If your signal has n arguments, your slot shall have at most n arguments as well (beware of the types). See tabular below.

• On first line, you have a signal with two arguments, thus, your slot can have two arguments (using all the signal arguments), or one argument (ignoring one argument of the signal) or no argument (ignoring both signal arguments)

• On the second line, you have a signal valueChanged(int) with one argument. Your slot may have one or no argument (ignoring the signal argument) but may not have two or more arguments as you cannot create values.

• On the third line the signal textChanged(QString) cannot be connected with setValue(int) because we cannot create an int value from from QString.

• The fourth line follow these rules. If the signal has no argument, the connected signal cannot create new arguments, thus update() is correct, setValue(int) isn't.

• Another point that shall be looked at is overloading of signal/slots. It is the case where many signals/slots with the same name but with different numers or different types of arguments. You may have the class QLCDNumber, where the slot display has many overload. In this cas, you have to explicitly defined which pair of signals slots, you would like to use as explained here

You can try out the following example:

Example :

#include <QtWidgets>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QWidget *window = new QWidget();
    window->setAttribute(Qt::WA_DeleteOnClose);
    QVBoxLayout *topLayout = new QVBoxLayout(window);

    //Set up of GUI
    QSlider *slider = new QSlider(Qt::Horizontal);
    slider->setRange(0, 100);

    QSpinBox *spin = new QSpinBox;
    spin->setReadOnly( true );

    QHBoxLayout *horizontalLayout = new QHBoxLayout;
    horizontalLayout->addWidget(slider);
    horizontalLayout->addWidget(spin);
    topLayout->addLayout(horizontalLayout);

    // using pointer to member function
    QObject::connect(slider, &QSlider::valueChanged,
                     spin, &QSpinBox::setValue);
    // set the slider position and hence the QSpinBox value too
    slider->setValue(40);

    // Uncommenting the following connect will result in a compile time error.
    // The signal passes no arguments whereas the slot is expecting a single
    // argument.
    // By using function pointers we get compile time parameter list checking.
    // Using the old-style SIGNAL/SLOT macros this would have been detected
    // as a run time warning only.
    //QObject::connect(slider, &QSlider::sliderPressed,
    //                 spin, &QSpinBox::setValue);

    QTextEdit *textEdit = new QTextEdit();
    textEdit->setAttribute(Qt::WA_DeleteOnClose);

    // Uncommenting the following connect will result in a compile time error.
    // The signal is passing an incompatible parameter to the slot.
    // By using function pointers we get compile time parameter type conversion.
    // Using the old-style SIGNAL/SLOT macros this would have been detected
    // as a run time warning only.
    //QObject::connect(slider, &QSlider::sliderMoved,
    //                 textEdit, &QTextEdit::setFontFamily);

    window->show();
    return app.exec();
}