TpMenu 类
V0.2.1TpGUIWidgets
2025-11-14
介绍
弹出菜单窗体
继承关系
基础信息
| 头文件: | include <TpMenu.h> |
|---|---|
| Cmake: | None |
| 发布版本: | V0.2.1 |
| 继承类: | TpDialog |
| 派生类: |
信号
| 信号名称 | 参数 | 描述 |
|---|---|---|
| onClicked | uint32_t | 点击item 参数：uint32_t: 当前下标索引 |
Public 成员函数
| TpMenu() | ||
|---|---|---|
| ~TpMenu() | ||
| exec(const TpPoint &globalPos) | 非模态顶层显示menu菜单 | |
| exec(const int32_t &globalPosX, const int32_t &globalPosY) | 顶层显示menu菜单 | |
| addItem(const TpString &text) | 添加一个操作按钮 | |
| addItem(const TpString &text, const TpString &iconPath) | 添加一个操作按钮 | |
| addMenu(const TpString &menuName, TpMenu *menu) | 添加子菜单;暂未实现 | |
| TpMenu * TpMenu::addMenu | addMenu(const TpString &menuName) | 添加子菜单;暂未实现 |
| itemHeight() | 获取单个item的高度 | |
| setItemHeight(const uint32_t &height) | 设置item高度 | |
| setItemHoverColor(const int32_t &color) | 设置鼠标悬停item的背景颜色 | |
| clear() | 清空菜单，所有子菜单指针均会被释放 | |
| TpString | itemText(const uint32_t &index) | 指定索引值获取item的文本 |
成员函数说明
TpMenu::TpMenu()
暂无注释...
virtual TpMenu::~TpMenu()
暂无注释...
void TpMenu::exec(const TpPoint &globalPos)
非模态顶层显示menu菜单...
非模态顶层显示menu菜单
参数：globalPos: 屏幕全局X，Y坐标
void TpMenu::exec(const int32_t &globalPosX, const int32_t &globalPosY)
顶层显示menu菜单...
顶层显示menu菜单
参数：globalPosX: 屏幕全局X坐标
参数：globalPosY: 屏幕全局Y坐标
uint32_t TpMenu::addItem(const TpString &text)
添加一个操作按钮...
添加一个操作按钮
参数：text: 按钮文本
返回值：返回按钮ID，当前menu下唯一
uint32_t TpMenu::addItem(const TpString &text, const TpString &iconPath)
添加一个操作按钮...
添加一个操作按钮
参数：text: 按钮文本
参数：iconPath: 按钮图标绝对路径
返回值：返回按钮ID，当前menu下唯一
void TpMenu::addMenu(const TpString &menuName, TpMenu *menu)
添加子菜单;暂未实现...
添加子菜单;暂未实现
参数：menuName: 子菜单名称
参数：menu: 子菜单指针，外部无需释放
TpMenu * TpMenu::addMenu(const TpString &menuName)
添加子菜单;暂未实现...
添加子菜单;暂未实现
参数：menuName: 子菜单名称
返回值：返回子菜单指针，子菜单指针，外部无需释放
uint32_t TpMenu::itemHeight()
获取单个item的高度...
获取单个item的高度
返回值：返回item高度
void TpMenu::setItemHeight(const uint32_t &height)
设置item高度...
设置item高度
参数：height: 高度值
void TpMenu::setItemHoverColor(const int32_t &color)
设置鼠标悬停item的背景颜色...
设置鼠标悬停item的背景颜色
参数：color: 颜色_RGB
void TpMenu::clear()
清空菜单，所有子菜单指针均会被释放...
清空菜单，所有子菜单指针均会被释放
TpString TpMenu::itemText(const uint32_t &index)
指定索引值获取item的文本...
指定索引值获取item的文本
参数：index: 索引值
返回值：文本字符串
