Qt应用开发(基础篇)——列表视图 QListView

一、前言

        QListView类继承于QAbstractItemView类,提供了一个列表或者图标视图的模型。

        视图基类 QAbstractItemView

Qt应用开发(基础篇)——列表视图 QListView_第1张图片

       QListView效果相当于Windows文件夹右键->查看->图标和列表,使用setViewMode()设置视图模式,并且提供setIconSize()函数设置图标模型下的项大小,显示大图标或者小图标。

Qt应用开发(基础篇)——列表视图 QListView_第2张图片Qt应用开发(基础篇)——列表视图 QListView_第3张图片

        QListView不显示标题,如果需要显示标题,使用QTreeView,不显示子节点,只显示一列,效果也是和QListView一样的。

二、QListView类

1、属性

1)batchSize

        如果layoutMode设置为Batched,则此属性保存每个批次中布局的项目数量,默认为100。

int batchSize() const
void setBatchSize(int batchSize)
2)layoutMode

        该属性表示项的布局模式,确定项的布局是立即进行还是延迟进行

        当模式是SinglePass(默认)时,所有的项目都是一次性布置的。

        当模式为Batched时,在处理事件时,项目以batchSize数量批次进行布局。这使得它可以即时查看和交互可见的项目,而其余的是布局。

QListView::LayoutMode layoutMode() const
void setLayoutMode(QListView::LayoutMode mode)
enum LayoutMode 描述
QListView::SinglePass 直接展示
QListView::Batched 根据batchSize进行布局展示

3)flow

        该属性表示列表的布局方向,默认为TopToBottom从上到下布局。

QListView::Flow flow() const
void setFlow(QListView::Flow flow)
enum QListView::Flow 描述
QListView::LeftToRight 项目从左到右排列
QListView::TopToBottom 项目从上到下排列

Qt应用开发(基础篇)——列表视图 QListView_第4张图片Qt应用开发(基础篇)——列表视图 QListView_第5张图片

4)gridSize

        该属性表示布局网格的大小,默认为没设置,没有网格,设置之后将打开网格布局,可以由此功能来调整项之间的间距。

QSize gridSize() const
void setGridSize(const QSize &size)
5)isWrapping

        该属性表示当可见区域中没有更多空间时,项目布局是否换行,默认不换行。布局换行的位置取决于flow属性。

bool isWrapping() const
void setWrapping(bool enable)
6)itemAlignment

        该属性表示每一项在它的单元格内的对齐方式。

Qt::Alignment itemAlignment() const
void setItemAlignment(Qt::Alignment alignment)
7)modelColumn

        该属性表示模型中可见的列,默认情况该属性为0,表示将显示模型中的第一列。

int modelColumn() const
void setModelColumn(int column)
8)movement

        该属性表示列表中的项的移动策略,默认为不可移动。

QListView::Movement movement() const
void setMovement(QListView::Movement movement)
enum QListView::Movement 描述
QListView::Static 项目不能被用户移动
QListView::Free 项目可以被用户自由移动
QListView::Snap 项目移动时需要和网格对齐,固定在网格上

9)resizeMode

        该属性表示当列表调整大小的时候是否自动调整布局,默认不调整。

QListView::ResizeMode resizeMode() const
void setResizeMode(QListView::ResizeMode mode)
enum QListView::ResizeMode 描述
QListView::Fixed 第一次显示的时候布局
QListView::Adjust 每次调整大小的时候都会重新布局

10)selectionRectVisible

        该属性表示选择矩形是否可视,默认为false。

        只有当选择模式为可选择多个项目的模式时,选择矩形才会显示,所以需要设置SelectionMode(父类属性)不为QAbstractItemView::SingleSelection

bool isSelectionRectVisible() const
void setSelectionRectVisible(bool show)
11)space

        该属性布局中项周围的空间的大小,默认为0。

int spacing() const
void setSpacing(int space)
12)uniformItemSizes

        该属性表示listview中是否全部的项都使用同样的尺寸,默认为false。

bool uniformItemSizes() const
void setUniformItemSizes(bool enable)
13)viewMode

        该属性表示listview中显示的策略。

QListView::ViewMode viewMode() const
void setViewMode(QListView::ViewMode mode)
enum QListView::ViewMode 描述
QListView::ListMode 列表模式
QListView::IconMode 图标模式

14)wordWrap

        该属性表示列表中是否文本换行,默认为不换行false。如果此属性为true,则项目文本在必要的换行处换行。

        这里要注意就算换行了,也不会展开单元格来为文本腾出空间。需要设置textElideMode(父类属性)来设置是否为不显示的文本显示“...”。

bool wordWrap() const
void setWordWrap(bool on)

2、公共方法

1)clearPropertyFlags

        清除listview特殊的标识。

void clearPropertyFlags()
2)isRowHidden

        返回索引下的行是否隐藏。

bool isRowHidden(int row) const

3、信号

1)indexesMoved

        当指定的索引在视图中移动时发出此信号。

void indexesMoved(const QModelIndexList &indexes)

你可能感兴趣的:(Qt5从入门到精通-应用开发,qt,c++,上位机,PC)