QPushButton长按实现QGraphicsView周期性平移的方法

嘿，这个需求其实很常见，咱们可以利用Qt的QTimer配合按钮的pressed和released信号来实现——毕竟clicked只在点击松开时触发一次，而pressed在按住时触发一次，released在松开时触发，刚好能用来控制定时器的启停。

给你两种可行的实现思路，你可以根据自己的习惯选择：

方法一：单定时器+方向标识（节省资源） #

这种方式用一个定时器统一处理所有方向的平移，通过成员变量记录当前的平移方向，适合追求资源轻量化的场景。

步骤1：添加成员变量 #

在你的QGraphicsView子类头文件里声明所需变量：

#include <QTimer>

class YourGraphicsViewSubclass : public QGraphicsView
{
    Q_OBJECT
private:
    QTimer* m_panTimer;
    // 定义平移方向的枚举
    enum PanDirection { None, Up, Down, Left, Right };
    PanDirection m_currentPanDir;
    // 你的原有成员变量
    QPushButton* m_upButton;
    QPushButton* m_downButton;
    QPushButton* m_leftButton;
    QPushButton* m_rightButton;
    const int TranslateFactor = 20; // 你定义的平移步长
};

步骤2：初始化定时器并连接信号 #

在子类构造函数中完成定时器初始化和信号绑定：

YourGraphicsViewSubclass::YourGraphicsViewSubclass(QWidget* parent)
    : QGraphicsView(parent)
{
    m_panTimer = new QTimer(this);
    m_currentPanDir = None;
    // 连接定时器超时信号到自定义槽函数
    connect(m_panTimer, &QTimer::timeout, this, &YourGraphicsViewSubclass::onPanTimeout);

    // 替换原有clicked连接，改用pressed/released控制定时器
    connect(m_upButton, &QPushButton::pressed, [this](){
        m_currentPanDir = Up;
        m_panTimer->start(100); // 100ms为定时器间隔，越小移动越快，可自行调整
    });
    connect(m_upButton, &QPushButton::released, [this](){
        m_panTimer->stop();
        m_currentPanDir = None;
    });

    // 下方按钮同理
    connect(m_downButton, &QPushButton::pressed, [this](){
        m_currentPanDir = Down;
        m_panTimer->start(100);
    });
    connect(m_downButton, &QPushButton::released, [this](){
        m_panTimer->stop();
        m_currentPanDir = None;
    });

    // 左侧按钮同理
    connect(m_leftButton, &QPushButton::pressed, [this](){
        m_currentPanDir = Left;
        m_panTimer->start(100);
    });
    connect(m_leftButton, &QPushButton::released, [this](){
        m_panTimer->stop();
        m_currentPanDir = None;
    });

    // 右侧按钮同理
    connect(m_rightButton, &QPushButton::pressed, [this](){
        m_currentPanDir = Right;
        m_panTimer->start(100);
    });
    connect(m_rightButton, &QPushButton::released, [this](){
        m_panTimer->stop();
        m_currentPanDir = None;
    });
}

步骤3：实现超时槽函数 #

在子类cpp文件中添加定时器触发后的处理逻辑：

void YourGraphicsViewSubclass::onPanTimeout()
{
    switch(m_currentPanDir)
    {
        case Up:
            // 优化：滚动条到顶时停止定时器，避免无效操作
            if (verticalScrollBar()->value() > 0) {
                verticalScrollBar()->setValue(verticalScrollBar()->value() - TranslateFactor);
            } else {
                m_panTimer->stop();
            }
            break;
        case Down:
            if (verticalScrollBar()->value() < verticalScrollBar()->maximum()) {
                verticalScrollBar()->setValue(verticalScrollBar()->value() + TranslateFactor);
            } else {
                m_panTimer->stop();
            }
            break;
        case Left:
            if (horizontalScrollBar()->value() > 0) {
                horizontalScrollBar()->setValue(horizontalScrollBar()->value() - TranslateFactor);
            } else {
                m_panTimer->stop();
            }
            break;
        case Right:
            if (horizontalScrollBar()->value() < horizontalScrollBar()->maximum()) {
                horizontalScrollBar()->setValue(horizontalScrollBar()->value() + TranslateFactor);
            } else {
                m_panTimer->stop();
            }
            break;
        case None:
            m_panTimer->stop();
            break;
    }
}

方法二：多定时器（逻辑更直观） #

这种方式给每个平移按钮分配独立的定时器，每个定时器的超时信号直接触发对应方向的平移，不用维护方向变量，逻辑更清晰，适合新手或者追求代码可读性的场景。

步骤1：添加成员变量 #

在头文件中声明四个独立定时器：

#include <QTimer>

class YourGraphicsViewSubclass : public QGraphicsView
{
    Q_OBJECT
private:
    QTimer* m_upTimer;
    QTimer* m_downTimer;
    QTimer* m_leftTimer;
    QTimer* m_rightTimer;
    // 你的原有成员变量
    QPushButton* m_upButton;
    QPushButton* m_downButton;
    QPushButton* m_leftButton;
    QPushButton* m_rightButton;
    const int TranslateFactor = 20;
};

步骤2：初始化定时器并连接信号 #

在构造函数中完成每个定时器的初始化和信号绑定：

YourGraphicsViewSubclass::YourGraphicsViewSubclass(QWidget* parent)
    : QGraphicsView(parent)
{
    // 初始化向上按钮的定时器
    m_upTimer = new QTimer(this);
    connect(m_upTimer, &QTimer::timeout, this, [this](){
        if (verticalScrollBar()->value() > 0) {
            verticalScrollBar()->setValue(verticalScrollBar()->value() - TranslateFactor);
        } else {
            m_upTimer->stop();
        }
    });
    // 绑定按钮信号到定时器启停
    connect(m_upButton, &QPushButton::pressed, m_upTimer, QOverload<>::of(&QTimer::start), Qt::UniqueConnection);
    connect(m_upButton, &QPushButton::released, m_upTimer, &QTimer::stop);

    // 初始化向下按钮的定时器
    m_downTimer = new QTimer(this);
    connect(m_downTimer, &QTimer::timeout, this, [this](){
        if (verticalScrollBar()->value() < verticalScrollBar()->maximum()) {
            verticalScrollBar()->setValue(verticalScrollBar()->value() + TranslateFactor);
        } else {
            m_downTimer->stop();
        }
    });
    connect(m_downButton, &QPushButton::pressed, m_downTimer, QOverload<>::of(&QTimer::start), Qt::UniqueConnection);
    connect(m_downButton, &QPushButton::released, m_downTimer, &QTimer::stop);

    // 初始化向左按钮的定时器
    m_leftTimer = new QTimer(this);
    connect(m_leftTimer, &QTimer::timeout, this, [this](){
        if (horizontalScrollBar()->value() > 0) {
            horizontalScrollBar()->setValue(horizontalScrollBar()->value() - TranslateFactor);
        } else {
            m_leftTimer->stop();
        }
    });
    connect(m_leftButton, &QPushButton::pressed, m_leftTimer, QOverload<>::of(&QTimer::start), Qt::UniqueConnection);
    connect(m_leftButton, &QPushButton::released, m_leftTimer, &QTimer::stop);

    // 初始化向右按钮的定时器
    m_rightTimer = new QTimer(this);
    connect(m_rightTimer, &QTimer::timeout, this, [this](){
        if (horizontalScrollBar()->value() < horizontalScrollBar()->maximum()) {
            horizontalScrollBar()->setValue(horizontalScrollBar()->value() + TranslateFactor);
        } else {
            m_rightTimer->stop();
        }
    });
    connect(m_rightButton, &QPushButton::pressed, m_rightTimer, QOverload<>::of(&QTimer::start), Qt::UniqueConnection);
    connect(m_rightButton, &QPushButton::released, m_rightTimer, &QTimer::stop);

    // 设置定时器默认间隔（这里用100ms，可自行调整）
    m_upTimer->setInterval(100);
    m_downTimer->setInterval(100);
    m_leftTimer->setInterval(100);
    m_rightTimer->setInterval(100);
}

注意事项 #

• 定时器的间隔可以根据需求调整：比如50ms会让移动更快速，200ms则更平缓。
• 两种方案都添加了滚动边界判断，避免滚动条超出范围后触发无效操作，提升用户体验。
• 定时器以this作为父对象，Qt会自动处理内存释放，无需手动销毁。

内容的提问来源于stack exchange，提问作者Jepessen