Skip to content

iwxyi/Qt-InteractiveButtons

Repository files navigation

可交互的创意动态按钮

特点

  • 所有颜色自定义
  • 鼠标悬浮渐变
  • 两种点击效果:鼠标点击渐变 / 水波纹动画(可多层波纹叠加)
  • 额外鼠标移入/移出/按下/弹起的实时/延迟共8种事件
  • 鼠标悬浮图标位置主动变化
  • 鼠标拖动图标抖动反弹效果
  • 鼠标进入父控件时开启出现效果,或启动时出现
  • 延迟出现的动画效果(多个按钮连续)
  • 记录开关状态
  • 直接设置 x、y 的圆角显示
  • 边框颜色设置
  • 禁用时半透明+点击穿透效果
  • 添加额外的边缘角标
  • 三种前景模式:图标、文字、带遮罩的图标(任意变色)
  • 支持QSS直接设置部分属性
  • 与父类 QPushButton 兼容
  • 时间准确性:根据时间戳计算动画进度,即使在低性能机器上也可准时完成动画
  • 稳定性:一按钮多功能,完美兼容多种情况下焦点事件
  • 极其强大的可扩展性,继承该按钮后可任意修改显示效果和动画效果

截图

截图

用法

// 方框按钮
InteractiveButtonBase* btn = new InteractiveButtonBase("text", this);
btn->setGeometry(300, 300, 100, 100);
// 圆形按钮带图标,以及鼠标靠近(父控件悬浮)出现动画
icon_btn = new WaterCircleButton(QIcon(":/icons/point_menu"), this);
icon_btn->setGeometry(100, 50, 32, 32);
icon_btn->setShowAni(true); // 调用showForeground2时出现动画
// 自定义颜色按钮(遮罩效果)
InteractiveButtonBase* pixmap_btn = new InteractiveButtonBase(QPixmap(":/icons/point_menu"), this);
pixmap_btn->setGeometry(132, 50, 32, 32);
// 椭圆形按钮
InteractiveButtonBase* float_btn = new WaterFloatButton("text", this);
float_btn->setGeometry(164, 50, 100, 32);
float_btn->setBgColor(QColor(102,51,204,192), QColor(102,51,204,255));
// 自定义按钮(win最小化按钮)
WinMenuButton* menu_btn = new WinMenuButton(this);
menu_btn->setGeometry(368, 10, 32, 32);

API

只说明一下常用的方法,具体可参考 interactivebuttonbase.h

// 设置文本(同QPushButton)
void setText(QString text);

// 设置Icon
void setIcon(QIcon icon);

// 设置Pixmap,会根据 icon_color 自动变色
void setPixmap(QPixmap pixmap);

// 设置额外扩展的角标,比如右边扩展小箭头、右上角标签、左边图标等
virtual void setPaintAddin(QPixmap pixmap, Qt::Alignment align = Qt::AlignRight, QSize size = QSize(0, 0));

// 调整各种动画时长
void setHoverAniDuration(int d);
void setPressAniDuration(int d);
void setClickAniDuration(int d);
void setWaterAniDuration(int press, int release, int finish);
// 是否启用水波纹,false则改为渐变
void setWaterRipple(bool enable = true);
void setJitterAni(bool enable = true);

// 设置无交互时的背景颜色
void setBgColor(QColor bg);
// 设置hover和press两种状态的背景颜色,与背景叠加
// press会和hover以及默认背景再叠加
void setBgColor(QColor hover, QColor press);
// 单独设置各种颜色
void setNormalColor(QColor color);
void setBorderColor(QColor color);
void setHoverColor(QColor color);
void setPressColor(QColor color);

// 设置前景颜色
void setIconColor(QColor color = QColor(0, 0, 0));
void setTextColor(QColor color = QColor(0, 0, 0));
void setFocusBg(QColor color);
void setFocusBorder(QColor color);

// 设置字体大小
// 如果已设置 setTextDynamicSize(true),那么会有改变动画
void setFontSize(int f);

// 前景对齐方式
void setAlign(Qt::Alignment a);

// 设置圆角
void setRadius(int r);
void setRadius(int rx, int ry);

// 设置边界宽度(默认0,透明)
void setBorderWidth(int x);

// 分别设置四周空白
void setPaddings(int l, int r, int t, int b);
// 设置水平、垂直空白
void setPaddings(int h, int v);
// 设置四周相同的空白
void setPaddings(int x);
// 设置图标边缘空白比例,0~0.5,越大越空
void setIconPaddingProper(double x);

// 设置鼠标交互时前景(文字/图标)会不会动
void setFixedForePos(bool f = true);
// 设置固定大小;并且会自动选取合适的最小值(adjustMinimumSize())
void setFixedForeSize(bool f = true, int paddings = 0);
// 设置为正方形(以高度为准)
void setSquareSize();

// 修改字体时是否显示动画
void setTextDynamicSize(bool d = true);

// 设置鼠标单击松开后是否当做移开
// 点击出现菜单的按钮必须设置
void setLeaveAfterClick(bool l = true);

// 启用双击,会响应双击事件,但是单击会有延迟
void setDoubleClicked(bool e = true);

// 动画时是否自动设置文字的颜色,针对派生类的设置,不一定有效
void setAutoTextColor(bool a = true);

// 临时屏蔽hover事件,需要手动关闭(set true->操作->set false)
// 比如出现动画,如果一开始鼠标在按钮上,按钮移开,但是hover效果还在,直到鼠标动
void setBlockHover(bool b = true);

// 鼠标进入按钮区域,前景图标从对面方向缩放出现
void setShowAni(bool enable = true);
// 前景从中心点出现的缩放动画
void showForeground();
// 前景从该点对面出现的动画
void showForeground2(QPoint point = QPoint(0, 0));
// 隐藏前景,使用 showForeground() 恢复
void hideForeground();
// 延迟的 showForeground2()
void delayShowed(int msecond, QPoint point = QPoint(0, 0));

// 调整最小大小,很常用
void adjustMinimumSize();

void setState(bool s = true);
bool getState();

// 模拟鼠标点击效果,与鼠标点击作用一样
// 会触发 clicked 信号
virtual void simulateStatePress(bool s = true, bool a = false);

// 该点是否在按钮的范围内
virtual bool inArea(QPoint point);

信号:

void showAniFinished();
void hideAniFinished();
void pressAppearAniFinished();
void pressDisappearAniFinished();
void jitterAniFinished();

// 点击事件
void clicked();
void doubleClicked();
void rightClicked();

// 焦点
void signalFocusIn();
void signalFocusOut();

// 其余鼠标事件
void signalMouseEnter();
// 进入后延迟信号(以渐变动画完成为准,相当于可手动设置)
void signalMouseEnterLater();

void signalMouseLeave();
// 离开后延迟的信号(直至渐变动画完成(要是划过一下子离开,这个也会变快))
void signalMouseLeaveLater();

void signalMousePress(QMouseEvent *event);
void signalMousePressLater(QMouseEvent *event);

void signalMouseRelease(QMouseEvent *event);
void signalMouseReleaseLater(QMouseEvent *event);

About

[Qt控件] 带动画交互的菜单、最小化、最大化、关闭按钮,强大自定义

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published