QSignalMapper Class
La clase QSignalMapper agrupa las señales procedentes de emisores identificables. Más información...
| Encabezado: | #include <QSignalMapper> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QObject |
Funciones públicas
| QSignalMapper(QObject *parent = nullptr) | |
| virtual | ~QSignalMapper() |
| QObject * | mapping(int id) const |
| QObject * | mapping(QObject *object) const |
| QObject * | mapping(const QString &id) const |
| void | removeMappings(QObject *sender) |
| void | setMapping(QObject *sender, QObject *object) |
| void | setMapping(QObject *sender, const QString &text) |
| void | setMapping(QObject *sender, int id) |
Ranuras públicas
Señales
| void | mappedInt(int i) |
| void | mappedObject(QObject *object) |
| void | mappedString(const QString &text) |
Descripción detallada
Esta clase recopila un conjunto de señales sin parámetros y las reemite con parámetros de tipo entero, cadena o widget que se corresponden con el objeto que envió la señal. Ten en cuenta que, en la mayoría de los casos, puedes utilizar lambdas para pasar parámetros personalizados a los slots. Esto supone un menor coste y simplificará el código.
La clase admite la asignación de cadenas, números enteros, objetos y widgets concretos a objetos específicos mediante setMapping(). A continuación, las señales de los objetos se pueden conectar a la ranura map(), que emitirá una señal (podría ser mappedInt(), mappedString() o mappedObject()) con un valor asociado al objeto que originó la señal. Las asignaciones se pueden eliminar posteriormente mediante removeMappings().
Ejemplo: Supongamos que queremos crear un widget personalizado que contenga un grupo de botones (como una paleta de herramientas). Una forma de hacerlo 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 parametrizarla en función del botón en el que se haya hecho clic.
A continuación se muestra la definición de un widget personalizado sencillo que tiene una única señal, clicked(), que se emite con el texto del botón en el que se ha hecho clic:
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 tenemos que 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 crea un mapeador de señales y, para cada texto de la lista, se genera 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 entre cada botón y el 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 haga clic en un botón, el widget personalizado emitirá una única señal « clicked() », cuyo argumento será el texto del botón en el que haya hecho clic el usuario.
Esta clase resultaba especialmente útil antes de que las funciones lambda pudieran utilizarse como slots. El ejemplo anterior puede reescribirse de forma más sencilla sin QSignalMapper, conectándolo 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);
}
}Véase también QObject, QButtonGroup y QActionGroup.
Documentación de las funciones miembro
[explicit] QSignalMapper::QSignalMapper(QObject *parent = nullptr)
Crea un QSignalMapper con el parent como padre.
[virtual noexcept] QSignalMapper::~QSignalMapper()
Destruye el « QSignalMapper ».
[slot] void QSignalMapper::map()
Esta ranura emite señales en función del objeto que le envía señales.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// Connect using qOverload:
connect(sender, &SenderClass::signal,
signalMapper, qOverload<>(&QSignalMapper::map));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
signalMapper, [receiver = signalMapper]() { receiver->map(); });[slot] void QSignalMapper::map(QObject *sender)
Esta ranura emite señales basadas en el objeto « sender ».
Nota: Este slot está sobrecargado. Para conectarse a este slot:
// Connect using qOverload:
connect(sender, &SenderClass::signal,
signalMapper, qOverload(&QSignalMapper::map));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
signalMapper, [receiver = signalMapper](QObject *sender) { receiver->map(sender); }); [signal] void QSignalMapper::mappedInt(int i)
Esta señal se emite cuando se activa la señal « map » () desde un objeto que tiene definida una asignación de enteros. El entero asignado al objeto se pasa a través de « i ».
Véase también setMapping().
[signal] void QSignalMapper::mappedObject(QObject *object)
Esta señal se emite cuando se activa la señal « map()» desde un objeto que tiene una asignación de objetos definida. El objeto proporcionado por la asignación se pasa a « object ».
Véase también setMapping().
[signal] void QSignalMapper::mappedString(const QString &text)
Esta señal se emite cuando se envía la señal « map()» desde un objeto que tiene configurada una asignación de cadena. La cadena asignada al objeto se pasa a través de « text ».
Véase también setMapping().
QObject *QSignalMapper::mapping(int id) const
Devuelve el remitente QObject asociado a id.
Véase también setMapping().
QObject *QSignalMapper::mapping(QObject *object) const
Devuelve el « QObject » del remitente asociado a « object ».
Esta función sobrecarga QSignalMapper::mapping().
QObject *QSignalMapper::mapping(const QString &id) const
Esta función sobrecarga la función « QSignalMapper::mapping()».
void QSignalMapper::removeMappings(QObject *sender)
Elimina todas las asignaciones de sender.
Esto se realiza automáticamente cuando se destruyen los objetos asignados.
Nota: Esto no desconecta ninguna señal. Si sender no se destruye, será necesario hacerlo de forma explícita si es necesario.
void QSignalMapper::setMapping(QObject *sender, QObject *object)
Añade una asignación para que, cuando se emita la señal « map()» desde « sender », se emita la señal « mappedObject » (object ).
Puede haber como máximo un objeto por cada emisor.
Véase también mapping().
void QSignalMapper::setMapping(QObject *sender, const QString &text)
Añade una asignación para que, cuando se emita la señal « map()» desde « sender », se emita la señal « mappedString » (text ).
Puede haber como máximo un texto por cada remitente.
void QSignalMapper::setMapping(QObject *sender, int id)
Añade una asignación de modo que, cuando se emita la señal « map()» desde el sender especificado, se emita la señal « mappedInt » (id).
Puede haber como máximo un identificador entero por cada remitente.
Véase también mapping().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.