QTextCursor详解

一、QTextCursor简介

QTextCursor是Qt中用来操作QTextEdit和QPlainTextEdit的文本光标类。它可以实现文本的插入、删除、格式化、移动、选取和替换等功能。QTextCursor可以管理一个文本块中所有的字符和格式信息。

使用QTextCursor，我们可以将光标移动到特定的位置，也可以通过扩展光标的大小和形状来选择文本。它的一大优势是通过QTextCharFormat类来控制文本的格式，支持粗体、斜体、字体、颜色、背景色等多种样式。

二、QTextCursor的常用功能

1. 光标的控制

QTextCursor最基本的功能就是管理光标，它可以将光标的位置设置到特定的点或者区域，可以设置光标的形状和大小。以下是一些常用的光标控制函数：

QTextCursor::setPos(int pos)
//将光标移动到给定的文本索引处，文本索引是指字符内容在文档中的偏移量。

QTextCursor::setPosition(int pos, QTextCursor::MoveMode moveMode)
//将光标移动到给定的文本索引处，允许指定移动模式。

QTextCursor::movePosition(QTextCursor::MoveOperation operation, QTextCursor::MoveMode moveMode, int n = 1)
//相对于当前位置，将光标移动到新位置。

QTextCursor::setPosition(const QPointF &pos, QTextCursor::MoveMode moveMode)
//将光标移到给定坐标处。

2. 选中和编辑

通过QTextCursor，我们可以选择文档中的一定范围的字符，也可以进行插入、删除、替换和格式化的操作。以下是一些常用的选中和编辑函数：

QTextCursor::movePosition(MoveOperation operation, MoveMode mode = MoveAnchor, int n = 1)
//移动QTextCursor的位置，同时选中字符。

QTextCursor::deleteChar()
//删除光标后面的一个字符。

QTextCursor::insertText(const QString &text)
//在光标开头插入一个字符串。

QTextCursor::removeSelectedText()
//删除选中的文本。

QTextCursor::selectedText() const
//返回当前选中的文本。

QTextCursor::selectedTableCells(QTextCursor::TabletSelectionMode mode = QTextCursor::KeepAnchor) const
//返回和设置表格中选中单元格。

3. 格式化

使用QTextCursor，我们可以轻松地更改文本格式，例如字体、字号、颜色、下划线、背景颜色等。以下是一些常用的格式化函数：

QTextCursor::setCharFormat(const QTextCharFormat &format)
//设置当前字符的格式。

QTextCursor::insertHtml(const QString &html)
//在光标所在位置插入HTML代码。

QTextCursor::setFont(const QFont &font)
//设置当前文字的字体。

QTextCursor::setBackgroundColor(const QColor &color)
//设置当前字符的背景色。

QTextCursor::setCharFormat(QTextCharFormat format)
//格式化选中的文本，将所有字符应用于给定的QTextCharFormat对象。

QTextCursor::select(QTextCursor::SelectionType selectionType)
//选择所包含的一部分文本。

三、QTextCursor的应用示例

1. 使用QTextCursor进行文本替换

使用QTextCursor，我们可以轻松地进行文本的替换。以下示例演示如何将所有的“hello”替换成“world”：

QTextCursor cursor = textEdit->textCursor(); //获取光标
cursor.beginEditBlock(); //开始编辑块

//查找所有包含“hello”的文本
while (!cursor.isNull() && !cursor.atEnd()) {
    cursor = textEdit->document()->find("hello", cursor,
                                        QTextDocument::FindWholeWords);
    if (!cursor.isNull()) {
        //选中找到的文本
        cursor.movePosition(QTextCursor::WordRight, QTextCursor::KeepAnchor);
        //替换文本
        cursor.insertText("world");
    }
}

cursor.endEditBlock(); //结束编辑块

2. 使用QTextCursor进行字符格式化

使用QTextCursor，我们可以设置选中字符的格式，以下示例演示如何将光标所在位置的文字设置为红色：

QTextCursor cursor = textEdit->textCursor(); //获取光标

QTextCharFormat format;
format.setForeground(Qt::red); //设置前景色为红色
format.setFontPointSize(14); //设置字号为14

cursor.setCharFormat(format); //设置光标处的文字格式

3. 使用QTextCursor进行HTML插入

使用QTextCursor，我们可以在文本中插入HTML代码，以下示例演示如何在光标所在位置插入一张图片：

QTextCursor cursor = textEdit->textCursor(); //获取光标

cursor.insertHtml(""); //在光标处插入图片

4. 使用QTextCursor获取表格中的数据

QTextEdit和QPlainTextEdit都支持表格，使用QTextCursor，我们可以轻松地获取表格中的数据。以下示例演示如何获取表格中选中单元格的数据。

QTextTable *table = cursor.currentTable();
if (table != nullptr) {
    //获取所有被选中的单元格
    QList cells = cursor.selectedTableCells();

    for (const QTextTableCell &cell : cells) {
        //获取单元格的文本
        QString cellText = cell.firstCursorPosition().block().text();

        //输出单元格的文本
        qDebug() << cellText;
    }
}