引言

在圖形用戶界面（GUI）設(shè)計領(lǐng)域中，文本編輯控件是不可或缺的元素之一，它們?yōu)橛脩籼峁┝溯斎搿⒕庉嫼惋@示文本內(nèi)容的平臺。在Qt中，QTextEdit和QPlainTextEdit作為Qt框架中兩個重要的文本編輯控件，各自擁有獨特的特點和適用場景。本文旨在深入解析QTextEdit與QPlainTextEdit的功能、用法及其區(qū)別，幫助開發(fā)者根據(jù)實際需求選擇最合適的控件來優(yōu)化用戶體驗和應(yīng)用程序性能。無論是需要支持富文本格式（如HTML、樣式化文本）的場景，還是追求高效純文本編輯的場合，通過本文的詳細(xì)闡述，您都將獲得全面的指導(dǎo)和實踐建議。讓我們一同探索這兩個控件的奧秘，為您的Qt應(yīng)用程序增添更加豐富的文本處理能力。

一、QTextEdit 控件 

1.1 概述

QTextEdit 是 Qt 提供的一個功能強大的富文本編輯控件，它允許用戶輸入和編輯包含多種格式的文本，如字體、字號、顏色、段落樣式、列表、圖片等。它基于 QAbstractScrollArea 類，具備自動換行、滾動條等基本功能，適用于需要復(fù)雜文本排版的場景，比如撰寫文檔、郵件客戶端的郵件正文編輯等。

1.2 主要特性

1.2.1 富文本格式支持

用戶可以通過工具欄按鈕、快捷鍵（類似于常見的文字處理軟件）或編程方式設(shè)置文本的字體特性，如 QFont 類可以指定字體家族（如 Arial、Times New Roman 等）、字號（如 12pt、16pt 等）、加粗、傾斜、下劃線等樣式。例如： 

QTextEdit *textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();
QFont font;
font.setFamily("Arial"); // 設(shè)置字體樣式
font.setPointSize(14); // 設(shè)置字體大小
font.setBold(true); // 設(shè)置字體為粗體
cursor.setCharFormat(QTextCharFormat().setFont(font));
textEdit->setTextCursor(cursor);

1.2.2 文本顏色

文本顏色可以使用 QColor 類來設(shè)置，支持常見的顏色表示方式，如 RGB 值、顏色名稱等。同樣通過 QTextCharFormat 來應(yīng)用到文本片段上： 

QColor redColor(255, 0, 0);
QTextCharFormat format;
format.setForeground(redColor);
cursor.setCharFormat(format);

1.2.3 段落格式

段落格式的對齊對于文檔排版至關(guān)重要，QTextEdit 借助 QTextBlockFormat 類輕松實現(xiàn)多種對齊方式。 

#include <QTextEdit>
#include <QTextCursor>
#include <QTextBlockFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

// 居中對齊段落
QTextBlockFormat blockFormat;
blockFormat.setAlignment(Qt::AlignCenter);
cursor.mergeBlockFormat(blockFormat);

textEdit->setTextCursor(cursor);

這里創(chuàng)建 QTextBlockFormat 并指定對齊方式為居中對齊 Qt::AlignCenter，再通過光標(biāo)將此格式應(yīng)用到段落，實現(xiàn)段落文本在 QTextEdit 控件中的居中顯示。同樣，還可將對齊方式設(shè)置為 Qt::AlignLeft（左對齊）、Qt::AlignRight（右對齊）、Qt::AlignJustify（兩端對齊）以滿足不同排版要求。

除了段落對齊方式之外，段落縮進、懸掛縮進等格式設(shè)置也可以精確控制，滿足不同的排版需求，這對于文檔排版非常關(guān)鍵，能使文本結(jié)構(gòu)清晰。以下是一個設(shè)置縮進的樣例：

// 設(shè)置段落首行縮進
blockFormat.setTextIndent(20);
// 設(shè)置懸掛縮進
blockFormat.setIndent(30);
cursor.mergeBlockFormat(blockFormat);

1.2.4 列表支持

QTextEdit 提供便捷的列表創(chuàng)建功能，包括有序列表和無序列表，利用 QTextListFormat 來定義列表樣式。

有序列表：

#include <QTextEdit>
#include <QTextCursor>
#include <QTextListFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
cursor.insertList(listFormat);

textEdit->setTextCursor(cursor);

上述代碼創(chuàng)建 QTextListFormat 并設(shè)定樣式為 ListDecimal（十進制數(shù)字序號的有序列表），隨后通過光標(biāo)在文本光標(biāo)處插入列表，后續(xù)輸入的文本將自動按照有序列表格式排列，如 “1. 第一項”“2. 第二項” 等。

無序列表： 

#include <QTextEdit>
#include <QTextCursor>
#include <QTextListFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDisc);
cursor.insertList(listFormat);

textEdit->setTextCursor(cursor);

這里將列表樣式設(shè)置為 ListDisc（圓盤樣式的無序列表），形成常見的無序列表外觀，輸入文本時會以 “?第一項”“?第二項” 等形式呈現(xiàn)。

1.2.5 圖片插入

可以在文本中嵌入圖片，支持常見的圖片格式（如 PNG、JPEG 等）。通過 QTextDocumentFragment 和 QPixmap 結(jié)合來實現(xiàn)，例如： 

QPixmap pixmap(":/image.png");
QTextDocumentFragment fragment = QTextDocumentFragment::fromImage(pixmap);
textEdit->textCursor().insertFragment(fragment);

1.2.6 超鏈接支持

文本中的超鏈接能夠被識別，用戶點擊超鏈接可打開對應(yīng)的網(wǎng)頁或資源?？梢允褂?QTextCharFormat 設(shè)置超鏈接的格式（如顏色、下劃線樣式），并關(guān)聯(lián) URL：

#include <QTextEdit>
#include <QTextCursor>
#include <QTextCharFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

QTextCharFormat linkFormat;
linkFormat.setAnchor(true);
linkFormat.setForeground(Qt::blue);
linkFormat.setAnchorHref("https://www.example.com");
cursor.setCharFormat(linkFormat);

textEdit->setTextCursor(cursor);

此示例先創(chuàng)建 QTextCharFormat，開啟錨點 setAnchor(true)，設(shè)置前景色為藍色以突出顯示超鏈接文本，再指定目標(biāo) URL setAnchorHref("https://www.example.com")，最后通過光標(biāo)將格式應(yīng)用到文本，使文本變?yōu)榭牲c擊的超鏈接，點擊后將在瀏覽器中打開指定網(wǎng)頁。

1.3 信號與槽 

QTextEdit 提供了豐富的信號來響應(yīng)文本編輯過程中的各種事件。 

1.3.1 textChanged()

只要文本內(nèi)容發(fā)生任何更改，該信號就會被發(fā)射，非常適合用于實時保存文檔草稿、更新相關(guān)狀態(tài)信息等場景。例如： 

connect(textEdit, &QTextEdit::textChanged, this, [this]() {
    // 在這里進行保存草稿或更新界面顯示相關(guān)操作
    saveDraft(); // 這個函數(shù)需要自己實現(xiàn)
});

每當(dāng)文本編輯發(fā)生改變，textChanged 信號被觸發(fā)，進而調(diào)用 saveDraft 函數(shù)實現(xiàn)草稿保存。

1.3.2 cursorPositionChanged()

當(dāng)文本光標(biāo)的位置改變時觸發(fā)，對于需要根據(jù)光標(biāo)位置動態(tài)調(diào)整界面元素（如顯示當(dāng)前段落格式工具提示）或執(zhí)行特定操作（如在狀態(tài)欄顯示光標(biāo)位置信息）很有用：

connect(textEdit, &QTextEdit::cursorPositionChanged, this, [this]() {
    QTextCursor cursor = textEdit->textCursor();
    int position = cursor.position();
    // 更新狀態(tài)欄顯示光標(biāo)位置
    statusBar()->showMessage(QString("Cursor at position: %1").arg(position));
});

1.3.3 selectionChanged()

當(dāng)用戶通過鼠標(biāo)或鍵盤操作改變了文本選中區(qū)域時觸發(fā)，可用于實現(xiàn)復(fù)制、剪切、粘貼等操作的相關(guān)功能，以及對選中文本進行特殊處理，如統(tǒng)計選中字?jǐn)?shù)、更改選中文本格式等：

connect(textEdit, &QTextEdit::selectionChanged, this, [this]() {
    QTextCursor cursor = textEdit->textCursor();
    int selectedLength = cursor.selectedText().length();
    // 更新界面顯示選中字?jǐn)?shù)
    selectedWordCountLabel->setText(QString("Selected words: %1").arg(selectedLength));
});

1.4 文檔模型

1.4.1 獲取文檔信息

可以直接訪問 QTextEdit 的文檔對象獲取字符數(shù)、段落數(shù)等信息。

#include <QTextEdit>
#include <QTextDocument>

QTextEdit* textEdit = new QTextEdit(this);
QTextDocument* document = textEdit->document();
int charCount = document->characterCount();
int paragraphCount = document->blockCount();

上述代碼獲取文檔對象后，分別調(diào)用 characterCount 和 blockCount 函數(shù)，得到文本中的字符總數(shù)和段落總數(shù)，便于進行文檔統(tǒng)計分析。

1.4.2 查找和替換操作

QTextDocument 支持查找和替換文本，包括簡單文本查找與正則表達式查找。 

#include <QTextDocument>

QTextEdit* textEdit = new QTextEdit(this);
QTextDocument* document = textEdit->document();
QTextCursor cursor = document->find("search term", textEdit->textCursor());
if (!cursor.isNull()) {
    // 找到了匹配文本，可進行進一步操作，如突出顯示
    QTextCharFormat format;
    format.setBackground(Qt::yellow);
    cursor.mergeCharFormat(format);
}

這里在文檔中查找指定文本 “search term”，若找到，創(chuàng)建黃色背景的 QTextCharFormat 并應(yīng)用到匹配文本，實現(xiàn)突出顯示查找結(jié)果的功能。

二、QPlainTextEdit 控件

2.1 概述

QPlainTextEdit 是一個輕量級的文本編輯控件，它專注于純文本的輸入和編輯，不支持 QTextEdit 中的復(fù)雜富文本格式，如字體樣式、段落對齊之外的高級排版、圖片插入等。但正因為其簡潔性，它在性能上更具優(yōu)勢，適用于處理大量純文本的場景，如代碼編輯器、日志查看器、簡單的文本輸入框等。

2.2 主要特性

2.2.1 純文本高效處理

對于純文本的讀寫操作速度較快，因為它不需要處理復(fù)雜的富文本格式標(biāo)記和渲染。在加載大型文本文件（如代碼文件、日志文件）時，相比 QTextEdit 能更快地顯示內(nèi)容，占用資源相對較少。例如，讀取一個幾十兆字節(jié)的代碼文件： 

QPlainTextEdit *plainTextEdit = new QPlainTextEdit(this);
QFile file(":/large_code_file.cpp");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QTextStream in(&file);
    plainTextEdit->setPlainText(in.readAll());
    file.close();
}

2.2.2 基本文本格式支持

雖然不支持富文本的多樣化字體樣式，但它保留了一些基本的文本格式控制，如換行符的正常顯示，文本可以自動換行，也可以通過設(shè)置 QPlainTextEdit 的 lineWrapMode 屬性來控制換行模式，如 NoWrap（不換行）、WidgetWidth（根據(jù)控件寬度換行）等：

plainTextEdit->setLineWrapMode(QPlainTextEdit::NoWrap);

它還支持文本的選中、復(fù)制、粘貼等基本操作，這些操作的快捷鍵（如 Ctrl + C、Ctrl + V）與常見系統(tǒng)操作一致，方便用戶使用。

2.3 信號與槽 

2.3.1 textChanged()

同樣，只要文本內(nèi)容有改變，該信號就會發(fā)射，用于類似實時保存文本、更新相關(guān)統(tǒng)計信息等功能。例如在一個簡單的文本輸入日志應(yīng)用中： 

connect(plainTextEdit, &QPlainTextEdit::textChanged, this, [this]() {
    saveLogEntry(); // 這個函數(shù)的具體實現(xiàn)也需要自己寫
});

2.3.2 cursorPositionChanged()

當(dāng)光標(biāo)位置變動時觸發(fā)，可用于在狀態(tài)欄顯示當(dāng)前行號、列號等信息，方便用戶了解在文本中的位置：

connect(plainTextEdit, &QPlainTextEdit::cursorPositionChanged, this, [this]() {
    QTextCursor cursor = plainTextEdit->textCursor();
    int lineNumber = cursor.blockNumber() + 1;
    int columnNumber = cursor.positionInBlock() + 1;
    statusBar()->showMessage(QString("Line: %1, Column: %2").arg(lineNumber).arg(columnNumber));
});

三、QTextEdit 與 QPlainTextEdit 的對比

3.1 功能特性

QTextEdit 具有豐富的富文本功能，能創(chuàng)建精美的文檔效果，適合需要復(fù)雜排版、圖文混排、超鏈接等場景；而 QPlainTextEdit 專注于純文本處理，功能簡潔，更側(cè)重文本的快速輸入與高效編輯，如代碼編寫、大量純文本數(shù)據(jù)查看。

3.2 性能

由于 QPlainTextEdit 不需要處理復(fù)雜的富文本渲染，在處理大量文本（尤其是純文本）時性能更優(yōu)，加載和顯示速度更快；QTextEdit 在處理復(fù)雜格式時會消耗更多資源，對于性能要求苛刻且只需純文本的場景不太適合。

3.3 適用場景

如果開發(fā)一個類似 Microsoft Word 的文檔處理軟件，QTextEdit 是首選；要是打造一個代碼編輯器、日志監(jiān)控工具，QPlainTextEdit 能更好地滿足需求，提供流暢的純文本操作體驗。

3.4 學(xué)習(xí)曲線

對于初學(xué)者來說，QPlainTextEdit 相對簡單，因為其功能和信號槽機制較為直接，專注于基本文本操作；QTextEdit 由于富文本格式的復(fù)雜性，涉及更多的格式類（如 QTextCharFormat、QTextBlockFormat 等）和操作邏輯，學(xué)習(xí)成本稍高，但一旦掌握能實現(xiàn)非常強大的文本處理功能。

結(jié)語

在 Qt 開發(fā)中，根據(jù)具體應(yīng)用的功能需求、性能要求和用戶體驗?zāi)繕?biāo)，合理選擇 QTextEdit 或 QPlainTextEdit 控件，能夠為項目打造出高效、易用的文本編輯界面。無論是復(fù)雜的富文本創(chuàng)作還是簡潔的純文本處理，這兩個控件都提供了堅實的基礎(chǔ)，開發(fā)者可以在此基礎(chǔ)上進一步擴展和定制，滿足多樣化的應(yīng)用場景。 

到此這篇關(guān)于Qt中QTextEdit和QPlainTextEdit控件的實現(xiàn)的文章就介紹到這了,更多相關(guān)Qt QTextEdit和QPlainTextEdit內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論