Qt5 Tutorial QListWidget - 2020

In this tutorial, we will learn QListWidget.

There is a big difference between QListWidget and QListView:

The QListView uses MVC, and will be covered in later section.

In this tutorial, we'll populate the items of the widget list and then when a button is clicked, it will make some changes on the currently selected item (text color and item background color).

Here is the code: dialog.cpp:

#include "dialog.h"
#include "ui_dialog.h"

Dialog::Dialog(QWidget *parent) :
    QDialog(parent),
    ui(new Ui::Dialog)
{
    ui->setupUi(this);

    // populate the items of the list
    for(int i = 0; i < 10; i++)
    {
        ui->listWidget->addItem("Item " + QString::number(i));
    }
}

Dialog::~Dialog()
{
    delete ui;
}

void Dialog::on_pushButton_clicked()
{
    // Get the pointer to the currently selected item.
    QListWidgetItem *item = ui->listWidget->currentItem();

    // Set the text color and its background color using the pointer to the item.
    item->setTextColor(Qt::white);
    item->setBackgroundColor(Qt::blue);
}

Note that we set the color of the text and background color after we get the ListWidgetItem: by calling QListWidgetItem * QListWidget::currentItem() const.