QTreeView的使用总结1

一、概述

Qt中 treeview的典型使用方法是model/view。这里不介绍model、view、delegate的工作方式。

model 、delegate与treeview的关联过程如下:

 

ui.treeView->setModel( pModel );
ui.treeView->setItemDelegate( pDelegate );

 

 

 

 

 

二、设置TreeView的头部信息

1、设置表头

      方法一:void QStandardItemModel::setHorizontalHeaderLabels( const QStringList & labels );

              参数labels指定一个QStringList对象,该对象中的每个字符串对应一个列的名字。

      方法二:void QStandardItemModel::setHorizontalHeaderItem(int column, QStandardItem * item);

              参数 column指定列的索引,item指定列的内容

例子:分别使用上述两种方法设置TreeView头部信息

方法一:

 

QStringList ColumnStringList;
	ColumnStringList << QStringLiteral("车库") << QStringLiteral("信息");
	model->setHorizontalHeaderLabels( QStringList() << QStringLiteral("车库")<< QStringLiteral("信息") );
	QStandardItem* pColumnItem = model->horizontalHeaderItem(0);
	pColumnItem->setIcon( QIcon(":/TreeView_T/Resources/qt-logo.png") );
	pColumnItem->setToolTip(QStringLiteral("这是第一列") );

	pColumnItem = model->horizontalHeaderItem(1);
	pColumnItem->setIcon(QIcon(":/TreeView_T/Resources/qt-logo.png") );
	pColumnItem->setToolTip(QStringLiteral("这是第二列"));

方法二:

 

 

QStandardItem* pItem = new QStandardItem( QIcon(":/TreeView_T/Resources/qt-logo.png"), QStringLiteral("车库"));
	pItem->setToolTip( QStringLiteral("这是第一列"));

	QStandardItem* pItem1 = new QStandardItem( QIcon(":/TreeView_T/Resources/qt-logo.png"), QStringLiteral("信息") );
	pItem1->setToolTip( QStringLiteral("这是第二列"));

	model->setHorizontalHeaderItem( 0, pItem);
	model->setHorizontalHeaderItem( 1, pItem1);

 

2、隐藏表头

       通过QTreeView中的 header()->hide(),可以隐藏表头。

 

效果如下:

 

QTreeView的使用总结1_第1张图片

三、填充行与列

(1)、可以在行头部添加图标

例子:

 

QMap m_IconMap;//存放公共图标
	QMap m_CarportIconMap;  //车库公共图标

	//初始化图标库
	m_CarportIconMap[QStringLiteral("Port1")] = QIcon(QStringLiteral(":/cars1/Resources/cars1/3942000.ico"));
	m_CarportIconMap[QStringLiteral("Port2")] = QIcon(QStringLiteral(":/cars1/Resources/cars1/3942001.ico"));
	m_CarportIconMap[QStringLiteral("Port3")] = QIcon(QStringLiteral(":/cars1/Resources/cars1/3942002.ico"));
	m_CarportIconMap[QStringLiteral("Port4")] = QIcon(QStringLiteral(":/cars1/Resources/cars1/3942003.ico"));
	m_CarportIconMap[QStringLiteral("Port5")] = QIcon(QStringLiteral(":/cars1/Resources/cars1/3942004.ico"));

	m_IconMap[QStringLiteral("Audi")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/audi.ico") );
	m_IconMap[QStringLiteral("Bmw")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/bmw.ico") );
	m_IconMap[QStringLiteral("Buick")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/Buick.ico") );
	m_IconMap[QStringLiteral("Cadillac")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/cadillac.ico") );
	m_IconMap[QStringLiteral("Ferrari")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/ferrari.ico") );
	m_IconMap[QStringLiteral("Ford")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/ford.ico") );
	m_IconMap[QStringLiteral("Hyundai")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/hyundai.ico") );
	m_IconMap[QStringLiteral("Lexus")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/lexus.ico") );
	m_IconMap[QStringLiteral("Mazda")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/mazda.ico") );
	m_IconMap[QStringLiteral("Mercedesbenz")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/mercedesbenz.ico") );
	m_IconMap[QStringLiteral("Nissan")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/nissan.ico") );
	m_IconMap[QStringLiteral("Toyota")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/toyota.ico") );
	m_IconMap[QStringLiteral("Volkswagen")] = QIcon( QStringLiteral(":/cars_logo/Resources/cars_logo/Volkswagen.ico") );

	QStandardItem* pStandardItem = NULL;
	QStandardItem* pStandardChildItem = NULL;
	int i = 0;
	QMap::const_iterator it1 = m_CarportIconMap.constBegin();
	for (QMap::const_iterator it = m_IconMap.constBegin(); it != m_IconMap.constEnd(); ++it)
	{
		if (i % 3 == 0)
		{
			pStandardItem = new QStandardItem((it1 + (i / 3)).value(), (it1 + (i / 3)).key());
			model->appendRow(pStandardItem);
		}
		pStandardChildItem = new QStandardItem( it.value(), it.key());
		pStandardItem->appendRow( pStandardChildItem );
		pStandardItem->setChild( pStandardChildItem->row(),1, new QStandardItem( QString("this is %1").arg( it.key()) ));
		++i;
	}

效果如下:

 

QTreeView的使用总结1_第2张图片


(2)、可以在行头添加单选框
使用QStandardItem时与checkbox相关的几个函数:

       void QStandardItem::setCheckable(bool checkable);     //设置Item是否有复选框功能

       void QStandardItem::setCheckState(Qt::CheckState state);    //设置Item的复选状态

       Qt::CheckState有三种状态:Qt::Unchecked :未选中状态、Qt::PartiallyChecked:部分选中状态(层次模型中的子项有一部分处于选中状态)、Qt::Checked:选中状态

       void QStandardItem::setTristate(bool tristate);    //设置Item是否是三态的(Qt::Unchecked、Qt::PartiallyChecked、Qt::Checked)

       Qt::CheckState QStandardItem::checkState() const ;    //返回Item的复选状态

       bool QStandardItem::isCheckable() const ;     //判断Item是否是可复选的

       bool QStandardItem::isTristate() const ;     //判断Item是否是三态的

例子:

 

QStandardItem* pStandardItem = NULL;
	QStandardItem* pStandardChildItem = NULL;
	int i = 0;
	QMap::const_iterator it1 = m_CarportIconMap.constBegin();
	for (QMap::const_iterator it = m_IconMap.constBegin(); it != m_IconMap.constEnd(); ++it)
	{
		if (i % 3 == 0)
		{
			pStandardItem = new QStandardItem((it1 + (i / 3)).value(), (it1 + (i / 3)).key());

			//设置Item为三态
			pStandardItem->setTristate( true );

			//设置Item为部分选中状态
			pStandardItem->setCheckState( Qt::PartiallyChecked );

			model->appendRow(pStandardItem);
		}
		pStandardChildItem = new QStandardItem( it.value(), it.key());
		
		//设置Item具有单选能力
		pStandardChildItem->setCheckable( true );

		//设置Item不具有三态
		pStandardChildItem->setTristate( false );

		//设置Item为选中状态
		pStandardChildItem->setCheckState( /*Qt::PartiallyChecked*/  Qt::Checked );

		pStandardItem->appendRow( pStandardChildItem );
		pStandardItem->setChild( pStandardChildItem->row(),1, new QStandardItem( QString("this is %1").arg( it.key()) ));

		++i;
	}

效果如下:

 

QTreeView的使用总结1_第3张图片
 

(3)三态复选框的智能关联(如果子项全选,父级也需要全选,如果子项部分选,父级就不完全选)

 

/*
QTreeView在QStandardItemModel设置复选框后,并不是按照规则的,需要通过代码设置
三态复选框主要体现在树形控件里,如果子项目全选,父级需要全选,如果子项目部分选择,父级就是不完全选
*/
/*
item checkbox单击响应函数
*/
void MyDelegate::treeItem_CheckChanged(QStandardItem* item)
{
	if (item == nullptr)
	{
		return;
	}
	if (item->isCheckable() )
	{
		//如果item是存在复选框的,那么就进行下面的操作
		Qt::CheckState state = item->checkState(); //获取当前的选择状态
		if (item->isTristate())
		{
			//如果item是三态的,说明可以对子目录进行全选和全不选的设置
			if (state != Qt::PartiallyChecked)
			{
				//当前是选中状态,需要对其子项目设置为全选
				treeItem_CheckAllChild(item, state == Qt::Checked ? true : false);
			}
		}
		else
		{
			//说明是两态的,两态会对父级的三态有影响
			//判断兄弟节点的情况
			treeItem_CheckChildChanged( item );
		}
	}
} 

//
// \brief 递归设置所有的子项目为全选或全不选状态
// \param item 当前项目
// \param check true时为全选,false时全不选
//
void MyDelegate::treeItem_CheckAllChild(QStandardItem* item, bool check)
{
	if (item == nullptr)
	{
		return;
	}
	int rowCount = item->rowCount();
	for (int i = 0; i < rowCount; ++i )
	{
		QStandardItem* childItems = item->child( i );
		treeItem_checkAllChild_recursion( childItems, check);
	}

	if (item->isCheckable())
	{
		item->setCheckState( check ? Qt::Checked : Qt::Unchecked);
	}
}

void MyDelegate::treeItem_checkAllChild_recursion(QStandardItem* item, bool check)
{
	if (item == nullptr)
	{
		return;
	}
	int rowCount = item->rowCount();
	for (int i = 0; i < rowCount; ++i)
	{
		QStandardItem* childItems = item->child( i );
		treeItem_checkAllChild_recursion( childItems, check);
	}
	if (item->isCheckable())
	{
		item->setCheckState( check ? Qt::Checked : Qt::Unchecked );
	}
}

//
// \brief 根据子节点的改变,更改父节点的选择情况
// \param item
//
//此函数也是一个递归函数,首先要判断的是父级是否到达顶层
//,到达底层作为递归的结束,然后通过函数checkSibling判断当前的兄弟节点的具体情况
//
void MyDelegate::treeItem_CheckChildChanged(QStandardItem* item)
{
	if (nullptr == item)
	{
		return;
	}
	Qt::CheckState siblingState = checkSibling( item );
	QStandardItem* parentItem = item->parent();
	if (nullptr == parentItem)
	{
		return;
	}
	if (Qt::PartiallyChecked == siblingState)
	{
		if (parentItem->isCheckable() && parentItem->isTristate())
			parentItem->setCheckState( Qt::PartiallyChecked );
	}
	else if (Qt::Checked == siblingState)
	{
		if (parentItem->isCheckable())
			parentItem->setCheckState( Qt::Checked);
	}
	else
	{
		if (parentItem->isCheckable())
			parentItem->setCheckState( Qt::Unchecked );
	}
	treeItem_CheckChildChanged( parentItem );
}

//
// \brief 测量兄弟节点的情况,如果都选中返回Qt::Checked,都不选中Qt::Unchecked, 
// \不完全选中返回Qt::PartiallyChecked
// \param item
// \return 
Qt::CheckState MyDelegate::checkSibling(QStandardItem* item)
{
	//先通过父节点获取兄弟节点
	QStandardItem* parent = item->parent();
	if (nullptr == parent)
	{
		return item->checkState();
	}
	int brotherCount = parent->rowCount();
	int checkedCount(0), unCheckedCount( 0 );

	Qt::CheckState state;
	for (int i = 0; i < brotherCount; ++i)
	{
		QStandardItem* siblingItem = parent->child( i );
		state = siblingItem->checkState();
		if (Qt::PartiallyChecked == state)
		{
			return Qt::PartiallyChecked;
		}
		else if (Qt::Unchecked == state)
		{
			++unCheckedCount;
		}
		else
		{
			++checkedCount;
		}
		if (checkedCount > 0 && unCheckedCount > 0)
		{
			return Qt::PartiallyChecked;
		}
	}
	if (unCheckedCount > 0)
	{
		return Qt::Unchecked;
	}
	return Qt::Checked;
}

 

四、QStandardItemModel的角色控制

 

<一>、自定义角色的使用

        在MFC中,树形控件CTreeCtrl是通过SetItemData函数来对节点设置一个指针的值,这个值可以是个指针、DWORD值、自定义的标志或者自定义类型的指针。Qt的TreeView比MFC的CTreeCtrl封装的更好,其功能也更强大,以至于可以给每个节点设定非常非常多的值(只要内存足够)。QTreeView只负责显示渲染,数据都有Model来负责管理。我们可以使用setData函数来为节点设置数据。

        setData函数在Model和Item中都有,功能都一样。QStandardItemModel中setData函数的定义:

        virtual bool setData( const QModelIndex & index,   const  QVarient & value,  int role = Qt::EditRole);

QStandardItem中setData的定义是:

        virtual void setData( const QVaritant & value,  int role = Qt::UserRole + 1 );

         参数:value:是要设置的值, role是一个int型数据,Qt中把这个称为role角色,实际就是对设定值的标定,因为item可以设置许多值,这就需要一个用以区分的标志,这个区分标志就叫角色。Qt已经把经常用到的角色内容定义好了,我们可以自定义角色标志,但不要和定义好的那些标志冲突,否则会不起作用。如果显示文字就用Qt::DisplayRole,要告诉QTreeView需要改变背景颜色,就标定Qt::BackgroundRole,要改变字体就标定Qt::FontRole等等。从中可以看出,role就是一个标示,用来标定存放在item李淼的值集体用于什么功能,系统默认的role参看Qt::ItemDataRole枚举。自定义的Role,就从Qt::UserRole开始往上加。

例子:

        定义用户自定义的role:

 

#define ROLE_MARK_TYPE Qt::UserRole + 100
#define MARK_FOLDER 1
#define MARK_ITEM   2

       为Item设置数据

 

 

QStandardItem* pStandardItem = NULL;
	QStandardItem* pStandardChildItem = NULL;
	int i = 0;
	QMap::const_iterator it1 = m_CarportIconMap.constBegin();
	for (QMap::const_iterator it = m_IconMap.constBegin(); it != m_IconMap.constEnd(); ++it)
	{
		if (i % 3 == 0)
		{
			pStandardItem = new QStandardItem((it1 + (i / 3)).value(), (it1 + (i / 3)).key());

			pStandardItem->setCheckable( true );
			//设置Item为三态
			pStandardItem->setTristate( true );

			//为Item设置自定义role
			pStandardItem->setData( MARK_FOLDER, ROLE_MARK_TYPE );  //标记该item为文件夹

			model->appendRow(pStandardItem);
		}
		pStandardChildItem = new QStandardItem( it.value(), it.key());
		
		//设置Item具有单选能力
		pStandardChildItem->setCheckable( true );

		//设置Item不具有三态
		pStandardChildItem->setTristate( false );

		//为Item设置自定义role
		pStandardChildItem->setData( MARK_ITEM, ROLE_MARK_TYPE ); //标记该Item为具体的项
		pStandardItem->appendRow( pStandardChildItem );
		pStandardItem->setChild( pStandardChildItem->row(),1, new QStandardItem( QString("this is %1").arg( it.key()) ));

		++i;
	}

        在鼠标左键点击TreeView中的Item时,通过对话框显示当前点击的Item的类型:是文件夹还是具体的项?

 

 

bool MyDelegate::editorEvent(QEvent * event, QAbstractItemModel * model
	, const QStyleOptionViewItem & option, const QModelIndex & index)
{
	QStandardItemModel* pModel = static_cast( model );
	if (event->type() == QEvent::MouseButtonPress)
	{
		if (static_cast(event)->button() == Qt::LeftButton)
		{
			if (model->data(index, ROLE_MARK_TYPE) == MARK_FOLDER)
			{
				QMessageBox::information(NULL, "TypeInfo", "this is folder!", QMessageBox::Ok);
			}
			else if (model->data(index, ROLE_MARK_TYPE) == MARK_ITEM )
			{
				QMessageBox::information(NULL, "TypeInfo", "this is item!", QMessageBox::Ok);
			}
		}
	}
	return QStyledItemDelegate::editorEvent( event, model, option, index );
}


<二>、系统角色的使用
        Qt定义好的角色如下:
QTreeView的使用总结1_第4张图片

 

 

 

例子:

 

bool MyDelegate::editorEvent(QEvent * event, QAbstractItemModel * model
	, const QStyleOptionViewItem & option, const QModelIndex & index)
{
	QStandardItemModel* pModel = static_cast( model );
	if (event->type() == QEvent::MouseButtonPress)
	{
		if (static_cast(event)->button() == Qt::LeftButton)
		{
			if (model->data(index, ROLE_MARK_TYPE) == MARK_FOLDER)
			{
				QMessageBox::information(NULL, "TypeInfo", "this is folder!", QMessageBox::Ok);
			}
			else if (model->data(index, ROLE_MARK_TYPE) == MARK_ITEM )
			{
				QMessageBox::information(NULL, "TypeInfo", "this is item!", QMessageBox::Ok);
			}

			//设置Item的图标覆盖为某一颜色
			pModel->itemFromIndex(index)->setData( QColor(0, 255, 0, 200), Qt::DecorationRole);

			//设置气泡提示信息
			pModel->itemFromIndex(index)->setData(QString("Tip:%1").arg(pModel->itemFromIndex(index)->text() ), Qt::ToolTipRole);

			//设置背景色
			pModel->itemFromIndex(index)->setData(QColor(232, 209, 57, 200), Qt::BackgroundRole);
		}
	}
	return QStyledItemDelegate::editorEvent( event, model, option, index );
}

效果:

 

QTreeView的使用总结1_第5张图片


 

 

参看:http://www.tuicool.com/articles/FvaYNn

参看:http://www.it165.net/pro/html/201405/14029.html

你可能感兴趣的:(Win)