SAColorToolButton类 参考

这是一个只显示颜色的toolbutton 更多...

#include <SAColorToolButton.h>

类 SAColorToolButton 继承关系图:

类
class	PrivateData

Public 类型
enum	ColorToolButtonStyle { WithColorMenu , NoColorMenu }
	颜色按钮的内置样式 更多...

Public 槽
void	setColor (const QColor &c)
	设置颜色

信号
void	colorClicked (const QColor &color, bool checked=false)
	颜色被点击的响应
void	colorChanged (const QColor &color)
	颜色改变信号

Public 成员函数
	SAColorToolButton (QWidget *parent=nullptr)
	SAColorToolButton (ColorToolButtonStyle style, QWidget *parent=nullptr)
QColor	color () const
	获取颜色
void	setMargins (const QMargins &mg)
	设置Margins
QMargins	margins () const
void	setColorToolButtonStyle (ColorToolButtonStyle s)
	设置颜色按钮的样式
ColorToolButtonStyle	colorToolButtonStyle () const
	颜色按钮的样式
SAColorMenu *	colorMenu () const
	获取colorMenu
SAColorMenu *	createColorMenu ()
	建立标准的颜色菜单

静态 Public 成员函数
static void	paintNoneColor (QPainter *p, const QRect &colorRect)
	绘制无颜色表示

Protected 成员函数
virtual void	calcRect (const QStyleOptionToolButton &opt, QRect &iconRect, QRect &textRect, QRect &colorRect)
	计算各个基本组件的位置
virtual void	paintButton (QStylePainter *p, const QStyleOptionToolButton &opt)
	绘制按钮
virtual void	paintIcon (QStylePainter *p, const QRect &iconRect, const QStyleOptionToolButton &opt)
	绘制icon
virtual void	paintText (QStylePainter *p, const QRect &textRect, const QStyleOptionToolButton &opt)
	绘制文本
virtual void	paintColor (QStylePainter *p, const QRect &colorRect, const QColor &color, const QStyleOptionToolButton &opt)
	绘制color
virtual void	paintEvent (QPaintEvent *e) Q_DECL_OVERRIDE
virtual void	resizeEvent (QResizeEvent *e) Q_DECL_OVERRIDE
virtual QSize	sizeHint () const Q_DECL_OVERRIDE
	sizeHint重载

详细描述

这是一个只显示颜色的toolbutton

在ToolButtonIconOnly模式下，如果没有setIcon,则颜色占用所有区域，如下图所示

┌─────┐ │color│ └─────┘

如果在ToolButtonIconOnly模式下有图标，图标在上面显示，下面显示颜色，如下图所示

┌─────┐ │icon │ │color│ └─────┘

在ToolButtonTextBesideIcon，ToolButtonTextUnderIcon下，setIconSize 可以指定颜色的大小， 但只在ToolButtonTextBesideIcon，ToolButtonTextUnderIcon下有效

如果没有设置图标，也就是setIcon(QIcon()),iconSize作为颜色块的大小

┌─────────┐ │┌─┐ │ │└─┘ │ └─────────┘

如果有图标，颜色条会在图标下方，为图标高度的1/4 为图标宽度一致，如若超过控件的大小，会自动缩小体积

成员枚举类型说明

ColorToolButtonStyle

enum SAColorToolButton::ColorToolButtonStyle

颜色按钮的内置样式

参数

parent

返回

枚举值
WithColorMenu	默认会构建一个SAColorMenu
NoColorMenu	没有ColorMenu

成员函数说明

calcRect()

void SAColorToolButton::calcRect ( const QStyleOptionToolButton &  opt, QRect &  iconRect, QRect &  textRect, QRect &  colorRect  )

protectedvirtual

计算各个基本组件的位置

参数

opt
iconRect	图标区域
textRect	文本区域
colorRect	颜色区域

color()

QColor SAColorToolButton::color

(

)

const

获取颜色

返回

colorChanged

void SAColorToolButton::colorChanged ( const QColor &  color )

signal

颜色改变信号

参数

color

colorClicked

void SAColorToolButton::colorClicked ( const QColor &  color, bool  checked = false  )

signal

颜色被点击的响应

参数

color

colorMenu()

SAColorMenu * SAColorToolButton::colorMenu

(

)

const

获取colorMenu

注解

注意，这个函数很有可能会返回nullptr，如果ColorToolButtonStyle设置为NoColorMenu或者自己设置了菜单，此函数返回nullptr

返回

SAColorMenu指针，如果没有，返回nullptr

colorToolButtonStyle()

SAColorToolButton::ColorToolButtonStyle SAColorToolButton::colorToolButtonStyle

(

)

const

颜色按钮的样式

返回

createColorMenu()

SAColorMenu * SAColorToolButton::createColorMenu

(

)

建立标准的颜色菜单

返回

paintButton()

void SAColorToolButton::paintButton ( QStylePainter *  p, const QStyleOptionToolButton &  opt  )

protectedvirtual

绘制按钮

参数

p
opt

paintColor()

void SAColorToolButton::paintColor ( QStylePainter *  p, const QRect &  colorRect, const QColor &  color, const QStyleOptionToolButton &  opt  )

protectedvirtual

绘制color

参数

p
iconRect
opt

paintIcon()

void SAColorToolButton::paintIcon ( QStylePainter *  p, const QRect &  iconRect, const QStyleOptionToolButton &  opt  )

protectedvirtual

绘制icon

参数

p
iconRect
opt	icon信息从QStyleOptionToolButton获取

paintNoneColor()

void SAColorToolButton::paintNoneColor ( QPainter *  p, const QRect &  colorRect  )

static

绘制无颜色表示

参数

p
colorRect	绘制的区域

paintText()

void SAColorToolButton::paintText ( QStylePainter *  p, const QRect &  textRect, const QStyleOptionToolButton &  opt  )

protectedvirtual

绘制文本

参数

p
textRect
opt

setColor

void SAColorToolButton::setColor ( const QColor &  c )

slot

设置颜色

注解

会发射

参见

colorChanged 信号

参数

c

setColorToolButtonStyle()

void SAColorToolButton::setColorToolButtonStyle

(

ColorToolButtonStyle

s

)

设置颜色按钮的样式

参数

s

setMargins()

void SAColorToolButton::setMargins

(

const QMargins &

mg

)

设置Margins

参数

mg

sizeHint()

QSize SAColorToolButton::sizeHint ( ) const

protectedvirtual

sizeHint重载

返回

Qt6.4 取消了QApplication::globalStrut

---

该类的文档由以下文件生成:

• /home/runner/work/SARibbon/SARibbon/src/SARibbonBar/colorWidgets/SAColorToolButton.h
• /home/runner/work/SARibbon/SARibbon/src/SARibbonBar/colorWidgets/SAColorToolButton.cpp