介绍

按钮类

继承关系

基础信息

头文件:	include <TpButton.h>
Cmake:	None
发布版本:	V0.1.1
继承类:	TpChildWidget
派生类:

Public 类型

enum ButtonTextStyle {
       IconOnly, TextOnly, TextBesideIcon
}

信号

信号名称	参数	描述
onClicked	bool	按钮点击信号槽，鼠标释放时触发 参数：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 TpSize &size)	设置图标大小，只有ButtonTextStyle==IconOnly模式下有效；默认是充满整个按钮；图标会居中显示
	setIconSize(const uint32_t &width, const uint32_t &height)	设置图标大小，只有ButtonTextStyle==IconOnly模式下有效；默认是充满整个按钮；图标会居中显示
	setButtonStyle(TpButton::ButtonTextStyle buttonStyle=TpButton::TextOnly)	设置按钮样式

Protected成员函数

	onMousePressEvent(TpMouseEvent *event) override
	onMouseRleaseEvent(TpMouseEvent *event) override
	onPaintEvent(TpPaintEvent *event) override	绘制事件，禁止在该函数调用 paint和update函数
	onResizeEvent(TpResizeEvent *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)

点击查看...

设置按钮文本
参数：text: 文本内容

virtual TpFont * TpButton::font()

点击查看...

获取按钮文本字体
返回值：字体指针

void TpButton::setIcon(const TpString &iconPath)

点击查看...

设置按钮的图标
参数：iconPath: 图标文件的绝对路径

void TpButton::setIconSize(const TpSize &size)

点击查看...

设置图标大小，只有ButtonTextStyle==IconOnly模式下有效；默认是充满整个按钮；图标会居中显示
参数：size: 图标尺寸

void TpButton::setIconSize(const uint32_t &width, const uint32_t &height)

点击查看...

设置图标大小，只有ButtonTextStyle==IconOnly模式下有效；默认是充满整个按钮；图标会居中显示
参数：width: 图标宽度
参数：height: 图标高度

void TpButton::setButtonStyle(TpButton::ButtonTextStyle buttonStyle=TpButton::TextOnly)

点击查看...

设置按钮样式
参数：buttonStyle: 按钮样式枚举值

virtual bool TpButton::onMousePressEvent(TpMouseEvent *event) override

暂无注释...

virtual bool TpButton::onMouseRleaseEvent(TpMouseEvent *event) override

暂无注释...

virtual bool TpButton::onPaintEvent(TpPaintEvent *event) override

点击查看...

绘制事件，禁止在该函数调用 paint和update函数
参数：event: 绘制事件指针
返回值：返回true继续执行子控件绘制

virtual bool TpButton::onResizeEvent(TpResizeEvent *event) override

暂无注释...

virtual bool TpButton::eventFilter(TpObject *watched, TpEvent *event) override

点击查看...

事件过滤器处理函数，对象事件会先进入事件过滤器对象的本函数
参数：watched: 触发事件的对象指针
参数：event: 事件指针
返回值：如果返回true则不再触发watched对象本身的事件回调，返回false则本函数执行完毕后会执行watched对象的事件回调

virtual void TpButton::onThemeChangeEvent(TpThemeChangeEvent *event) override

点击查看...

参数：event:

virtual TpString TpButton::pluginType() override

点击查看...

组件类名，子类实现，返回子类类名字符串，用于匹配CSS中对应样式
返回值：类名字符串