TpListWidget 类
V0.2.1TpGUIWidgets
2025-11-14
介绍
列表窗口
继承关系
基础信息
| 头文件: | include <TpListWidget.h> |
|---|---|
| Cmake: | None |
| 发布版本: | V0.2.1 |
| 继承类: | TpWidget |
| 派生类: |
信号
| 信号名称 | 参数 | 描述 |
|---|---|---|
| onStatusChanged | TpListWidgetItem * | 选中项切换事件 参数：TpListWidgetItem*: 当前状态切换item |
Public 成员函数
| TpListWidget(TpWidget *parent=nullptr) | ||
|---|---|---|
| ~TpListWidget() | ||
| setSelectionMode(const Tp::ItemSelectionMode &selectionMode) | 设置选择模式 | |
| Tp::ItemSelectionMode | selectionMode() | 获取当前widget设置的选中模式 |
| virtual TpListWidgetItem * | addItem(const TpString &text, const TpVariant &itemData=TpVariant()) | 添加一个item |
| addItem(TpListWidgetItem *item) | 添加一个item | |
| TpVector< uint32_t > | currentIndex() | 获取当前索引 |
| TpVector< TpListWidgetItem * > | currentItem() | 获取当前选中的item |
| setSelected(const uint32_t &index) | 指定索引选中item | |
| setSelectedItem(const TpListWidgetItem *item) | 指定item选中 | |
| TpListWidgetItem * | takeItem(const uint32_t &index) | 指定索引取出指定item；取出后窗体内无该item；外部需释放指针 |
| clear() | 清理所有Item |
成员函数说明
TpListWidget::TpListWidget(TpWidget *parent=nullptr)
暂无注释...
virtual TpListWidget::~TpListWidget()
暂无注释...
void TpListWidget::setSelectionMode(const Tp::ItemSelectionMode &selectionMode)
设置选择模式...
设置选择模式
参数：selectionMode: 选择模式枚举, 只有单选和多选生效
Tp::ItemSelectionMode TpListWidget::selectionMode()
获取当前widget设置的选中模式...
获取当前widget设置的选中模式
返回值：选中模式枚举
virtual TpListWidgetItem * TpListWidget::addItem(const TpString &text, const TpVariant &itemData=TpVariant())
添加一个item...
添加一个item
参数：text: item文本
参数：itemData: item绑定数据，可以不给入
返回值：添加的item指针
virtual void TpListWidget::addItem(TpListWidgetItem *item)
添加一个item...
添加一个item
参数：item: 指针对象
TpVector< uint32_t > TpListWidget::currentIndex()
获取当前索引...
获取当前索引
返回值：索引值,单选模式下只会返回一个，多选模式下可能返回空
TpVector< TpListWidgetItem * > TpListWidget::currentItem()
获取当前选中的item...
获取当前选中的item
返回值：选中的item指针,单选模式下只会返回一个，多选模式下可能返回空
void TpListWidget::setSelected(const uint32_t &index)
指定索引选中item...
指定索引选中item
参数：index: item索引，从0开始
void TpListWidget::setSelectedItem(const TpListWidgetItem *item)
指定item选中...
指定item选中
参数：item: 选中item指针
TpListWidgetItem * TpListWidget::takeItem(const uint32_t &index)
指定索引取出指定item；取出后窗体内无该item；外部需释...
指定索引取出指定item；取出后窗体内无该item；外部需释放指针
参数：index: 索引值
返回值：索引对应的item;索引值无效则返回nullptr
void TpListWidget::clear()
清理所有Item...
清理所有Item
