Qt 库的 QStyledItemDelegate 的功能及用法-QT开发中文网

QStyledItemDelegate 是 Qt 框架中用于视图组件（如 QTableView 和 QListView）的一个类，主要用于自定义项的显示和编辑。它允许开发者为模型中的数据提供自定义的绘制和编辑行为。

功能

自定义绘制：可以重写 paint() 方法来定义如何绘制每个项。
自定义编辑：可以重写 createEditor()、setEditorData() 和 setModelData() 方法，以提供自定义的编辑界面和逻辑。
样式支持：能够使用样式表来更改项的外观，并且支持不同状态（例如选中、激活等）的表现。
与模型的集成：可以通过设置合适的数据角色（如 Qt::DisplayRole, Qt::EditRole 等）从模型获取数据进行展示或编辑。

用法

下面是一个简单的示例，展示如何使用 QStyledItemDelegate：

#include <QApplication>
#include <QTableView>
#include <QStandardItemModel>
#include <QStyledItemDelegate>
#include <QLineEdit>

class CustomDelegate : public QStyledItemDelegate {
public:
    CustomDelegate(QObject *parent = nullptr) : QStyledItemDelegate(parent) {}

    // 重写 paint() 方法来自定义绘制
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
               const QModelIndex &index) const override {
        // 使用默认绘制
        QStyledItemDelegate::paint(painter, option, index);
        
        // 可以添加更多自定义绘制代码
        if (index.data().toString() == "Special") {
            painter->fillRect(option.rect, Qt::yellow); // 自定义背景颜色
        }
    }

    // 重写 createEditor() 创建自定义编辑器
    QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option,
                          const QModelIndex &index) const override {
        return new QLineEdit(parent); // 使用 QLineEdit 作为编辑器
    }

    // 设置 editor 的数据
    void setEditorData(QWidget *editor, const QModelIndex &index) const override {
        QLineEdit *lineEdit = qobject_cast<QLineEdit *>(editor);
        lineEdit->setText(index.data().toString());
    }

    // 从 editor 更新模型的数据
    void setModelData(QWidget *editor, QAbstractItemModel *model,
                      const QModelIndex &index) const override {
        QLineEdit *lineEdit = qobject_cast<QLineEdit *>(editor);
        model->setData(index, lineEdit->text());
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QTableView tableView;
    QStandardItemModel model(5, 2); // 5行2列

    for (int row = 0; row < 5; ++row) {
        for (int column = 0; column < 2; ++column) {
            model.setItem(row, column, new QStandardItem(QString("Row %1 Column %2").arg(row).arg(column)));
        }
    }
    
    model.setItem(2, 0, new QStandardItem("Special")); // 特殊项，用于测试
    
    tableView.setModel(&model);

    CustomDelegate *delegate = new CustomDelegate();
    tableView.setItemDelegate(delegate); // 设置委托

    tableView.show();
    
    return app.exec();
}