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