Qt QListWidgetItem 多行

Question

我有一个非常简单的QListWidget 对象，我想建立一个文件夹列表。 当我将一个项目添加到我的列表中时，我会这样做：

void LessCC::on_addFolderButton_clicked()
{
    QString dirName = QFileDialog::getExistingDirectory(this, tr("Choose Directory"), QDir::homePath(), QFileDialog::ShowDirsOnly);
    QListWidgetItem* newItem = new QListWidgetItem(QIcon(":/resources/icons/folder.png"), dirName, 0, 0);
    this->ui->folderListWidget->addItem(newItem);
}

这是可行的，但我希望我的项目有多行或多列信息（具有不同的样式）。

我听说过 QStyledItemDelegate 但我不太明白它是如何工作的，因为我发现的所有其他 解决方案对于这样的 simple( ?) 事情。

这是唯一解决方案，还是我没有看到更简单的解决方案？

希望有人可以帮助我。

Answer 1

在不确切了解您希望列表项的外观的情况下提出“最佳”解决方案有点困难，但我们会试一试。

实际上在 Qt 线程 here 上有一篇很棒的帖子，最后给出了他们用来创建列表的所有代码，就像他们在顶部显示的那样。

基本上，每个项目都有一个大图标，右侧有一个标题和描述文本，每个都有不同的样式。

创建自定义委托听起来很可怕，但它基本上只是为列表提供自定义小部件。它本质上就像一个模板。您定义您希望列表项的外观，并使用列表中的数据对其进行绘制。您可以从 QAbstractItemDelegate 继承。

#include <QPainter>
#include <QAbstractItemDelegate>

class ListDelegate : public QAbstractItemDelegate
{
    public:
       ListDelegate(QObject *parent = 0);

       void paint ( QPainter * painter, const QStyleOptionViewItem & option, const QModelIndex & index ) const;
       QSize sizeHint ( const QStyleOptionViewItem & option, const QModelIndex & index ) const;

       virtual ~ListDelegate();
};

最大的工作是编写paint函数的代码。我将在这里仅展示基础知识，但您可以参考上面的链接以获取更长的示例。

ListDelegate::ListDelegate(QObject *parent)
: QAbstractItemDelegate(parent)
{

}

void ListDelegate::paint ( QPainter * painter, const QStyleOptionViewItem & option, const QModelIndex & index ) const
{
        QRect r = option.rect;

        QPen fontPen(QColor::fromRgb(51,51,51), 1, Qt::SolidLine);

        if(option.state & QStyle::State_Selected)
            {
            painter->setBrush(Qt::cyan);
            painter->drawRect(r);

        } 
            else 
            {
            //BACKGROUND ALTERNATING COLORS
            painter->setBrush( (index.row() % 2) ? Qt::white : QColor(252,252,252) );
            painter->drawRect(r);
        }

            painter->setPen(fontPen);

        //GET TITLE, DESCRIPTION AND ICON
        QIcon ic = QIcon(qvariant_cast<QPixmap>(index.data(Qt::DecorationRole)));
        QString title = index.data(Qt::DisplayRole).toString();
        QString description = index.data(Qt::UserRole).toString();

        int imageSpace = 10;
        if (!ic.isNull()) 
            {
            //ICON
            r = option.rect.adjusted(5, 10, -10, -10);
            ic.paint(painter, r, Qt::AlignVCenter|Qt::AlignLeft);
            imageSpace = 55;
        }

        //TITLE
        r = option.rect.adjusted(imageSpace, 0, -10, -30);
        painter->setFont( QFont( "Lucida Grande", 6, QFont::Normal ) );
        painter->drawText(r.left(), r.top(), r.width(), r.height(), Qt::AlignBottom|Qt::AlignLeft, title, &r);

        //DESCRIPTION
        r = option.rect.adjusted(imageSpace, 30, -10, 0);
        painter->setFont( QFont( "Lucida Grande", 5, QFont::Normal ) );
        painter->drawText(r.left(), r.top(), r.width(), r.height(), Qt::AlignLeft, description, &r);

}

QSize ListDelegate::sizeHint ( const QStyleOptionViewItem & option, const QModelIndex & index ) const
{
   return QSize(200, 60); // very dumb value
}

ListDelegate::~ListDelegate()
{

}

所以您可以在这段代码中看到我们从列表中获取三位数据。图标、标题和描述。然后我们显示绘制图标，并绘制我们喜欢的两个文本字符串。但重要的部分是获取数据本身。我们基本上是要求列表使用传递给我们的“索引”向我们提供数据。

QIcon ic = QIcon(qvariant_cast<QPixmap>(index.data(Qt::DecorationRole)));
QString title = index.data(Qt::DisplayRole).toString();
QString description = index.data(Qt::UserRole + 1).toString();

您会注意到，每条信息都是使用不同的“角色”检索的。通常，一个列表只显示一件事——通过 DisplayRole 访问。图标存储在DecorationRole 中。但是如果你想存储更多的东西，那么你就开始使用 UserRole。您可以使用 UserRole、UserRole +1、UserRole +2 等存储一大堆东西......

那么，您如何将所有这些信息存储在每个项目中。简单...

QListWidgetItem *item = new QListWidgetItem();
item->setData(Qt::DisplayRole, "Title");
item->setData(Qt::UserRole, "Description");
myListWidget->addItem(item);

最后，如何使用您喜欢的新委托使列表显示项目？

myListWidget->setItemDelegate(new ListDelegate(myListWidget));

希望这能澄清一点。