在QTableView 中添加进度条

### 在 QTableView 单元格内嵌入进度条控件的实现方法 #### 方法概述 为了在 `QTableView` 的单元格中展示进度条 (`QProgressBar`)，推荐的方式是通过自定义委托 (`QItemDelegate` 或其派生类 `QStyledItemDelegate`) 来实现。这种方式允许开发者完全掌控绘制逻辑和交互行为，从而灵活地将进度条嵌入到表格视图中。 具体来说，可以通过重写 `paint()` 方法来自定义单元格的绘制效果，并结合模型中的数据动态反映进度状态[^2]。如果需要进一步增强功能性，还可以扩展编辑器的功能以支持用户交互。 --- #### 示例代码：在 QTableView 单元格中添加 QProgressBar 控件 以下是一个完整的示例，演示如何在 `QTableView` 的单元格中嵌入进度条控件。 ```cpp #include <QApplication> #include <QTableView> #include <QStandardItemModel> #include <QProgressBar> #include <QPainter> #include <QStyleOptionViewItem> #include <QStyledItemDelegate> // 自定义委托类 class ProgressBarDelegate : public QStyledItemDelegate { public: void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override { if (!index.isValid()) return; int progressValue = index.model()->data(index, Qt::DisplayRole).toInt(); // 获取进度值 if (progressValue < 0 || progressValue > 100) return; QStyleOptionProgressBar progressBarOption; progressBarOption.state = QStyle::State_Enabled; progressBarOption.direction = QApplication::layoutDirection(); progressBarOption.rect = option.rect.adjusted(5, 5, -5, -5); // 调整矩形区域 progressBarOption.fontMetrics = QApplication::fontMetrics(); progressBarOption.minimum = 0; progressBarOption.maximum = 100; progressBarOption.textAlignment = Qt::AlignCenter; progressBarOption.textVisible = true; progressBarOption.progress = progressValue; progressBarOption.text = QString("%1%").arg(progressValue); QApplication::style()->drawControl(QStyle::CE_ProgressBar, &progressBarOption, painter); } QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override { return QSize(100, 30); // 设置默认尺寸 } }; int main(int argc, char *argv[]) { QApplication app(argc, argv); // 创建表视图对象 QTableView tableView; // 初始化标准项模型并关联至表视图 QStandardItemModel model(4, 2); tableView.setModel(&model); // 设置列头名称以便于理解结构 QStringList headers; headers << "Progress" << "Description"; model.setHorizontalHeaderLabels(headers); // 填充模拟数据 for (int row = 0; row < 4; ++row) { model.setData(model.index(row, 0), qrand() % 101, Qt::EditRole); // 随机生成进度值 model.setData(model.index(row, 1), QString("Task %1").arg(row + 1), Qt::EditRole); } // 设置自定义委托 ProgressBarDelegate delegate; tableView.setItemDelegateForColumn(0, &delegate); // 仅为第0列启用进度条显示 // 显示整个界面组件 tableView.resize(400, 300); tableView.show(); return app.exec(); } ``` --- #### 实现细节解析 1. **自定义委托类** 上述代码中定义了一个名为 `ProgressBarDelegate` 的类，它继承自 `QStyledItemDelegate` 并重写了两个核心方法： - `paint()`：负责绘制进度条的具体表现形式。 - `sizeHint()`：返回单元格的理想大小，确保进度条有足够的空间显示[^2]。 2. **数据绑定** 表格模型中的每一行都存储了一个表示进度百分比的数值（范围为 `[0, 100]`）。该数值被传递给委托类用于计算和渲染对应的进度条[^1]。 3. **样式选项配置** 利用 `QStyleOptionProgressBar` 类型的对象来封装进度条的各种属性（如最小值、最大值、当前值等），并通过 `QApplication::style()->drawControl()` 方法完成最终的绘制工作。 --- #### 注意事项 - 当前实现仅适用于只读场景下的进度条显示需求。如果需要支持用户修改进度值的操作，则还需额外处理编辑器的相关逻辑。 - 确保模型中的数据格式一致且有效（即均为合法的整数范围内的进度值），否则可能导致意外错误或异常行为发生[^3]。 ---