QT之QSignalMapper介绍

成员函数

1）setMapping(const QObject *sender, const QString &signal)
设置信号映射关系，将sender对象的signal信号映射到当前QSignalMapper对象的信号。

2）setMapping(const QObject *sender, int signalIndex)
设置信号映射关系，将sender对象的第signalIndex个信号映射到当前QSignalMapper对象的信号。

3）map(QObject *sender)
将sender对象的信号映射到当前QSignalMapper对象的信号。如果sender是QObject的子类，则使用预设的映射规则，否则什么也不做。

4）map(QObject *sender, const QString &signal)
将sender对象的signal信号映射到当前QSignalMapper对象的信号。

5）map(QObject *sender, int signalIndex)
将sender对象的第signalIndex个信号映射到当前QSignalMapper对象的信号。

6）mappedSignals()
返回所有映射到当前QSignalMapper对象的信号列表。

7）senderObject(QObject *signal)
返回与signal信号映射的QObject对象。如果没有找到映射则返回nullptr。

8）senderSignal(QObject *sender)
返回与sender对象映射的信号。如果没有找到映射则返回nullptr。

QSignalMapper类可以用于将一个信号的参数与另一个信号建立映射关系，然后将这个映射关系发送出去。它可以将一个信号的参数以integer、string或者widget的形式发送出去。

QSignalMapper类通过setMapping()函数来建立映射关系，使用map()槽函数来发送映射后的信号。它可以将不同的信号发送到同一个槽函数中，并且可以根据需要使用不同的参数来区分不同的信号。

例如，如果有多个按钮被点击，这些按钮都会发送一个clicked()信号。但是如果我们想要对不同的按钮进行不同的处理，那么我们就可以使用QSignalMapper类将按钮的clicked()信号与另一个槽函数建立映射关系，然后在槽函数中根据不同的按钮做出不同的处理。

例程

#include <QObject>  
#include <QSignalMapper>  
#include <QPushButton>  
#include <QApplication>  
  
class MyWidget : public QWidget  
{  
    Q_OBJECT  
public:  
    MyWidget(QWidget *parent = nullptr) : QWidget(parent), mapper(new QSignalMapper(this)) {  
        button1 = new QPushButton("Button 1", this);  
        button2 = new QPushButton("Button 2", this);  
        mapper->setMapping(button1, "button1Clicked");  
        mapper->setMapping(button2, "button2Clicked");  
        connect(mapper, &QSignalMapper::mappedId, this, &MyWidget::onButtonClicked);  
    }  
  
public slots:  
    void onButtonClicked(int id) {  
        if (id == button1->id()) {  
            qDebug() << "Button 1 clicked";  
        } else if (id == button2->id()) {  
            qDebug() << "Button 2 clicked";  
        }  
    }  
  
private:  
    QSignalMapper *mapper;  
    QPushButton *button1;  
    QPushButton *button2;  
};  
  
int main(int argc, char *argv[])  
{  
    QApplication app(argc, argv);  
    MyWidget widget;  
    widget.show();  
    return app.exec();  
}

在上面的代码中，我们创建了一个MyWidget类，其中包含两个QPushButton对象button1和button2，以及一个QSignalMapper对象mapper。我们使用setMapping()函数将button1的clicked()信号和button2的clicked()信号分别映射为"button1Clicked"和"button2Clicked"，然后将mapper的mappedId信号连接到MyWidget的onButtonClicked()槽函数中。在onButtonClicked()槽函数中，我们根据传入的id判断是哪个按钮被点击了，并进行相应的处理。最后在main()函数中创建MyWidget实例并显示出来。