如何实现QPlainTextEdit的逐像素滚动？

QPlainTextEdit 默认强制按行滚动，既没有类似 QTableWidget 的 ScrollPerPixel 配置项，调用 setSingleStep 也无法改变其滚动逻辑，要实现逐像素滚动可以通过以下方式：

实现步骤 #

• 自定义继承类：继承 QPlainTextEdit，重写滚轮事件并调整滚动条参数
• 修改滚动条单步值：将垂直滚动条的单步设置为1像素，确保点击滚动箭头时逐像素移动
• 接管滚轮事件：绕过QPlainTextEdit默认的按行滚动逻辑，直接通过滚动条控制滚动距离

代码示例 #

#include <QPlainTextEdit>
#include <QWheelEvent>

class PixelScrollPlainTextEdit : public QPlainTextEdit
{
    Q_OBJECT
public:
    explicit PixelScrollPlainTextEdit(QWidget *parent = nullptr) 
        : QPlainTextEdit(parent)
    {
        // 设置垂直滚动条单步为1像素
        verticalScrollBar()->setSingleStep(1);
    }

protected:
    void wheelEvent(QWheelEvent *event) override
    {
        // 根据滚轮角度差计算滚动距离，可自行调整系数（这里每滚轮一格滚动3像素）
        int scrollOffset = event->angleDelta().y() / 40;
        verticalScrollBar()->setValue(verticalScrollBar()->value() - scrollOffset);
        event->accept();
    }
};

说明 #

• 滚动条单步设为1后，点击滚动条上下箭头时会逐像素移动
• 重写wheelEvent是关键：QPlainTextEdit默认会把滚轮事件转换为按行滚动，直接接管后可以完全控制滚动的像素距离，系数40可根据需求调整（比如改成60会让滚轮滚动更慢）

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