Qt 自定义控件 - 开关按钮(2)

该文章介绍如何在Qt环境中,通过继承QWidget类并重写paintEvent和mouseReleaseEvent方法,实现一个自定义的开关按钮。开发者定义了SwitchState枚举来表示开关状态,并提供了设置和获取开关状态的方法。示例代码中,按钮尺寸固定,未实现大小自适应,但提到了可进一步添加动画效果。

1 概述

由于 Qt 的 widgets 模块没有提供类似开关一样的按钮,所以采用继承自QWidget类实现一个自绘的开关按钮。

开发环境

  • 系统:Window10
  • Qt版本:5.14.2
  • 编译器:MinGW_64/MSVC 2017

2 实现效果

在这里插入图片描述

3 实现步骤

3.1 添加继承自QWidget的类

SwitchButton类头文件定义

class SwitchButton : public QWidget
{
    Q_OBJECT
public:
    enum SwitchState
    {
        SS_On,
        SS_Off
    };

    explicit SwitchButton(QWidget *parent = nullptr);

    SwitchState switchState() const { return m_currentState; }
    void setSwitchState(SwitchState state);

protected:
    void paintEvent(QPaintEvent *event) override;
    void mouseReleaseEvent(QMouseEvent *event) override;

private:
    SwitchState m_currentState;
    QColor m_color;
};

SwitchButton类源文件定义

SwitchButton::SwitchButton(QWidget *parent)
    : QWidget{parent}
{
    m_currentState = SS_Off;
    m_color = QColor(140, 150, 175);
    setFixedSize(40, 20);
    setCursor(Qt::PointingHandCursor);
}

void SwitchButton::setSwitchState(SwitchState state)
{
    m_currentState = state;
    update();
}

void SwitchButton::paintEvent(QPaintEvent *event)
{
    Q_UNUSED(event)

    QPainter p(this);
    p.setRenderHint(QPainter::Antialiasing);
    p.setPen(Qt::NoPen);

    p.save();
    if (m_currentState == SS_On) {
        m_color = QColor(65, 127, 249);
    } else {
        m_color = QColor(140, 150, 175);
    }
    p.setBrush(m_color);
    qreal radius = rect().height() / 2;
    p.drawRoundedRect(rect(), radius, radius);
    p.restore();

    p.setBrush(Qt::white);
    qreal edge = height() - 4;
    if (m_currentState == SS_Off) {
        p.drawEllipse(QRectF(2.0, 2.0, edge, edge));
    } else {
        p.drawEllipse(QRectF(qreal(width() - edge - 2), 2.0, edge, edge));
    }
}

void SwitchButton::mouseReleaseEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        if (m_currentState == SS_Off) {
            m_currentState = SS_On;
            update();
        } else {
            m_currentState = SS_Off;
            update();
        }
    }
    QWidget::mouseReleaseEvent(event);
}

3.2 说明

  • 此例子没有对SwitchButton控件的大小实现自适应功能,只有固定尺寸40X20。
  • 可以在此基础上加上动画,效果会更好些。
### 创建Qt自定义控件开关按钮 #### 控件概述 ImageSwitch是一个提供基本开关功能的自定义控件,能够响应鼠标的点击操作,在开启和关闭两种状态间切换,并在每次状态转换时发送信号给父级组件或主窗口以便进一步处理[^1]。 #### 功能实现原理 为了使该控件具备交互能力并呈现出视觉上的变化,主要涉及以下几个方面的工作: - **事件重载**:通过继承QWidget类来构建新的部件对象;随后需重点覆盖`mousePressEvent()`以及`mouseReleaseEvent()`这两个虚函数以捕捉用户的输入行为——即单击动作的发生时刻。每当检测到一次完整的按压与抬起过程,则意味着用户意图改变当前设备所处模式(开/关),此时应立即更新内部逻辑变量记录最新状况的同时向外广播通知消息告知外界环境本体已发生转变[^4]。 - **界面渲染**:同样重要的是要确保外观能随实际运行情况同步调整,这就要求我们也要改写`paintEvent()`方法负责描绘具体的图形表现形式。依据前述提及的状态标志位的不同取值分别给出对应的显示样式设计,比如颜色填充、轮廓线条粗细等细节之处均可以根据个人喜好或者项目需求灵活定制化设置。 - **动画效果**:为了让用户体验更加流畅自然,还可以引入计时器机制配合上述绘图流程共同作用达成平滑过渡的效果。具体做法是在接收到有效指令之后启动一个短暂周期内的连续刷新任务直至最终目标位置完全就绪为止。 #### 示例代码片段展示 下面是一段简化版C++源码用来说明如何编写这样一个具有动态特性的UI元素实例: ```cpp // 头文件声明部分省略... class ImageSwitch : public QWidget { Q_OBJECT public: explicit ImageSwitch(QWidget *parent = nullptr); protected: void mousePressEvent(QMouseEvent* event) override; void mouseReleaseEvent(QMouseEvent* event) override; void paintEvent(QPaintEvent* event) override; private slots: void animateTransition(); signals: void toggled(bool checked); private: bool m_isOn; QTimer* m_animationTimer; }; void ImageSwitch::mousePressEvent(QMouseEvent* /*event*/) { // 切换状态 m_isOn = !m_isOn; } void ImageSwitch::mouseReleaseEvent(QMouseEvent* /*event*/) { emit toggled(m_isOn); // 发射信号 startAnimation(); // 启动动画 } void ImageSwitch::startAnimation() { if (!m_animationTimer->isActive()) { connect(m_animationTimer, SIGNAL(timeout()), this,SLOT(animateTransition())); m_animationTimer->start(); } } ```
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值