Qt 之模型/视图（自定义进度条）

作者： 一去、二三里
个人微信号： iwaleon
微信公众号： 高效程序员

在之前的章节中分享过关于QHeaderView表头排序、添加复选框等内容，相信大家模型/视图、自定义风格有了一定的了解，下面我们来分享一个更常用的内容-自定义进度条。

实现方式：

1. 从QAbstractTableModel中设置对应的进度数据，因为我们需要显示进度条，而不是直接显示进度文本，所以原始的数据不需要直接显示在界面上，所以不需要使用Qt::DisplayRole，可以使用Qt::UserRole来代替。

2. 委托QStyledItemDelegate中根据进度索引所对应的数据来获取进度，然后为QStyleOptionProgressBar设置进度值、显示文本等信息。

3. 设置样式，这里需要QStyle在绘制的时候设置drawControl的最后一个参数，是一个QWidget *，这里我们使用QProgressBar即可。

| 版权声明：一去、二三里，未经博主允许不得转载。

效果

数据结构

下面定义了文件名、大小、状态、进度所对应的列，以及一个保存数据的结构体。

#define FILE_DOWNLOAD_FILE_NAME_COLUMN	         0
#define FILE_DOWNLOAD_SIZE_COLUMN	             1
#define FILE_DOWNLOAD_STATUS_COLUMN	             2
#define FILE_DOWNLOAD_PROGRESS_COLUMN	         3

// 下载记录
struct FileDownloadRecord
{
    QString strFileName;         //文件名称
    qint64 nSize;                //大小
    int nStatus;                 //状态
    int nProgress;               //进度
};

QStyledItemDelegate

这里只有绘制部分的代码，model对应的代码这里不再列出，可以参考其它对应的文章。

源码

void ProgressBarDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QStyleOptionViewItem viewOption(option);
    initStyleOption(&viewOption, index);
    if (option.state.testFlag(QStyle::State_HasFocus))
        viewOption.state = viewOption.state ^ QStyle::State_HasFocus;

    QStyledItemDelegate::paint(painter, viewOption, index);

    if (index.column() == FILE_DOWNLOAD_PROGRESS_COLUMN)
    {
        int nProgress = index.model()->data(index, Qt::UserRole).toInt();
        int nLeft = 8;
        int nTop = 8;
        int nWidth = option.rect.width() - 2 * nLeft;
        int nHeight = option.rect.height() - 2 * nTop;

        // 设置进度条的风格
        QStyleOptionProgressBar progressBarOption;
        progressBarOption.initFrom(option.widget);
        // 设置进度条显示的区域
        progressBarOption.rect = QRect(option.rect.left() + nLeft, option.rect.top() + nTop,  nWidth, nHeight);
        // 设置最小值
        progressBarOption.minimum = 0;
        // 设置最大值
        progressBarOption.maximum = 100;
        // 设置对齐方式
        progressBarOption.textAlignment = Qt::AlignCenter;
        // 设置进度
        progressBarOption.progress = nProgress;
        // 设置文本（百分比）
        progressBarOption.text = QString("%1%").arg(nProgress);
        // 设置文本可见
        progressBarOption.textVisible = true;

        QProgressBar progressBar;

        //绘制进度条
        QApplication::style()->drawControl(QStyle::CE_ProgressBar, &progressBarOption, painter, &progressBar);
    }
}

QThread

为了模拟真实性，所以起了一个线程，每隔1秒刷新一次。

FileDownloadThread::FileDownloadThread(QObject *parent)
    : QThread(parent)
{
    qRegisterMetaType<QList<FileDownloadRecord>>("QList<FileDownloadRecord>");
}

FileDownloadThread::~FileDownloadThread()
{
    requestInterruption();
    wait();
}

void FileDownloadThread::run()
{
    while (!isInterruptionRequested())
    {
        QTime time;
        time= QTime::currentTime();
        qsrand(time.msec()+time.second()*1000);

        QList<FileDownloadRecord> list;
        for (int i = 0; i < 5; ++i)
        {
            FileDownloadRecord record;
            record.strFileName = QString("/root/user/file%1.log").arg(i + 1);
            record.nSize = 1024 / ((i + 2) *(i + 2)) ;
            record.nStatus = i;
            record.nProgress = qrand() % 100 + 1;

            list.append(record);
        }

        emit transfer(list);
        msleep(1000);
    }
}

样式

QProgressBar{
        border: none;
        text-align: center;
        background: rgb(210, 225, 240);
}
QProgressBar::chunk {
        background: rgb(0, 160, 230);
}

衍伸

这里为了美观，我设置进度条距离左、上、右、下的距离均为8px，而且单元格里面只显示了一个进度条。

这里只需要控制好单元格绘制区域位置rect即可，你可以在里面添加任意自定义的控件，而且可以添加任意多个，随意排列组合。