PyQt/PySide：为QPushButton等QWidget存储并获取关联数据

当你循环创建列表项/表格行及其中的按钮、复选框、输入框等控件时，需要给这些控件绑定对应项的关联数据（比如行号、项ID），以便在槽函数中精准定位操作对象。下面是几种实用的实现方式：

1. 利用QObject的setProperty()和property()（通用方案） #

所有Qt控件都继承自QObject，因此可以通过setProperty()给控件添加自定义属性存储关联数据，在槽函数中通过property()取出。这种方式适配所有可发送信号的Qt控件，兼容性最强。

QListWidget示例： #

// 循环创建列表项和操作按钮
for (int i = 0; i < 10; ++i) {
    QListWidgetItem* item = new QListWidgetItem("Item " + QString::number(i));
    ui->listWidget->addItem(item);

    QPushButton* btn = new QPushButton("删除");
    // 给按钮设置自定义属性，存储当前项的索引
    btn->setProperty("itemIndex", i);
    // 连接信号到槽函数
    connect(btn, &QPushButton::clicked, this, &YourClass::onItemBtnClicked);

    // 将按钮设置为列表项的显示部件
    ui->listWidget->setItemWidget(item, btn);
}

// 槽函数实现
void YourClass::onItemBtnClicked() {
    QPushButton* senderBtn = qobject_cast<QPushButton*>(sender());
    if (!senderBtn) return;

    // 取出存储的索引
    int itemIndex = senderBtn->property("itemIndex").toInt();
    QListWidgetItem* targetItem = ui->listWidget->item(itemIndex);
    // 执行对应操作，这里以删除项为例
    delete targetItem;
}

QTableWidget示例： #

// 循环创建表格行和操作按钮
for (int row = 0; row < 10; ++row) {
    ui->tableWidget->insertRow(row);
    ui->tableWidget->setItem(row, 0, new QTableWidgetItem("Row " + QString::number(row)));

    QPushButton* btn = new QPushButton("删除");
    // 存储当前行号和列号
    btn->setProperty("row", row);
    btn->setProperty("col", 1);
    connect(btn, &QPushButton::clicked, this, &YourClass::onTableBtnClicked);

    ui->tableWidget->setCellWidget(row, 1, btn);
}

// 槽函数实现
void YourClass::onTableBtnClicked() {
    QPushButton* btn = qobject_cast<QPushButton*>(sender());
    if (!btn) return;

    int row = btn->property("row").toInt();
    ui->tableWidget->removeRow(row);
}

2. 使用Lambda表达式捕获数据（Qt5+推荐） #

在连接信号时，用Lambda表达式直接捕获当前的关联数据（比如行号、项指针），无需依赖sender()，代码更直观简洁，适合Qt5及以上版本。

QListWidget示例： #

for (int i = 0; i < 10; ++i) {
    QListWidgetItem* item = new QListWidgetItem("Item " + QString::number(i));
    ui->listWidget->addItem(item);

    QPushButton* btn = new QPushButton("操作");
    // Lambda捕获当前的项和索引，直接在表达式内执行操作
    connect(btn, &QPushButton::clicked, [this, item, i]() {
        qDebug() << "操作第" << i << "项:" << item->text();
        delete item;
    });

    ui->listWidget->setItemWidget(item, btn);
}

QTableWidget示例： #

for (int row = 0; row < 10; ++row) {
    ui->tableWidget->insertRow(row);
    ui->tableWidget->setItem(row, 0, new QTableWidgetItem("Row " + QString::number(row)));

    QPushButton* btn = new QPushButton("删除");
    // Lambda捕获行号，直接传递操作逻辑
    connect(btn, &QPushButton::clicked, [this, row]() {
        ui->tableWidget->removeRow(row);
    });

    ui->tableWidget->setCellWidget(row, 1, btn);
}

注意：如果Lambda中捕获的对象可能被提前销毁，建议使用QPointer包裹对象，避免悬空指针问题。

3. 自定义控件子类（复杂数据场景） #

如果需要存储的关联数据比较复杂（比如自定义结构体、业务对象指针），可以子类化目标控件，添加成员变量专门存储数据，槽函数中直接访问。

示例（自定义按钮存储行号）： #

// 自定义按钮类
class MyPushButton : public QPushButton {
    Q_OBJECT
public:
    explicit MyPushButton(int row, QWidget* parent = nullptr) 
        : QPushButton(parent), m_row(row) {}

    // 获取存储的行号
    int getRow() const { return m_row; }

private:
    int m_row; // 存储关联的表格行号
};

// 创建按钮时的逻辑
for (int row = 0; row < 10; ++row) {
    ui->tableWidget->insertRow(row);
    MyPushButton* btn = new MyPushButton(row);
    btn->setText("删除");
    connect(btn, &MyPushButton::clicked, this, &YourClass::onCustomBtnClicked);
    ui->tableWidget->setCellWidget(row, 1, btn);
}

// 槽函数实现
void YourClass::onCustomBtnClicked() {
    MyPushButton* btn = qobject_cast<MyPushButton*>(sender());
    if (!btn) return;

    int row = btn->getRow();
    ui->tableWidget->removeRow(row);
}

4. 间接获取控件所在的项/行（不推荐，仅作补充） #

对于QTableWidget，可以通过控件的位置间接查找所在行，但这种方式依赖布局结构，稳定性不如直接绑定数据，仅作为备选方案：

void YourClass::onBtnClicked() {
    QPushButton* btn = qobject_cast<QPushButton*>(sender());
    if (!btn) return;

    // 获取按钮所在的单元格容器
    QWidget* cellWidget = btn->parentWidget();
    if (!cellWidget) return;

    // 通过位置获取单元格的模型索引
    QModelIndex index = ui->tableWidget->indexAt(cellWidget->pos());
    if (index.isValid()) {
        int row = index.row();
        ui->tableWidget->removeRow(row);
    }
}

内容的提问来源于stack exchange，提问作者user2526586