tpButton类
SingleGUI
2025-07-05
介绍
按钮类
继承关系
基础信息
头文件: | include <tpButton.h> |
---|---|
Cmake: | None |
发布版本: | V0.1.0 |
继承类: | tpChildWidget |
派生类: |
Public 类型
enum ButtonTextStyle {
IconOnly, TextOnly, TextBesideIcon
}
信号
信号名称 | 参数 | 描述 |
---|---|---|
onClicked | bool | 按钮点击信号槽,鼠标释放时触发 |
Public 成员函数
tpButton(tpChildWidget *parent=nullptr) | ||
---|---|---|
tpButton(const tpString &iconPath, const tpString &text, tpChildWidget *parent=nullptr) | ||
tpButton(const tpString &text, tpChildWidget *parent=nullptr) | ||
~tpButton() | ||
setText(const tpString &text) | 设置按钮文本 | |
virtual tpFont * | font() | 获取按钮文本字体 |
setIcon(const tpString &iconPath) | 设置按钮的图标 | |
setIconSize(const ItpSize &size) | 设置图标大小,只有ButtonTextStyle==IconOnly模式下有效;默认是充满整个按钮;图标会居中显示 | |
setIconSize(const uint32_t &width, const uint32_t &height) | 设置图标大小,只有ButtonTextStyle==IconOnly模式下有效;默认是充满整个按钮;图标会居中显示 | |
setButtonStyle(tpButton::ButtonTextStyle buttonStyle=tpButton::TextOnly) | 设置按钮样式 | |
setRoundCorners(const uint32_t &roundPercent) override | 设置边框圆角 |
Protected成员函数
onKeyboardEvent(tpKeyboardEvent *event) override | 设置鼠标事件监听函数 | |
---|---|---|
onMouseKeyEvent(tpMouseKeyEvent *event) override | ||
onPaintEvent(tpObjectPaintEvent *event) override | 绘制事件,禁止在该函数调用 paint和update函数 | |
onResizeEvent(tpObjectResizeEvent *event) override | ||
eventFilter(tpObject *watched, tpEvent *event) override | 事件过滤器处理函数,对象事件会先进入事件过滤器对象的本函数 | |
onThemeChangeEvent(tpThemeChangeEvent *event) override | ||
virtual tpString | pluginType() override | 组件类名,子类实现,返回子类类名字符串,用于匹配CSS中对应样式 |
成员枚举类型说明
enum tpButton::ButtonTextStyle
名称 | 值 | 描述 |
---|---|---|
IconOnly | 0 | |
TextOnly | 1 | |
TextBesideIcon | 2 |
成员函数说明
tpButton::tpButton(tpChildWidget *parent=nullptr)
暂无注释...
tpButton::tpButton(const tpString &iconPath, const tpString &text, tpChildWidget *parent=nullptr)
暂无注释...
tpButton::tpButton(const tpString &text, tpChildWidget *parent=nullptr)
暂无注释...
virtual
tpButton::~tpButton()
暂无注释...
virtual
void tpButton::setText(const tpString &text)
点击查看...
设置按钮文本
virtual
tpFont * tpButton::font()
点击查看...
获取按钮文本字体
返回值:
字体指针
void tpButton::setIcon(const tpString &iconPath)
点击查看...
设置按钮的图标
void tpButton::setIconSize(const ItpSize &size)
点击查看...
设置图标大小,只有ButtonTextStyle==IconOnly模式下有效;默认是充满整个按钮;图标会居中显示
void tpButton::setIconSize(const uint32_t &width, const uint32_t &height)
点击查看...
设置图标大小,只有ButtonTextStyle==IconOnly模式下有效;默认是充满整个按钮;图标会居中显示
void tpButton::setButtonStyle(tpButton::ButtonTextStyle buttonStyle=tpButton::TextOnly)
点击查看...
设置按钮样式
virtual
void tpButton::setRoundCorners(const uint32_t &roundPercent) override
点击查看...
设置边框圆角
virtual
bool tpButton::onKeyboardEvent(tpKeyboardEvent *event) override
点击查看...
设置鼠标事件监听函数
virtual
bool tpButton::onMouseKeyEvent(tpMouseKeyEvent *event) override
暂无注释...
virtual
bool tpButton::onPaintEvent(tpObjectPaintEvent *event) override
点击查看...
绘制事件,禁止在该函数调用 paint和update函数
返回值:
返回true继续执行子控件绘制
virtual
bool tpButton::onResizeEvent(tpObjectResizeEvent *event) override
暂无注释...
virtual
bool tpButton::eventFilter(tpObject *watched, tpEvent *event) override
点击查看...
事件过滤器处理函数,对象事件会先进入事件过滤器对象的本函数
返回值:
如果返回true则不再触发watched对象本身的事件回调,返回false则本函数执行完毕后会执行watched对象的事件回调
virtual
void tpButton::onThemeChangeEvent(tpThemeChangeEvent *event) override
暂无注释...
virtual
tpString tpButton::pluginType() override
点击查看...
组件类名,子类实现,返回子类类名字符串,用于匹配CSS中对应样式
返回值:
类名字符串