Qt如何实现文本编辑器光标高亮技术

 更新时间:2025年06月20日 16:37:23   作者:范纹杉好好生活工作  
这篇文章主要为大家详细介绍了Qt如何实现文本编辑器光标高亮技术,文中的示例代码讲解详细,具有一定的借鉴价值,有需要的小伙伴可以了解下

实现代码

void Widget::oncursorPositionChanged()
{
    QTextCursor cursor = ui->textEdit->textCursor();
    //qDebug() << cursor.blockNumber() + 1 << ", "<< cursor.columnNumber() + 1;
    QString blockNum = QString::number(cursor.blockNumber() + 1);
    QString columnNumber = QString::number(cursor.columnNumber() + 1);
    const QString labelMes = "列:" + blockNum + ", 行:" + columnNumber;
    ui->labelPosition->setText(labelMes);
 
    //    设置当前行高亮
    QList<QTextEdit::ExtraSelection> extraSelections;
    QTextEdit::ExtraSelection ext;
 
    //    1,知道当前行
    ext.cursor = ui->textEdit->textCursor();
    QBrush qBrush(Qt::yellow);
 
    //    2,颜色
    ext.format.setBackground(qBrush);
    //   配置段属性:整行显示,没有这句话不行
    ext.format.setProperty(QTextFormat::FullWidthSelection, true);
 
    //    3,设置
    //把ext加到ext的容器中
    extraSelections.append(ext);
    ui->textEdit->setExtraSelections(extraSelections);
}
//解释这串代码,写上注释,并仔细阐述里面用到了什么技术?

下面是对这段代码的逐行详细注释 + 技术解析,帮助你全面理解它的功能和背后使用的技术。

函数作用概述

void Widget::oncursorPositionChanged()

这是一个 槽函数(slot),当 QTextEdit 的光标位置发生变化时自动触发。它用于:

获取当前光标所在的行列号;

在界面上显示该信息(例如:“列:1, 行:3”);

高亮显示当前光标所在的整行内容;

代码详解 + 注释

    // 获取 QTextEdit 中的当前光标对象
    QTextCursor cursor = ui->textEdit->textCursor();

QTextCursor 是 Qt 提供的一个类,用于操作文本内容;

它记录了光标的位置、选区等信息;

textCursor() 返回当前的光标状态。

    // 将行号和列号转为字符串
    QString blockNum = QString::number(cursor.blockNumber() + 1);
    QString columnNumber = QString::number(cursor.columnNumber() + 1);

cursor.blockNumber():返回当前光标所在的段落编号(从 0 开始),即“行号”;

cursor.columnNumber():返回当前光标在该行中的字符偏移量,即“列号”;

+1 是为了将索引从 0 转换为更直观的“第1行第1列”;

QString::number(...) 将整数转换为字符串。

    const QString labelMes = "列:" + blockNum + ", 行:" + columnNumber;
    ui->labelPosition->setText(labelMes);

构造一个格式化的字符串,如 "列:3, 行:5";

显示在界面中的 QLabel 控件上,控件名为 labelPosition;

这个标签通常用于实时显示光标位置。

使用 QTextEdit 的高亮技术(重点)

1. 创建额外选择区域列表

    QList<QTextEdit::ExtraSelection> extraSelections;

QTextEdit::ExtraSelection 是 Qt 提供的一种机制,允许你在文本编辑器中自定义高亮显示区域;

可以设置背景色、前景色、字体样式等;

QList<...> 是 Qt 的容器类,用来保存多个高亮区域。

QTextEdit::ExtraSelection ext;

创建一个 ExtraSelection 对象,表示一个要高亮的区域;

后续会配置这个对象,并添加到 extraSelections 列表中。

ext.cursor = ui->textEdit->textCursor();

设置高亮区域的光标范围;

这里直接使用当前光标,表示高亮“当前行”的内容。

QBrush qBrush(Qt::yellow);

创建一个画刷对象,颜色为黄色;

用于设置高亮的背景色。

ext.format.setBackground(qBrush);

设置高亮区域的格式,这里是设置背景色为黄色;

QTextCharFormat 是格式描述对象,支持多种样式设置。

ext.format.setProperty(QTextFormat::FullWidthSelection, true);

设置该区域的格式属性为“全宽选择”,即整行高亮;

否则只会高亮光标所在字符位置,而不是整行。

extraSelections.append(ext);

将配置好的高亮区域加入列表中。

ui->textEdit->setExtraSelections(extraSelections);

将高亮区域应用到 textEdit 控件;

此后,当前光标所在的整行就会被黄色高亮显示。

总结用到的关键技术点

技术名称描述
QTextCursor用于获取或操作文本编辑器中的光标位置和内容
QTextEdit::ExtraSelection允许在 QTextEdit 中自定义高亮显示区域
QTextCharFormat文本字符格式设置类,可设置背景色、字体、大小等
QBrush画刷类,用于设置背景颜色或图案
QList<T>Qt 提供的泛型容器类,用于管理多个对象
QString::number()将数字转换为字符串,用于显示
setText()QLabel 常用方法,更新界面上的文字

应用场景举例

这种功能常用于:

  • 自定义文本编辑器(如代码编辑器);
  • 实现“行号显示 + 当前行高亮”功能;
  • 模拟 IDE 中的光标定位与语法高亮;
  • 实现富文本编辑器中的自定义样式区域;

示例优化建议

你可以将上面的代码封装成一个函数,便于复用:

void Widget::updateCursorPositionInfo()
{
    QTextCursor cursor = ui->textEdit->textCursor();
 
    int line = cursor.blockNumber() + 1;
    int col = cursor.columnNumber() + 1;
 
    QString info = QString("行:%1,列:%2").arg(line).arg(col);
    ui->labelPosition->setText(info);
 
    QTextEdit::ExtraSelection selection;
    selection.format.setBackground(Qt::yellow);
    selection.format.setProperty(QTextFormat::FullWidthSelection, true);
    selection.cursor = cursor;
 
    QList<QTextEdit::ExtraSelection> selections;
    selections.append(selection);
 
    ui->textEdit->setExtraSelections(selections);
}

然后在 oncursorPositionChanged() 中调用即可:

void Widget::oncursorPositionChanged()
{
    updateCursorPositionInfo();
}

如果你希望我帮你:

  • 添加行号显示功能;
  • 支持多行高亮;
  • 或者实现类似 VS Code 的编辑器界面;

到此这篇关于Qt如何实现文本编辑器光标高亮技术的文章就介绍到这了,更多相关Qt文本高亮内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 一文快速掌握C++双端数组容器deque的使用

    一文快速掌握C++双端数组容器deque的使用

    本文和大家分享的是和vector容器功能很像的容器——deque,了解deque容器的本质,使用方法以及与vector容器的不同之处,感兴趣的快跟随小编一起学习学习吧
    2022-07-07
  • C++实现字符串转整数(atoi)的代码详解

    C++实现字符串转整数(atoi)的代码详解

    在编程中,经常会遇到将字符串转换为整数的需求,就像标准库中的 atoi 函数一样,本文给大家介绍了C++中字符串转整数(atoi)的实现与解析,并有详细的代码示例供大家参考,需要的朋友可以参考下
    2025-04-04
  • Opencv 马赛克和毛玻璃效果与图片融合的实现

    Opencv 马赛克和毛玻璃效果与图片融合的实现

    这篇文章主要为大家详细介绍了通过OpenCV实现马赛克和毛玻璃滤镜效果与图片的融合,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • c++实现简单随机数的代码

    c++实现简单随机数的代码

    在本篇文章里小编给大家整理的是一篇关于c++实现简单随机数的代码内容,有需要的朋友们可以跟着学习下。
    2021-05-05
  • C语言结构体定义的方法汇总

    C语言结构体定义的方法汇总

    结构体是一种工具,用这个工具可以定义自己的数据类型。下面通过本文给大家分享了C语言结构体定义的方法汇总,需要的朋友参考下吧
    2017-12-12
  • 适合初学者的C语言字符串讲解

    适合初学者的C语言字符串讲解

    字符串主要用于编程,概念说明、函数解释、用法详述见正文,这里补充一点:字符串在存储上类似字符数组,所以它每一位的单个元素都是可以提取的
    2022-04-04
  • C语言模拟实现扫雷游戏

    C语言模拟实现扫雷游戏

    这篇文章主要为大家详细介绍了C语言模拟实现扫雷游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-01-01
  • C++ 让函数返回数组的方法

    C++ 让函数返回数组的方法

    这篇文章主要介绍了C++ 让函数返回数组的方法,文中讲解非常细致,代码帮助大家更好的理解和学习,感兴趣的朋友可以了解下
    2020-07-07
  • C语言详细实现猜拳游戏流程

    C语言详细实现猜拳游戏流程

    在学习了循环、分支、和函数之后,可以写一些简单的小游戏来给自己的编程之路增添一份乐趣。不仅提升了编码能力,还可以边学边玩,简直妙哉妙哉
    2022-05-05
  • C++ 字符串string和整数int的互相转化操作

    C++ 字符串string和整数int的互相转化操作

    这篇文章主要介绍了C++ 字符串string和整数int的互相转化操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12

最新评论