Windows图形界面(GUI)-QT-C/C++ - Qt List Widget详解与应用

• 公开视频 -> 链接点击跳转公开课程
• 博客首页 -> ​​​链接点击跳转博客主页

目录

QListWidget概述

使用场景

常见样式

QListWidget属性设置

显示方式 (Display)

交互行为 (Interaction)

高级功能 (Advanced)

QListWidget常见操作

内容处理

增加项目

删除项目

修改项目

查找项目

信号交互

项目选择变化

项目双击

项目右键点击

---

QListWidget概述

QListWidget 是一个基于 QListView 的高级控件，它内置了一个标准的模（QListWidgetItem），适合快速实现列表功能。

QListView 相比，QListWidget 更加简单易用，但在灵活性和复杂数据操作上稍显不足。

使用场景

• 简单的文本或图标列表显示。
• 快速开发无需复杂模型的数据列表。
• 不需要与其他视图共享数据模型的场景。

常见样式

1. 仅文本项目：显示简单的文本列表项。
2. 图标和文本项目：显示带有图标的文本列表项。
3. 自定义项目：通过 QListWidgetItem 或自定义控件实现更加复杂和个性化的列表项。

QListWidget属性设置

显示方式 (Display)

• viewMode：设置显示模式。

  • QListView::ListMode：项目以列表形式显示（垂直排列）。
  • QListView::IconMode：项目以图标形式显示（水平排列）。

• gridSize：设置项目布局的网格大小（适用于 IconMode）。

• iconSize：设置项目图标的大小。

• wordWrap：设置文本是否自动换行。

交互行为 (Interaction)

• dragEnabled：启用拖动功能。

• dragDropMode：设置拖放模式：

  • QAbstractItemView::NoDragDrop：禁用拖放。
  • QAbstractItemView::DragOnly：仅支持拖动。
  • QAbstractItemView::DropOnly：仅支持放置。
  • QAbstractItemView::DragDrop：支持拖动和放置。

• defaultDropAction：设置默认拖放操作（如复制、移动等）。

• editTriggers：设置编辑触发器（如双击、选择变化等）。

• selectionMode：设置选择模式（单选、多选等）。

• selectionBehavior：设置选择行为（选择项目、行或列）。

高级功能 (Advanced)

• layoutMode：设置布局模式（SinglePass 或 Batched）。
• flow：设置项目布局方向（从左到右或从上到下）。
• resizeMode：设置调整模式（固定大小或自动调整）。
• spacing：设置项目之间的间距。
• uniformItemSizes：是否统一项目大小。
• alternatingRowColors：是否启用交替行颜色。

QListWidget常见操作

内容处理

增加项目

void MainWindow::on_pushButton_addItem_clicked()  
{  QListWidgetItem* item = new QListWidgetItem();  item->setText(QString().asprintf("Item %d", ui->listWidget->count()));  item->setIcon(QIcon(":/icons/icon.png"));  ui->listWidget->addItem(item);  
}

删除项目

void MainWindow::on_pushButton_removeItem_clicked()  
{  QListWidgetItem* item = ui->listWidget->currentItem();  delete ui->listWidget->takeItem(ui->listWidget->row(item));  
}

修改项目

void MainWindow::on_pushButton_modifyItem_clicked()  
{  QListWidgetItem* item = ui->listWidget->currentItem();  if (item) {  item->setText("Modified Item");  }  
}

查找项目

void MainWindow::on_pushButton_findItem_clicked()  
{  QList<QListWidgetItem *> items = ui->listWidget->findItems("Search Text", Qt::MatchContains);  for (QListWidgetItem* item : items) {  item->setBackground(Qt::yellow);  // 高亮显示找到的项目  }  
}

信号交互

项目选择变化

connect(ui->listWidget, &QListWidget::itemSelectionChanged, this, [this]() {  QListWidgetItem* item = ui->listWidget->currentItem();  if (item) {  qDebug() << "Selected item ->" << item->text();  }  
});

项目双击

connect(ui->listWidget, &QListWidget::itemDoubleClicked, this, [](QListWidgetItem *item) {  qDebug() << "Item double clicked ->" << item->text();  
});

项目右键点击

    ui->listWidget->setContextMenuPolicy(Qt::CustomContextMenu);connect(ui->listWidget, &QListWidget::customContextMenuRequested, this, [this](const QPoint &pos) {QListWidgetItem* item = ui->listWidget->itemAt(pos);if (item) {QMenu contextMenu(this);QAction* editAction = contextMenu.addAction("Edit");QAction* deleteAction = contextMenu.addAction("Delete");QAction* selectedAction = contextMenu.exec(ui->listWidget->mapToGlobal(pos));if (selectedAction == editAction) {item->setText("Edited via Context Menu");} else if (selectedAction == deleteAction) {delete ui->listWidget->takeItem(ui->listWidget->row(item));}}});