【Qt控件之QLineEdit、QPlainTextEdit 、QTextEdit 、QTextBrowser】使用及区别

介绍

QLineEdit、QPlainTextEdit、QTextEdit和QTextBrowser都是Qt中用于文本输入和显示的控件，它们之间有一些区别，适用于不同的场景。
下面是对这四个类的简要介绍、区别和使用技巧：

作用

名称	作用
QLineEdit	QLineEdit是一个简单的单行文本输入控件，用于用户输入短文本或关键字。
QPlainTextEdit	QPlainTextEdit是Qt中的一个多行文本输入和显示控件，用于编辑和显示大量文本。它提供了简单的纯文本编辑功能，并支持基本的文本格式化和样式设置。
QTextEdit	QTextEdit是一个富文本编辑器控件，支持编辑和显示富文本内容，包括字体、颜色、样式等
QTextBrowser	QTextBrowser是一个富文本显示控件，用于显示富文本内容，不支持编辑。

区别

名称	作用
QLineEdit	QLineEdit只能输入单行文本，并不支持多行文本输入。
QPlainTextEdit	QPlainTextEdit可以输入和显示多行文本，支持基本的文本编辑功能。
QTextEdit	QTextEdit相比于QPlainTextEdit，支持更丰富的文本格式和样式设置，可以插入图片、超链接、表格等富文本元素。
QTextBrowser	QTextBrowser与QTextEdit的主要区别在于是否支持编辑功能，QTextBrowser只用于显示文本，不能进行编辑操作。

使用技巧

名称	作用
QLineEdit	可以设置QLineEdit的输入限制、输入掩码等属性来控制用户输入的内容格式；可以通过信号槽机制来进行输入验证和实时反馈。
QPlainTextEdit	可以通过QTextCursor类来控制光标的位置和选择文本；可以使用QTextDocument类来操作文本内容，如插入、删除、查找等操作；可以通过QPlainTextEdit的信号槽机制来实现实时更新和响应用户操作。
QTextEdit	可以通过QTextDocument类来操作文本内容和样式，包括插入文本、设置字体属性、添加样式表等；可以使用QTextCursor类来控制光标的位置，进行文本选择和编辑；可以通过QTextDocument的信号槽机制来捕获文本变化、链接点击等事件。
QTextBrowser	可以使用QTextBrowser来加载、显示和浏览带有富文本特性的内容，如HTML页面、格式化的文档等；可以通过设置QTextBrowser的打开外部链接和点击超链接的行为。

在使用这四个类的时候，可以根据具体需求选择适合的控件。

• 如果只需要简单的单行文本输入，使用QLineEdit就足够；
• 如果需要多行文本输入和基本的文本编辑功能，使用QPlainTextEdit；
• 如果需要富文本编辑和格式控制，使用QTextEdit；
• 如果只需要显示富文本内容，使用QTextBrowser。

另外，在使用这些控件时，还可以设置属性、连接信号槽来进行更多的自定义和交互。

QLineEdit 示例

1. setText(const QString& text)：设置LineEdit的文本内容。

QLineEdit* lineEdit = new QLineEdit();
lineEdit->setText("Hello World");

2. text()：获取LineEdit的当前文本内容。

QString text = lineEdit->text();

3. setPlaceholderText(const QString& text)：设置占位文本，当LineEdit为空时显示的提示文本。

lineEdit->setPlaceholderText("Please enter your name");

4. clear()：清除LineEdit的文本内容。

lineEdit->clear();

5. setReadOnly(bool readOnly)：设置LineEdit是否只读。

lineEdit->setReadOnly(true);

6. setMaxLength(int length)：设置最大输入长度。如果设置为0，则没有长度限制。

lineEdit->setMaxLength(10);

7. setValidator(const QValidator* validator)：设置输入验证器，用于限制输入的格式。

QRegExpValidator* validator = new QRegExpValidator(QRegExp("[0-9a-z]+"), lineEdit);
lineEdit->setValidator(validator);

通过上述代码，使用了QRegExpValidator来限制LineEdit只能输入0-9和小写字母a-z的字符。QRegExpValidator是使用正则表达式进行输入验证的一个类。

8. setEchoMode(QLineEdit::EchoMode mode)：设置LineEdit的回显模式，即输入内容显示的方式。常用的模式有以下几种：
   • QLineEdit::Normal：正常显示输入内容（默认）。
   • QLineEdit::NoEcho：不显示输入内容。
   • QLineEdit::Password：显示输入内容为密码形式，一般用于输入密码的场景。
   • QLineEdit::PasswordEchoOnEdit：编辑时显示输入内容为密码形式，其他时间为正常显示。

lineEdit->setEchoMode(QLineEdit::Password);

通过设置EchoMode为Password，可以将输入内容以密码形式显示。

上述函数只是QLineEdit中的一部分常用函数，可以根据实际需求选择合适的函数进行使用。
使用技巧可以根据具体场景进行灵活应用，如结合信号槽机制进行输入验证、实时反馈等。

QPlainTextEdit示例

1. setPlainText(const QString& text)：设置QPlainTextEdit的纯文本内容。

QPlainTextEdit* plainTextEdit = new QPlainTextEdit();
plainTextEdit->setPlainText("Hello World");

2. toPlainText()：获取QPlainTextEdit的当前纯文本内容。

QString text = plainTextEdit->toPlainText();

3. appendPlainText(const QString& text)：在QPlainTextEdit的末尾添加纯文本内容。

plainTextEdit->appendPlainText("This is a new line");

4. clear()：清除QPlainTextEdit的所有文本内容。

plainTextEdit->clear();

5. setReadOnly(bool readOnly)：设置QPlainTextEdit是否只读。

plainTextEdit->setReadOnly(true);

6. setMaximumBlockCount(int maximum)：设置最大文本块数。当文本块数超过最大值时，旧的文本块将被删除。

plainTextEdit->setMaximumBlockCount(100);

7. setPlainTextInteractionFlags(Qt::TextInteractionFlags flags)：设置文本交互标志，用于限制文本的编辑和选择操作。

plainTextEdit->setPlainTextInteractionFlags(Qt::TextSelectableByMouse);

通过设置TextInteractionFlags为TextSelectableByMouse，可以限制用户只能通过鼠标选择文本，而无法进行编辑操作。

8. setLineWrapMode(QPlainTextEdit::LineWrapMode mode)：设置文本的换行模式。

plainTextEdit->setLineWrapMode(QPlainTextEdit::WidgetWidth);

通过设置LineWrapMode为WidgetWidth，可以根据控件的宽度自动换行显示文本。

9. setSizePolicy(QSizePolicy policy)：设置QPlainTextEdit的大小策略。

plainTextEdit->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);

通过设置SizePolicy为Expanding，可以使QPlainTextEdit随父窗口的大小而自动调整大小。

10. insertPlainText(const QString& text)：在光标位置插入纯文本内容。

QTextCursor cursor = plainTextEdit->textCursor();
cursor.insertPlainText("Inserted Text");

通过获取textCursor并调用insertPlainText函数，可以在光标位置插入指定的纯文本内容。

上述函数只是QPlainTextEdit中的一部分常用函数，可以根据实际需求选择合适的函数进行使用。
输入限制可以通过设置readOnly属性来实现只读功能，或通过自定义信号槽或事件过滤器来进行更加复杂的输入验证。

使用技巧包括但不限于：

• 结合信号槽机制和文本改变的信号，实现实时的文本处理和更新。
• 使用QTextCursor类进行更精确的文本操作，如插入、删除、选择等。
• 结合QTextDocument类来设置文本样式、行间距等高级功能。

QTextEdit示例

1. setText(const QString& text)：设置QTextEdit的纯文本内容。

QTextEdit* textEdit = new QTextEdit();
textEdit->setText("Hello World");

2. toPlainText()：获取QTextEdit的当前纯文本内容。

QString text = textEdit->toPlainText();

3. append(const QString& text)：在QTextEdit的末尾插入文本内容。

textEdit->append("This is a new line");

4. clear()：清除QTextEdit的所有文本内容。

textEdit->clear();

5. setReadOnly(bool readOnly)：设置QTextEdit是否只读。

textEdit->setReadOnly(true);

6. setMaximumBlockCount(int maximum)：设置最大文本块数。当文本块数超过最大值时，旧的文本块将被删除。

textEdit->setMaximumBlockCount(100);

7. setAcceptRichText(bool accept)：设置QTextEdit是否接受富文本格式。如果设置为false，所有格式化的文本将被当作纯文本处理。

textEdit->setAcceptRichText(true);

8. setSizePolicy(QSizePolicy policy)：设置QTextEdit的大小策略。同QPlainTextEdit。

9. setHtml(const QString& html)：设置QTextEdit的HTML格式内容。

textEdit->setHtml("
Hello World
");

10. insertHtml(const QString& html)：在光标位置插入HTML格式内容。

QTextCursor cursor = textEdit->textCursor();
cursor.insertHtml("
Inserted Text
");

输入限制与QPlainTextEdit类似，可以使用readOnly属性进行只读设置。
此外，通过使用QTextCursor的相关函数，可以进行更多复杂的文本操作，如插入图片、链接、表格，设置文本样式和段落格式等。

使用技巧包括但不限于：

• 使用QTextCursor进行文本操作，如插入、删除、编辑等，可以掌握更精确的文本控制。
• 结合QTextDocument类来设置、获取文本的格式和属性，如字体、颜色、对齐方式等。
• 通过信号槽机制，实现实时更新和处理文本。

QTextBrowser示例

1. setText(const QString& text)：设置QTextBrowser的纯文本内容。

QTextBrowser* textBrowser = new QTextBrowser();
textBrowser->setText("Hello World");

2. setHtml(const QString& html)：设置QTextBrowser的HTML格式内容。

textBrowser->setHtml("
Hello World
");

3. append(const QString& text)：在QTextBrowser的末尾插入文本内容。

textBrowser->append("This is a new line");

4. clear()：清除QTextBrowser的所有文本内容。

textBrowser->clear();

5. setReadOnly(bool readOnly)：设置QTextBrowser是否只读。

textBrowser->setReadOnly(true);

6. setAcceptRichText(bool accept)：设置QTextBrowser是否接受富文本格式。

textBrowser->setAcceptRichText(true);

7. anchorClicked(const QUrl& link)信号：链接点击事件信号。连接到此信号的槽函数可以处理链接的点击操作。

connect(textBrowser, &QTextBrowser::anchorClicked, [](const QUrl& link){
    qDebug() << "Link clicked:" << link.toString();
});

8. setSizePolicy(QSizePolicy policy)：设置QTextBrowser的大小策略。同QPlainTextEdit。

输入限制与QPlainTextEdit类似，可以使用readOnly属性进行只读设置。QTextBrowser主要用于显示文本内容，一般不做输入限制的处理。

使用技巧包括但不限于：

• 使用setSource()函数来指定QTextBrowser显示的富文本内容来自文件或URL。

textBrowser->setSource(QUrl("file:///path/to/file.html"));
textBrowser->setSource(QUrl("http://www.example.com"));

• 使用setTextInteractionFlags()函数来设置文本交互标志，例如限制用户只能选择文本而不能编辑等功能。

textBrowser->setTextInteractionFlags(Qt::TextSelectableByMouse | Qt::TextBrowserInteraction);

• 通过在HTML文本中插入图像和链接来丰富文本显示。使用和标签来插入链接和图像。

textBrowser->setHtml("This is a link");
textBrowser->setHtml("");