QT使用QTreeWidget控件制作多级折叠菜单

记录项目中实际用到的多级折叠菜单实现方式：项目代码简化版（亲测可用）

开发环境：VS2015+QT5.9.1

多级菜单（左右共两个图标，中间为文字，左图标为固定静态图标，右图标为折叠/展开动态图标），格式如下：图片 菜单标题      图片

          系统配置         ∨

                     基本配置

                     时间配置

         记录管理           >

步骤如下（QTreeWidget布局自行实现）：

（1）UI设计师中Qwidget中拖入QTreeWidget控件，将对象名称更改为treeMenuWidget

        然后，在代码中设置隐藏根节点，如下方式2选1

         ui->treeMenuWidget->header()->setVisible(false);      //FastConfForm.cpp文件中代码隐藏方式

Or

        treeMenuWidget->header()->setVisible(false); ui_FastConfForm.h中代码隐藏方式

（2）FastConfForm.cpp，在根节点下使用代码方式创建多个2级和3级节点（根为第1级节点）

/*FastConfForm.cpp*/

//构造函数中主代码
FastConfForm::FastConfForm(QWidget *parent):
    ui(new Ui::FastConfForm)
{
ui->treeMenuWidget->setColumnWidth(0, 143);				//设置TreeItem元素宽度
ui->treeMenuWidget->setLayoutDirection(Qt::RightToLeft);//对其方式设置：右对齐


//TreeItem右侧图标
QIcon icon;
icon.addPixmap(QPixmap(":/image/pic/tab/Blu_selected.png"), QIcon::Selected, QIcon::Off);
icon.addPixmap(QPixmap(":/image/pic/tab/Blu_nomrmal.png"), QIcon::Selected, QIcon::On);


//新增TreeMenu的二级子节点：配置管理
//QTreeWidgetItem *wItemSysConf = new QTreeWidgetItem(ui->treeMenuWidget,QStringList(QStringLiteral("系统配置")),0);
QTreeWidgetItem *wItemSysConf = new QTreeWidgetItem(ui->treeMenuWidget, nullptr, 0);
wItemSysConf->setIcon(0, icon);			//添加右侧图标
wItemSysConf->setTextAlignment(0, Qt::AlignRight);
QTreeWidgetItem *wItemSysConf_Base  = new QTreeWidgetItem(wItemSysConf, QStringList(QStringLiteral("基本配置")), 1);
QTreeWidgetItem *wItemSysConf_Time = new QTreeWidgetItem(wItemSysConf, QStringList(QStringLiteral("时间配置")), 2);
wItemSysConf->addChild(wItemSysConf_Base  );			//添加三级子节点
wItemSysConf->addChild(wItemSysConf_Time);			//添加三级子节点
wItemSysConf_Base->setTextAlignment(0, Qt::AlignHCenter);
wItemSysConf_Time->setTextAlignment(0, Qt::AlignHCenter);



//新增TreeMenu的二级子节点：记录管理
//QTreeWidgetItem *wItemRecordMgt = new QTreeWidgetItem(ui->treeMenuWidget, QStringList(QStringLiteral("记录管理")),3);
QTreeWidgetItem *wItemRecordMgt = new QTreeWidgetItem(ui->treeMenuWidget, nullptr, 3);
wItemParkMgt->setIcon(0, icon);				  //添加右侧图标
wItemParkMgt->setTextAlignment(0, Qt::AlignRight);


//添加槽函数【槽函数需要在.h文件中声明】
connect(ui->treeMenuWidget, SIGNAL(itemClicked(QTreeWidgetItem*, int)), this, SLOT(showSelectedWidget(QTreeWidgetItem*, int)));


    //设置2级菜单的左侧图标和文件
    setLeftIconAndText(":/image/pic/tab/Blu_nomrmal.png", QString(QStringLiteral("系统配置")), wItemSysConf );
    setLeftIconAndText(":/image/pic/tab/Blu_nomrmal.png", QString(QStringLiteral("记录管理")), wItemRecordMgt );

    //展开默认节点
    expandMenu2Item(wItemSysConf , wItemSysConf_Base  , true);
}


//设置TreeItem的左侧图标和文字
void FastConfForm::setLeftIconAndText(QString strIconPath, QString strText, QTreeWidgetItem *treeWItem2)
{
	QWidget *userStateIcons = new QWidget();
	QHBoxLayout *hLayout = new QHBoxLayout();

	QLabel *m_pLabel = new QLabel();
	QLabel *m_pLabelPic = new QLabel();
	m_pLabel->setFixedSize(98, 20);
	m_pLabel->setText(strText);
	m_pLabelPic->setFixedSize(20, 20);
    m_pLabelPic->setPixmap(QPixmap(strIconPath).scaled(m_pLabel->size(), Qt::IgnoreAspectRatio, Qt::SmoothTransformation));
	m_pLabelPic->setScaledContents(true);
    hLayout->addSpacing(0);
	hLayout->addStretch(0);
	hLayout->setContentsMargins(0, 0, 0, 0);
	hLayout->addWidget(m_pLabel);
    hLayout->addWidget(m_pLabelPic);
	userStateIcons->setLayout(hLayout);
	ui->treeMenuWidget->setItemWidget(treeWItem2, 0, userStateIcons);	//Item添加Widget窗口
}


//单击Tree节点处理（点击：展开/折叠）函数
void FastConfForm::showSelectedWidget(QTreeWidgetItem* item, int column)
{
    //添加调试打印 需要包含头文件《QDebug》 + 设为控制台输出（"调试"-->选择“属性”-->选怎“连接器”-->选怎“系统”-->“子系统”中选择[控制台]），方便调试
	qDebug() << "==";
	curTreeMenu2Val = item->type(); //new QTreeWidgetItem()的第三个参数

    
	QTreeWidgetItem *parent = item->parent();   //获取父节点
	if (NULL != parent) //注意：最顶端项是没有父节点的(根节点隐藏： 二级节点也无父节点)
	{
		curTreeMenu3Val = parent->indexOfChild(item); //item在父项中的节点行号(从0开始)
	}
    else 
	{
        //展开当前二级节点
		QTreeWidgetItem *firstChild = item->child(0);
		expandMenu2Item(item, firstChild, true);
	}
}


//节点展开的处理函数
void FastConfForm::expandMenu2Item(QTreeWidgetItem* itemMenu2, QTreeWidgetItem* itemMenu3, bool bIsSelect)
{
	itemMenu2->isExpanded() ? itemMenu2->setExpanded(false) : itemMenu2->setExpanded(true);

	if (NULL != itemMenu3)
	{
		selectMenu3Item(itemMenu3, bIsSelect);
		if (true == bIsSelect)
		{
			itemMenu2->setSelected(false);
		}
	}
}


//节点是否被选中处理
void FastConfForm::selectMenu3Item(QTreeWidgetItem* item, bool bIsSelect)
{
	item->setSelected(bIsSelect);
}

（3）FastConfForm.h主要函数和变量的声明

class FastConfForm : public QWidget
{
    Q_OBJECT


public:
    explicit FastConfForm(QWidget *parent = 0);
    ~FastConfForm();
    void setLeftIconAndText(QString strIconPath, QString strText, QTreeWidgetItem *treeWItem2);
	void expandMenu2Item(QTreeWidgetItem* itemMenu2, QTreeWidgetItem* itemMenu3, bool bIsSelect);
	void selectMenu3Item(QTreeWidgetItem* item, bool bIsSelect);


//槽函数声明方式
private slots:
	void showSelectedWidget(QTreeWidgetItem *, int);


private:
    Ui::FastConfForm *ui;


	//菜单层级
	int curTreeMenu2Val = 0;
	int curTreeMenu3Val = 0;
};

（4）其他相关逻辑，请自行实现