QT记事本项目——使用事件过滤器实现Ctrl+滚轮字体缩放功能

一、Qt事件系统基础

Qt的事件系统是GUI应用程序的核心机制，所有用户交互（鼠标点击、键盘输入、窗口重绘等）都是通过事件来处理的。每个QObject派生类都能接收和处理事件。

典型事件处理方式：

1. 重写事件处理函数：如mousePressEvent(), keyPressEvent()

2. 安装事件过滤器：监听其他对象的事件

3. 信号槽机制：处理特定信号

二、为什么选择事件过滤器

传统方法 vs 事件过滤器

传统方法需要创建子类并重写虚函数：

class MyTextEdit : public QTextEdit {
protected:
    void wheelEvent(QWheelEvent *event) override {
        if(QApplication::keyboardModifiers() == Qt::ControlModifier) {
            // 处理缩放
        } else {
            QTextEdit::wheelEvent(event); // 正常滚动
        }
    }
};

缺点：需要创建新类，破坏原有代码结构

事件过滤器方法（本代码采用）：

// 在现有类中直接实现
bool Widget::eventFilter(QObject *obj, QEvent *ev) {
    // 处理逻辑
}

优势：无需创建新类，直接在现有架构中添加功能

三、事件过滤器实现详解

1. 安装事件过滤器（关键步骤）

在构造函数中设置：

ui->textEdit->installEventFilter(this);

• installEventFilter(this)：让当前Widget对象监听textEdit的事件

• 原理：所有发送到textEdit的事件会先经过Widget的eventFilter方法

2. 事件过滤器的实现

bool Widget::eventFilter(QObject *obj, QEvent *ev) {
    // 1. 检查事件类型是否为滚轮事件
    if(ev->type() == QEvent::Wheel) {
        // 2. 检查是否按下Ctrl键
        if(QGuiApplication::keyboardModifiers() == Qt::ControlModifier) {
            QWheelEvent *wheelevent = dynamic_cast(ev);
            // 3. 判断滚轮方向
            if(wheelevent->angleDelta().y() > 0) {
                FontBig();  // 向上滚动放大
            } else if(wheelevent->angleDelta().y() < 0) {
                FontSmall(); // 向下滚动缩小
            }
            return true; // 事件已处理
        }
    }
    return false; // 其他事件继续传递
}

3. 关键技术点解析

(1) 组合事件检测

• 不能直接检测"Ctrl+滚轮"组合事件

• 分两步检测：

  • ev->type() == QEvent::Wheel：识别滚轮事件

  • QGuiApplication::keyboardModifiers()：获取当前修饰键状态

(2) 滚轮方向判断

QWheelEvent *wheelevent = dynamic_cast(ev);
if(wheelevent->angleDelta().y() > 0) // 向上

• dynamic_cast：安全地将QEvent转换为QWheelEvent

• angleDelta().y()：获取垂直滚动量（正值上滚，负值下滚）

(3) 返回值意义

• return true：事件已处理，不再传递

• return false：事件继续传递给目标对象

四、字体缩放功能实现

1. 字体放大

void Widget::FontBig() {
    QFont font = ui->textEdit->font();
    int fontSize = font.pointSize();
    if(fontSize == -1) return; // 无效字体大小
    font.setPointSize(++fontSize);
    ui->textEdit->setFont(font);
}

2. 字体缩小

void Widget::FontSmall() {
    QFont font = ui->textEdit->font();
    int fontSize = font.pointSize();
    if(fontSize <= 1) return; // 防止字体过小
    font.setPointSize(--fontSize);
    ui->textEdit->setFont(font);
}

五、完整工作流程

1. 用户滚动鼠标滚轮 → 生成QWheelEvent

2. 事件首先传递到Widget的eventFilter方法

3. 检查事件类型和Ctrl键状态：

   • 是滚轮事件且Ctrl按下 → 处理缩放

   • 否则 → 交给textEdit正常处理（滚动内容）

4. 根据滚轮方向调用FontBig/FontSmall

5. 修改字体大小并更新显示