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;
    }
}