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

cpp 复制代码

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 的编辑器界面；

欢迎继续提问 😊