Класс QSignalMapper

Класс QSignalMapper объединяет сигналы от идентифицируемых отправителей. Подробнее...

Этот класс устарел. Он предоставляется для сохранения работоспособности старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.

• Список всех членов, включая наследуемые
• Устаревшие члены

Открытые функции

• 32 открытых функции унаследованы от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические открытые члены

• 10 статических открытых членов унаследованы от QObject

Дополнительные наследуемые члены

• 1 свойство унаследовано от QObject
• 9 защищенных функций унаследованы от QObject

Подробное описание

Класс QSignalMapper объединяет сигналы от идентифицируемых отправителей.

Этот класс собирает набор сигналов без параметров и повторно излучает их с целыми числами, строками или параметрами виджетов, соответствующими объекту, который отправил сигнал.

Класс поддерживает сопоставление определенных строк или целых чисел с определенными объектами с помощью setMapping(). Сигналы объектов затем могут быть подключены к слоту map(), который излучит сигнал mapped() со строкой или целым числом, связанными с исходным объектом сигнализации. Сопоставления можно удалить позже с помощью removeMappings().

Пример: Предположим, что мы хотим создать пользовательский виджет, содержащий группу кнопок (например, палитру инструментов). Один из подходов заключается в подключении сигнала каждой кнопки к своему пользовательскому слоту; но в этом примере мы хотим подключить все кнопки к одному слоту и параметризовать слот кнопкой, которая была нажата.

Вот определение простого пользовательского виджета, который имеет один сигнал, clicked(), который излучается со значением текста кнопки, которая была нажата:

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

В конструктор передаётся список текстов. Создаётся объект QSignalMapper, и для каждого текста в списке создаётся кнопка QPushButton. Мы подключаем сигнал каждой кнопки clicked() к слоту map() маппера сигналов и создаём сопоставление в маппере сигналов от каждой кнопки к тексту этой кнопки. Наконец, мы подключаем сигнал mapped() маппера сигналов к сигналу clicked() пользовательского виджета. Когда пользователь нажимает кнопку, пользовательский виджет излучит один сигнал clicked(), аргументом которого является текст кнопки, которую нажал пользователь.

Этот класс был полезен в основном до того, как лямбда-функции могли использоваться в качестве слотов. Приведённый выше пример можно переписать проще без QSignalMapper, подключившись к лямбда-функции.

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

См. также QObject, QButtonGroup и QActionGroup.

Документация по функциям членов

QSignalMapper::QSignalMapper(QObject *parent = nullptr)

Конструирует объект QSignalMapper с родителем parent.

[virtual] QSignalMapper::~QSignalMapper()

Удаляет объект QSignalMapper.

[slot] void QSignalMapper::map()

Этот слот излучает сигналы на основе объекта, который отправляет сигналы в него.

[slot] void QSignalMapper::map(QObject *sender)

Этот слот излучает сигналы на основе объекта sender.

[signal] void QSignalMapper::mapped(int i)

Этот сигнал излучается, когда map() получает сигнал от объекта, для которого задано целочисленное сопоставление. Переданное целое число объекта сопоставления передаётся в i.

Примечание: Сигнал mapped перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию, как показано в этом примере:

connect(signalMapper, QOverload<int>::of(&QSignalMapper::mapped),
    [=](int i){ /* ... */ });

См. также setMapping().

[signal] void QSignalMapper::mapped(const QString &text)

Этот сигнал излучается, когда map() получает сигнал от объекта, для которого задано строковое сопоставление. Переданная строка объекта сопоставления передаётся в text.

Примечание: Сигнал mapped перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию, как показано в этом примере:

connect(signalMapper, QOverload<const QString &>::of(&QSignalMapper::mapped),
    [=](const QString &text){ /* ... */ });

См. также setMapping().

[signal] void QSignalMapper::mapped(QWidget *widget)

Этот сигнал излучается, когда map() получает сигнал от объекта, для которого задано сопоставление виджета. Переданный виджет объекта сопоставления передаётся в widget.

Примечание: Сигнал mapped перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию, как показано в этом примере:

connect(signalMapper, QOverload<QWidget *>::of(&QSignalMapper::mapped),
    [=](QWidget *widget){ /* ... */ });

См. также setMapping().

[signal] void QSignalMapper::mapped(QObject *object)

Этот сигнал излучается, когда map() получает сигнал от объекта, для которого задано сопоставление объекта. Переданный объект сопоставления передаётся в object.

Примечание: Сигнал mapped перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию, как показано в этом примере:

connect(signalMapper, QOverload<QObject *>::of(&QSignalMapper::mapped),
    [=](QObject *object){ /* ... */ });

См. также setMapping().

QObject *QSignalMapper::mapping(int id) const

Возвращает отправителя QObject, связанного с id.

См. также setMapping().

QObject *QSignalMapper::mapping(const QString &id) const

Эта функция перегружает mapping().

QObject *QSignalMapper::mapping(QWidget *widget) const

Эта функция перегружает mapping().

Возвращает отправителя QObject, связанного с widget.

QObject *QSignalMapper::mapping(QObject *object) const

Эта функция перегружает mapping().

Возвращает отправителя QObject, связанного с object.

void QSignalMapper::removeMappings(QObject *sender)

Удаляет все сопоставления для sender.

Это делается автоматически при уничтожении сопоставленных объектов.

Примечание: Это не отсоединяет никакие сигналы. Если sender не уничтожается, то это необходимо сделать явно, если это требуется.

void QSignalMapper::setMapping(QObject *sender, int id)

Добавляет сопоставление, так что при сигнале map() от данного sender, генерируется сигнал mapped(id).

Для каждого отправителя может быть не более одного целочисленного ID.

См. также mapping().

void QSignalMapper::setMapping(QObject *sender, const QString &text)

Добавляет сопоставление, так что при сигнале map() от sender, генерируется сигнал mapped(text).

Для каждого отправителя может быть не более одной строки.

void QSignalMapper::setMapping(QObject *sender, QWidget *widget)

Добавляет сопоставление, так что при сигнале map() от sender, генерируется сигнал mapped(widget).

Для каждого отправителя может быть не более одного виджета.

void QSignalMapper::setMapping(QObject *sender, QObject *object)

Добавляет сопоставление, так что при сигнале map() от sender, генерируется сигнал mapped(object).

Для каждого отправителя может быть не более одного объекта.