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 = );

    ~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 = ; 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 / , i % );

    }

    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 = ; i < windows.size(); ++i)

    {

        MdiChild *child = qobject_cast(windows.at(i)->widget());

        QString text;

        if (i < )

        {

            text = tr("&%1 %2").arg(i + ) .arg(child->userFriendlyCurrentFile());

        }

        else

        {

            text = tr("%1 %2").arg(i + ) .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));

}