qt QItemSelectionModel详解

news2024/11/7 10:23:54

1、概述

QItemSelectionModel是Qt框架中提供的一个功能强大且灵活的项选择模型类。它主要用于在用户界面中管理和操作用户选定的项，是实现交互式和响应式应用程序的重要组件。QItemSelectionModel能够帮助开发者创建用户友好和高效的多选列表、表格数据选择等应用场景。它维护了模型中项的选择状态，并允许在视图组件（如QTableView、QTreeView等）中对这些项进行选择操作。

2、重要方法

QItemSelectionModel类提供了多种方法来管理选择项，以下是一些主要的方法：

clear()：清除所有选择项。
clearSelection()：清除当前选择项。
select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags flags)：根据指定的选择范围和选择标志来选择项。
isSelected(const QModelIndex &index) const：检查指定的项是否被选中。
selectedIndexes() const：返回所有选定项的模型索引列表。
currentIndex()const:返回当前项的索引。
setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command):设置当前项的索引，并根据command指定的方式进行选择操作。

3、重要信号

QItemSelectionModel类还提供了多种信号来通知选择状态的变化，以下是一些主要的信号：

selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)：当选择项发生变化时发出此信号，包括新选择的项和被取消选择的项。
currentChanged(const QModelIndex &current, const QModelIndex &previous)：当当前项发生变化时发出此信号，包括新的当前项和之前的当前项。
currentColumnChanged(const QModelIndex &current，const QModelIndex &previous)：当当前列发生变化时发出。
currentRowChanged(const QModelIndex &current, const QModelIndex &previous)：当当前行发生变化时发出。

这些信号允许开发者在选择状态发生变化时执行特定的操作，如更新用户界面、处理数据等。

4、选择标志(SelectionFlags)

以下是QltemSelectionModel类中一些常见的选择标志及其简要介绍：

QItemSelectionModel::NoUpdate:不更新选择。
QItemSelectionModel::Clear:清除所有选择。
QItemSelectionModel::Select:选中指定项。
QItemSelectionModel::Deselect:取消选中指定项。
QItemselectionModel::Toggle:切换指定项的选中状态。
QItemSelectionModel::Current:设置当项。
QItemSelectionModel::Rows:对行进行选择操作。
QItemSelectionModel::Columns:对列进行选择操作。

// 创建一个QStandardItemModel模型
QStandardItemModel *model = new QStandardItemModel(4, 4);
for (int i = 0; i < 4; ++i) {
	for (int j = 0; j < 4; ++j) {
		QStandardItem *item = new QStandardItem(QString("%1").arg(i * 4 + j + 1));
		model->setItem(i, j, item);
	}
}

// 创建一个QTableView视图并设置模型
QTableView *view = new QTableView;
view->setModel(model);

// 创建一个QItemSelectionModel选择模型并设置给视图
QItemSelectionModel *selectionModel = new QItemSelectionModel(model);
view->setSelectionModel(selectionModel);

// 选择指定的项（例如，选择第一行和第二行的所有项）
QModelIndex index1 = model->index(0, 0);
QModelIndex index2 = model->index(1, model->columnCount() - 1);
QItemSelection selection(index1, index2);
selectionModel->select(selection, QItemSelectionModel::Select | QItemSelectionModel::Rows);

QObject::connect(selectionModel, &QItemSelectionModel::selectionChanged,
				 [](const QItemSelection &selected, const QItemSelection &deselected) {
					 qDebug() << "Selection changed:";
					 qDebug() << "Selected:" << selected.indexes();
					 qDebug() << "Deselected:" << deselected.indexes();
				 });

QObject::connect(selectionModel, &QItemSelectionModel::currentChanged,
				 [](const QModelIndex &current, const QModelIndex &previous) {
					 qDebug() << "Current changed:" << "Current" << current << "Previous" << previous;
				 });

// 显示视图
view->show();