QSignalMapper Class

Descripción detallada

Esta clase recoge un conjunto de señales sin parámetros, y las reemite con parámetros enteros, de cadena o widget correspondientes al objeto que envió la señal. Tenga en cuenta que en la mayoría de los casos puede utilizar lambdas para pasar parámetros personalizados a las ranuras. Esto es menos costoso y simplificará el código.

La clase soporta el mapeo de cadenas particulares, enteros, objetos y widgets con objetos particulares usando setMapping(). Las señales de los objetos pueden entonces conectarse a la ranura map() que emitirá una señal (podría ser mappedInt(), mappedString() y mappedObject()) con un valor asociado al objeto de señalización original. Las asignaciones pueden eliminarse posteriormente utilizando removeMappings().

Ejemplo: Supongamos que queremos crear un widget personalizado que contenga un grupo de botones (como una paleta de herramientas). Una posibilidad es conectar la señal clicked() de cada botón a su propia ranura personalizada; pero en este ejemplo queremos conectar todos los botones a una única ranura y parametrizar la ranura por el botón sobre el que se ha pulsado.

Aquí está la definición de un widget personalizado simple que tiene una sola señal, clicked(), que se emite con el texto del botón que fue pulsado:

class ButtonWidget : public QWidget
{
    Q_OBJECT

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

signals:
    void clicked(const QString &text);

private:
    QSignalMapper *signalMapper;
};

La única función que necesitamos implementar es el constructor:

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

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

    connect(signalMapper, &QSignalMapper::mappedString,
            this, &ButtonWidget::clicked);
}

Se pasa una lista de textos al constructor. Se construye un mapeador de señales y para cada texto de la lista se crea un QPushButton. Conectamos la señal clicked() de cada botón a la ranura map() del mapeador de señales, y creamos una asignación en el mapeador de señales desde cada botón al texto del botón. Por último, conectamos la señal mappedString() del mapeador de señales a la señal clicked() del widget personalizado. Cuando el usuario pulse un botón, el widget personalizado emitirá una única señal clicked() cuyo argumento es el texto del botón que el usuario ha pulsado.

Esta clase era muy útil antes de que las funciones lambda pudieran usarse como slots. El ejemplo anterior puede reescribirse de forma más simple sin QSignalMapper conectándose a una función lambda.

ButtonWidget::ButtonWidget(const QStringList &texts, QWidget *parent)
    : QWidget(parent)
{
    QGridLayout *gridLayout = new QGridLayout(this);
    for (int i = 0; i < texts.size(); ++i) {
        QString text = texts[i];
        QPushButton *button = new QPushButton(text);
        connect(button, &QPushButton::clicked, [this, text] { clicked(text); });
        gridLayout->addWidget(button, i / 3, i % 3);
    }
}