QTreeWidget和QDockWidget的讲解和使用

QTreeWidget的每个节点都是一个QTreeWidgetltem对象，添加一个节点前需先创建它，并做
好相关设置。

创建节点的语句是：

item=new QTreeWidgetItem(Mainwindow::itTopItem);

QTreeWidgetltem的 **setlcon() 和 setText()**都需要传递一个列号作为参数，指定对哪个列进行设置。列号可以直接用数字，但是为了便于理解代码和统一修改，在MainWindow里定义了枚举类型treeColNum，colltem表示第1列，colltemlype表示第2列。setFlags0函数设置节点的一些属性标记，是Qt:ltemFlag枚举类型常量的组合。setData()函数为节点的某一列设置一个角色数据，setData（）函数原型为：

void QTreewidgetItem::setData(int column,int role,const QVariant &value)

其中，column是列号，role是角色的值，value是一个QVariant类型的数。

代码中设置节点数据的语句是：

item->setData(Mainwindow::colItem,Qt::UserRole,QVariant(dataStr));

它为节点的第1列，角色 Qt：UserRole ，设置了一个字符串数据dataStr。Qt:UserRole是枚举类型Qt::ItemDataRole中一个预定义的值，关于节点的角色和Qt:ItemDataRole在后面文章详细介绍。
创建并设置好节点后， 用QTreeWidget::addTopLevelltem()函数将节点作为顶层节点添加到目录树。

主要属性如下：

QDockWidget::DockWidgetClosable:停靠区可关闭。
QDockWidget:DockWidgetMovable:停靠区可移动。
QDock Widget:DockWidgetFloatable:停靠区可浮动。
QDock Widget:Dock Widget VerticalTitleBar:在停靠区左侧显示垂直标题栏。
QDock Widget::AlDockWidgetFeatures:使用以上所有特征。
QDock Widget::NoDockWidgetFeatures:不能停靠、移动和关闭。

滚动区域用于显示一个画面中的子部件的内容。如果部件超过画面的大小，视图可以提供滚动条，这样就都可以看到部件的整个区域。

其中 ExQTreeWidget.h ：

#ifndef EXQTREEWIDGET_H
#define EXQTREEWIDGET_H
#include <QMainWindow>
#include <QLabel>
#include <QTreeWidgetItem>
#include <QFileDialog>
namespace Ui {
class ExQTreeWidget;
class ExQTreeWidget : public QMainWindow
    Q_OBJECT
public:
    enum treeItemType {         //枚举，节点类型
        itemRoot,
        itemFile,
        itemImage
    enum treeColNum {           //目录树列表的编号
        colItem = 0,
        colItemType = 1
    explicit ExQTreeWidget(QWidget *parent = nullptr);
    ~ExQTreeWidget();
    void initTree();                                                //初始化根节点（唯一）
    void addFolderItem(QTreeWidgetItem *parItem, QString dirName);  //添加目录
    void addImageItem(QTreeWidgetItem *parItem, QString fileName);  //添加图片文件
    QString getFinalFolderName(const QString &pathName);            //从完整的路径里面，获取最后的文件夹名称
    void changeItemCaption(QTreeWidgetItem* parItem);               //遍历item下面的所有节点
    void displayImage(QTreeWidgetItem* item);                       //显示当前item的图片（默认以适配高度）
private slots:
    void on_actAddFolder_triggered();                               //增加文件夹
    void on_actAddFile_triggered();                                 //添加图片文件
    void on_actDeleFile_triggered();                                //删除节点
    void on_actScanItems_triggered();                               //遍历所有的顶层节点(本处只有一个root顶层节点)
    void on_actAdaptiveHeight_triggered();                          //图片自动适应高度
    void on_actAdaptiveWidth_triggered();                           //图片自动适应宽度
    void on_actAmplification_triggered();                           //放大
    void on_actShrink_triggered();                                  //缩小
    void on_actZoomRealSize_triggered();                            //还原
    void on_actDockFloating_triggered(bool check);                  //设置Dock窗口是否浮动
    void on_actDockVisible_triggered(bool checked);                 //设置Dock窗口是否隐藏不显示
    void on_actQiut_triggered();                                    //退出
    void on_treeFiles_currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous);  //当前节点变化的时候，自动加载当前图片
    void on_dockWidget_visibilityChanged(bool visible);             //单击DockWidget组件的标题栏的关闭按钮时候，会隐藏在停靠区域，并且发射信号visibilityChanged;  停靠区域可见性变化
    void on_dockWidget_topLevelChanged(bool topLevel);              //当拖动DockWidget组件，使其浮动或者停靠时候，会发射信号topLevelChanged;  更新其Action的状态
private:
    Ui::ExQTreeWidget *ui;
    QLabel *m_labFlie;      //状态栏显示当前文件路径
    QPixmap m_curPixmap;    //显示当前文件图片
    float   m_ratio;        //图片缩放比例
#endif // EXQTREEWIDGET_H

和 ExQTreeWidget.cpp ：如下