原文:
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本身是无参的。)
我们需要实现的唯一函数就是构造函数。如下:
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的文字。
(完)