【Qt】控件——Qt多元素控件、常见的多元素控件、多元素控件的使用、List Widget、Table Widget、Tree Widget

文章目录

  • Qt
    • Qt多元素控件
      • [List Widget](#List Widget)
      • [Table Widget](#Table Widget)
      • [Tree Widget](#Tree Widget)

Qt

Qt多元素控件

List Widget

使用 QListWidget 能够显示一个纵向的列表。

属性 说明
currentRow 当前被选中的是第几行。
count 一共有多少行。
sortingEnabled 是否允许排序。
isWrapping 是否允许换行。
itemAlignment 元素的对齐方式。
selectRectVisible 被选中的元素矩形是否可见。
spacing 元素之间的间隔。

方法 说明
addItem(const QString& label)、addItem(QListWidgetItem *item) 列表中添加元素。
currentItem() 返回 QListWidgetItem*,表示当前选中的元素。
setCurrentItem(QListWidgetItem* item) 设置选中哪个元素。
setCurrentRow(int row) 设置选中第几行的元素。
insertItem(const QString& label, int row)、insertItem(QListWidgetItem *item, int row) 在指定的位置插入元素。
item(int row) 返回 QListWidgetItem*,表示第 row 行的元素。
takeItem(int row) 删除指定行的元素,返回 QListWidgetItem*,表示是哪个元素被删除了。

信号 说明
currentItemChanged(QListWidgetItem* current, QListWidgetItem* old) 选中不同元素时会触发。参数是当前选中的元素和之前选中的元素。
currentRowChanged(int) 选中不同元素时会触发。参数是当前选中元素的行数。
itemClicked(QListWidgetItem* item) 点击某个元素时触发。
itemDoubleClicked(QListWidgetItem* item) 双击某个元素时触发。
itemEntered(QListWidgetItem* item) 鼠标进入元素时触发。

在上述介绍中,涉及到一个关键的类 ------QListWidgetItem。这个类表示 QListWidget 中的一个元素。其核心方法本质上是由 "文本 + 图标" 构成的。

方法 说明
setFont 设置字体。
setIcon 设置图标。
setHidden 设置隐藏。
setSizeHint 设置尺寸。
setSelected 设置是否选中。
setText 设置文本。
setTextAlignment 设置文本对齐方式。

  1. 代码示例:创建一个 QListWidget,并且我们可以在里面进行添加元素和删除元素的操作。

  1. 连接槽函数,addItem()的作用就是向 QListWidget 控件中添加 QListWidgteItem 元素;takeItem 作用是删除控件中的元素。

Table Widget

Table Widget 使用 QTableWidget 表示一个表格控件。一个表格中包含若干行,每一行又包含若干列。表格中的每个单元格,是一个 QTableWidgetItem 对象。

方法 说明
item(int row, int column) 根据行数和列数获取指定的 QTableWidgetItem*。
setItem(int row, int column, QTableWidget*) 根据行数和列数设置表格中的元素。
currentItem() 返回被选中的元素 QTableWidgetItem*。
currentRow() 返回被选中元素是第几行。
currentColumn() 返回被选中元素是第几列。
row(QTableWidgetItem*) 获取指定 item 是第几行。
column(QTableWidgetItem*) 获取指定 item 是第几列。
rowCount() 获取行数。
columnCount() 获取列数。
insertRow(int row) 在第 row 行处插入新行。
insertColumn(int column) 在第 column 列插入新列。
removeRow(int row) 删除第 row 行。
removeColumn(int column) 删除第 column 列。
setHorizontalHeaderItem(int column, QTableWidget*) 设置指定列的表头。
setVerticalHeaderItem(int row, QTableWidget*) 设置指定行的表头。

QTableWidgetItem 核心方法:

方法 说明
row() 获取当前是第几行。
column() 获取当前是第几列。
setText(const QString&) 设置文本。
setTextAlignment(int) 设置文本对齐。
setIcon(const QIcon&) 设置图标。
setSelected(bool) 设置被选中。
setSizeHints(const QSize&) 设置尺寸。
setFont(const QFont&) 设置字体。

信号 说明
cellClicked(int row, int column) 点击单元格时触发。
cellDoubleClicked(int row, int column) 双击单元格时触发。
cellEntered(int row, int column) 鼠标进入单元格时触发。
currentCellChanged(int row, int column, int previousRow, int previousColumn) 选中不同单元格时触发。

  1. 创建表格控件QTableWidget。

  1. 使用setItem向表格控件中添加元素。

Tree Widget

Tree Widget 使用 QTreeWidget 表示一个树形控件。里面的每个元素都是一个 QTreeWidgetItem,每个 QTreeWidgetItem 可以包含多个文本和图标,每个文本 / 图标为一个列。

可以给 QTreeWidget 设置顶层节点(顶层节点可以有多个),然后再给顶层节点添加子节点,从而构成树形结构。这种结构非常适合展示具有层次关系的数据,比如文件系统目录结构、组织结构图等。

方法 说明
clear 清空所有子节点
addTopLevelItem(QTreeWidgetItem* item) 新增顶层节点
topLevelItem(int index) 获取指定下标的顶层节点.
topLevelItemCount() 获取顶层节点个数
indexOfTopLevelItem(QTreeWidgetItem* item) 查询指定节点是顶层节点中的下标
takeTopLevelItem(int index) 删除指定的顶层节点. 返回 QTreeWidgetItem* 表示被删除的元素
currentItem() 获取到当前选中的节点, 返回 QTreeWidgetItem*
setCurrentItem(QTreeWidgetItem* item) 选中指定节点
setExpanded(bool) 展开/关闭节点
setHeaderLabel(const QString& text) 设置 TreeWidget 的 header 名称。

信号 说明
currentItemChanged (QTreeWidgetItem* current, QTreeWidgetItem* old) 切换选中元素时触发
itemClicked (QTreeWidgetItem* item, int col) 点击元素时触发
itemDoubleClicked (QTreeWidgetItem* item, int col) 双击元素时触发
itemEntered (QTreeWidgetItem* item, int col) 鼠标标进⼊时触发
itemExpanded (QTreeWidgetItem* item) 元素被展开时触发
itemCollapsend (QTreeWidgetItem* item) 元素被折叠时触发。

QTreeWidgetItem 核心属性

属性 说明
text 持有的文本
textAlignment 文本对齐方式
icon 持有的图表
font 文本字体
hidden 是否隐藏
disabled 是否禁用
expand 是否展开
sizeHint 尺寸大小
selected 是否选中

QTreeWidgetItem 核心方法

方法 说明
addChild (QTreeWidgetItem* child) 新增子节点
childCount () 子节点的个数
child (int index) 获取指定下标的子节点,返回 QTreeWidgetItem*
takeChild (int index) 删除对应下标的子节点
removeChild (QTreeWidgetItem* child) 删除对应的子节点
parent () 获取该元素的父节点

  1. 创建QTreeWidget树形控件。

  2. 添加树形控件的层级元素。

相关推荐
꧁坚持很酷꧂23 分钟前
Linux Ubuntu18.04下安装Qt Craeator 5.12.9(图文详解)
linux·运维·qt
ChoSeitaku37 分钟前
17.QT-Qt窗口-工具栏|状态栏|浮动窗口|设置停靠位置|设置浮动属性|设置移动属性|拉伸系数|添加控件(C++)
c++·qt·命令模式
软行2 小时前
LeetCode 每日一题 2845. 统计趣味子数组的数目
数据结构·c++·算法·leetcode
小贾要学习2 小时前
【C++】继承----下篇
android·java·c++
未来可期LJ2 小时前
【Test】单例模式❗
开发语言·c++
我想进大厂2 小时前
图论---染色法(判断是否为二分图)
数据结构·c++·算法·深度优先·图论
纪元A梦2 小时前
华为OD机试真题——推荐多样性(2025A卷:200分)Java/python/JavaScript/C++/C语言/GO六种最佳实现
java·javascript·c++·python·华为od·go·华为od机试题
OpenC++4 小时前
【C++QT】Buttons 按钮控件详解
c++·经验分享·qt·leetcode·microsoft
YuforiaCode4 小时前
第十二届蓝桥杯 2021 C/C++组 直线
c语言·c++·蓝桥杯
我真的不会C4 小时前
QT窗口相关控件及其属性
开发语言·qt