QSignalMapper简介

原文： http://doc.qt.io/qt-5/qsignalmapper.html#details

QSignalMapper类将来自于一些有标识的发送者的signal连接在一起。
该类收集一组无参的signal，然后以整型数、或字符串、或widget参数为参数重新将这些signal再次发送出去，而这里的整型数、字符串和widget参数就是原本发送该signal对象的标识信息。
QSignalMapper支持将特定的字符串或整型数对应到特定的对象上，这是通过setMapping()做到的。该特定对象的signal可以被连接到QSignalMapper的map() slot，而map()会发射mapped() signal，注意这里的mapped() signal是带参数的，而参数类型就是原本发送最初signal的特定对象的标识信息，即整型数或字符串等。使用removeMappings()可以删除对应关系。

举例： 假设我们想创建一个自定义的widget，它包含一组buttons（比如，类似于调色板）。一种方法就是将每个button的clicked() signal连接到它自己的slot上。但是在本例中，我们想要把所有的buttons连接到一个单一的slot上，并且以被点击的button的标识来作为该slot的参数。
以下是一个简单的自定义widget的定义，它带有一个signal即clicked(). 当button被点击时，button上的文字会和clicked() signal一起被发射出去。（ 译注： clicked() signal本身是无参的。）

class ButtonWidget : public QWidget
{
    Q_OBJECT


public:
    ButtonWidget(const QStringList &texts, QWidget *parent = 0);


signals:
    void clicked(const QString &text);


private:
    QSignalMapper *signalMapper;
};

我们需要实现的唯一函数就是构造函数。如下：

ButtonWidget::ButtonWidget(const QStringList &texts, QWidget *parent)
    : QWidget(parent)
{
    signalMapper = new QSignalMapper(this);


    QGridLayout *gridLayout = new QGridLayout;
    for (int i = 0; i < texts.size(); ++i) {
        QPushButton *button = new QPushButton(texts[i]);
        connect(button, SIGNAL(clicked()), signalMapper, SLOT(map()));
        signalMapper->setMapping(button, texts[i]);
        gridLayout->addWidget(button, i / 3, i % 3);
    }


    connect(signalMapper, SIGNAL(mapped(QString)),
            this, SIGNAL(clicked(QString)));


    setLayout(gridLayout);
}

一组文本被传递给构造函数。一个signal mapper被构建出来，而对应于这组文本中的每一个文本，一个QPushButton就会被创建出来。我们将每个button的clicked() signal连接到这个signal mapper的map() slot，然后再在该signal mapper上创建一个从每个button到该button对应的文本的mapping. 最终我们将该signal mapper的mapped() signal和该自定义的widget的clicked() signal 连接起来。当用户点击一个button之后，该自定义widget就会发射一个clicked() signal出来，而该signal的参数就是用户所点击的button的文字。

（完）