首页 > 代码库 > QSignalMapper类处理多信号关联同一个槽的方法（1）
QSignalMapper类处理多信号关联同一个槽的方法（1）
QSignalMapper这个类并不是个新鲜概念， 早在Qt2里就已经存在， 而且它的功能也是始终如一。 不过由于宣传力度不够（例子里涉及到它的很少）了解这个类人可能还不是很多， 所以特此撰文介绍此类的功能和用法。简单的理解，可以把SignalMapper这个类看成是信号的翻译和转发器， 它可以把一个无参数的信号翻译成带int参数、QString参数、QObject*参数或者QWidget*参数的信号， 并将之转发。这么一说大家有没有联想到该类的适用范围呢？ 呵呵， 是不是一下就想到了如果我有一堆的button， 可以把clicked事件放在一个函数里处理， 只要给button编个号或者给button起个名就行了， 这样就不用给每个button写一个slot了，岂不是很方便？
下面这段代码就实现了该功能：
/***mainwin.h***/
#ifndef MAINWIN_H#define MAINWIN_H#include <QWidget>class QSignalMapper;class MainWin : public QWidget{ Q_OBJECT public: MainWin(QWidget *parent = 0); ~MainWin();private slots: void doClicked(const QString &btnname);private: QSignalMapper *signalMapper;};#endif // MAINWIN_H
/***mainwin.cpp***/
#include "mainwin.h"#include <QSignalMapper>#include <QLayout>#include <QPushButton>#include <QMessageBox>MainWin::MainWin(QWidget *parent) : QWidget(parent){ QString buttontext = "btn1,btn2,btn3,btn4,btn5,btn6,btn7,btn8,btn9,btn10";//10个button QStringList texts = buttontext.split(","); 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 signalMapper->setMapping (button, texts[i]); //设置signalmapper的转发规则, 转发为参数为QString类型的信号， 并把texts[i]的内容作为实参传递。 gridLayout->addWidget(button, i / 3, i % 3); } connect(signalMapper, SIGNAL(mapped (const QString &)), this, SLOT(doClicked(const QString &)));//将转发的信号连接到最终的槽函数 setLayout(gridLayout);}void MainWin::doClicked(const QString& btnname){ QMessageBox::information(this,"Clicked",btnname+" is clicked!");}MainWin::~MainWin(){ }
/***main.cpp***/
#include <QApplication>#include "mainwin.h"int main(int argc, char *argv[]){ QApplication a(argc, argv); MainWin w; w.show(); return a.exec();}
从这个例子来看QSignalMapper的用法是非常简单的， 也很容易理解。
(1)首先把原始不带参数的信号连接到signalmapper的map槽函数， 这样signalmapper能在第一时间接收到原始信号；
(2)其次调用setMapper方法告诉signalmapper怎样去处理原始信号。 在这个例子中是把原始信号转化为一个带QString参数的信号
(3)最后接收转化后的带参数信号， 这里所把转化后的信号与槽函数连接， 在槽函数中获得需要的数据。
QSignalMapper类的功能核心是要建立一个从发出原始信号的object到需要的数据的映射（setMapper函数）， 如果你的程序恰巧需要这样的功能，那么当然QSignalMapper就是当仁不让的最佳选择。 除了上述最常见的用法， 我们也来开动脑筋想想还有什么别的场合适合使用这个类呢？
在Qt的examples里有一个例子用到了QSignalMapper这个类， 在examples/mainwindow/mdi/mainwindow.cpp里。 它的用法是将QWidget指针作为参数， 然后菜单选中的信号映射到子Window的指针， 最终由QMainWindow来处理， 用于实现子窗口的切换。 这个用法很有些意思， 可以说是QSignalMapper的最佳用例， 建议大家学习一下。 这里截取其中最核心的代码， 有注释应该很好看懂吧， 如果还是有问题就留言：
//主类从QMainWindow派生MainWindow::MainWindow(){ //... windowMapper = new QSignalMapper(this); connect(windowMapper, SIGNAL(mapped (QWidget *)), this, SLOT(setActiveSubWindow(QWidget *))); //转发的信号直接连接到QMainWindow的setActiveSubWindow槽 //...}void MainWindow::updateWindowMenu(){ //... QList windows = mdiArea->subWindowList(); separatorAct->setVisible(!windows.isEmpty()); for (int i = 0; i < windows.size(); ++i) { MdiChild *child = qobject_cast(windows.at(i)->widget()); QString text; if (i < 9) { text = tr("&%1 %2").arg(i + 1) .arg(child->userFriendlyCurrentFile()); } else { text = tr("%1 %2").arg(i + 1) .arg(child->userFriendlyCurrentFile()); } QAction *action = windowMenu->addAction(text); action->setCheckable(true); action ->setChecked(child == activeMdiChild()); connect(action, SIGNAL(triggered()), windowMapper, SLOT(map ()));//监控action的triggered信号 windowMapper->setMapping (action, windows.at(i));//建立action指针到QWidget*的映射 } //... }}<pre name="code" class="cpp">void MainWindow::setActiveSubWindow(QWidget *window) // 设置活动子窗口{ if (!window) // 如果传递了窗口部件，则将其设置为活动窗口 return; ui->mdiArea->setActiveSubWindow(qobject_cast<QMdiSubWindow *>(window));}
此外，在C:\Qt\4.8.4\examples\tools\inputpanel此例中也用到了信号映射器。
引自：http://blog.csdn.net/cuteqt/article/details/4306900
转自：http://blog.csdn.net/zzwdkxx/article/details/28437441
QSignalMapper类处理多信号关联同一个槽的方法（1）