【Qt快速入门（六）】- QLineEdit按钮的使用

Qt快速入门（六）- QLineEdit按钮的使用

QLineEdit按钮的使用

QLineEdit是Qt框架中用于文本输入的单行输入控件。它提供了丰富的功能，包括文本输入、文本验证、占位符提示、密码输入等。本文将详细讲解QLineEdit的使用，包括其基本用法、文本处理、输入验证、样式设置、信号与槽机制、扩展功能以及在Qt Designer中的使用。

QLineEdit的基本用法

QLineEdit控件可以通过Qt Designer设计界面，也可以通过代码动态创建和设置。以下是一些常见的用法示例。

1. 创建和设置文本

QLineEdit可以通过构造函数创建，并使用setText方法设置初始文本。

#include <QApplication>
#include <QLineEdit>int main(int argc, char *argv[]) {QApplication app(argc, argv);QLineEdit lineEdit;lineEdit.setText("Hello, World!");lineEdit.show();return app.exec();
}

在这个简单示例中，QLineEdit被创建并设置了初始文本“Hello, World!”。show方法用于显示控件。

2. 获取输入文本

可以使用text方法获取QLineEdit中的文本。

#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>
#include <QMessageBox>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;QPushButton button("Show Text");layout.addWidget(&lineEdit);layout.addWidget(&button);QObject::connect(&button, &QPushButton::clicked, [&lineEdit]() {QMessageBox::information(nullptr, "Text", "You entered: " + lineEdit.text());});window.show();return app.exec();
}

在这个示例中，当按钮被点击时，会弹出一个消息框，显示QLineEdit中的文本。

3. 清空输入文本

可以使用clear方法清空QLineEdit中的文本。

#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;QPushButton button("Clear Text");layout.addWidget(&lineEdit);layout.addWidget(&button);QObject::connect(&button, &QPushButton::clicked, [&lineEdit]() {lineEdit.clear();});window.show();return app.exec();
}

在这个示例中，当按钮被点击时，QLineEdit中的文本会被清空。

文本处理

QLineEdit提供了多种方法处理文本输入，包括选择文本、设置光标位置、撤销和重做等。

1. 选择文本

可以使用selectAll方法选择QLineEdit中的所有文本，使用setSelection方法选择特定范围的文本。

#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;lineEdit.setText("Hello, World!");QPushButton selectButton("Select All");QPushButton partialSelectButton("Select Partial");layout.addWidget(&lineEdit);layout.addWidget(&selectButton);layout.addWidget(&partialSelectButton);QObject::connect(&selectButton, &QPushButton::clicked, [&lineEdit]() {lineEdit.selectAll();});QObject::connect(&partialSelectButton, &QPushButton::clicked, [&lineEdit]() {lineEdit.setSelection(7, 5);  // Select "World"});window.show();return app.exec();
}

在这个示例中，按钮分别用于选择QLineEdit中的所有文本和部分文本。

2. 设置光标位置

可以使用setCursorPosition方法设置光标位置，使用cursorPosition方法获取当前光标位置。

#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>
#include <QLabel>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;lineEdit.setText("Hello, World!");QPushButton cursorButton("Set Cursor Position");QLabel cursorPositionLabel("Cursor Position: 0");layout.addWidget(&lineEdit);layout.addWidget(&cursorButton);layout.addWidget(&cursorPositionLabel);QObject::connect(&cursorButton, &QPushButton::clicked, [&lineEdit, &cursorPositionLabel]() {lineEdit.setCursorPosition(5);  // Set cursor position after "Hello"cursorPositionLabel.setText("Cursor Position: " + QString::number(lineEdit.cursorPosition()));});window.show();return app.exec();
}

在这个示例中，按钮用于设置光标位置，并显示当前光标位置。

3. 撤销和重做

可以使用undo和redo方法实现文本输入的撤销和重做功能。

#include <QApplication>
#include <QLineEdit>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;QPushButton undoButton("Undo");QPushButton redoButton("Redo");layout.addWidget(&lineEdit);layout.addWidget(&undoButton);layout.addWidget(&redoButton);QObject::connect(&undoButton, &QPushButton::clicked, [&lineEdit]() {lineEdit.undo();});QObject::connect(&redoButton, &QPushButton::clicked, [&lineEdit]() {lineEdit.redo();});window.show();return app.exec();
}

在这个示例中，按钮用于撤销和重做文本输入操作。

输入验证

QLineEdit支持多种输入验证方式，包括输入掩码、校验器和输入限制。

1. 输入掩码

可以使用setInputMask方法设置输入掩码，以限制用户输入的格式。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit phoneLineEdit;phoneLineEdit.setInputMask("[phone]");  // Phone number masklayout.addWidget(&phoneLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为电话号码输入掩码，只允许用户输入指定格式的电话号码。

2. 校验器

可以使用QValidator类或其子类（如QIntValidator、QDoubleValidator和QRegExpValidator）设置输入校验器。

#include <QApplication>
#include <QLineEdit>
#include <QIntValidator>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit intLineEdit;QIntValidator intValidator(0, 100);  // Only allow integers between 0 and 100intLineEdit.setValidator(&intValidator);layout.addWidget(&intLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为只允许输入0到100之间的整数。

3. 输入限制

可以使用setMaxLength方法限制QLineEdit的最大输入长度，使用setReadOnly方法将QLineEdit设置为只读。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit limitedLineEdit;limitedLineEdit.setMaxLength(10);  // Limit input length to 10 charactersQLineEdit readOnlyLineEdit;readOnlyLineEdit.setText("Read-Only Text");readOnlyLineEdit.setReadOnly(true);  // Set to read-onlylayout.addWidget(&limitedLineEdit);layout.addWidget(&readOnlyLineEdit);window.show();return app.exec();
}

在这个示例中，第一个QLineEdit被限制为最多输入10个字符，第二个QLineEdit被设置为只读。

样式设置

QLineEdit支持丰富的样式设置，包括字体、颜色、背景等。以下是一些常见的样式设置方法。

1. 设置字体和颜色

可以使用setFont方法设置QLineEdit的字体，使用setStyleSheet方法设置颜色和其他样式。

#include <QApplication>
#include <QLineEdit>
#include <QFont>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit styledLineEdit;QFont font("Arial", 14, QFont::Bold);styledLineEdit.setFont(font);styledLineEdit.setStyleSheet("color: blue; background-color: yellow;");layout.addWidget(&styledLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为Arial字体、14号、加粗，文本颜色为蓝色，背景颜色为黄色。

2. 占位符文本

可以使用setPlaceholderText方法设置QLineEdit的占位符文本，提示用户输入内容。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit placeholderLineEdit;placeholderLineEdit.setPlaceholderText("Enter your name...");layout.addWidget(&placeholderLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为显示占位符文本“Enter your name…”。

3. 密码输入

可以使用setEchoMode方法设置QLineEdit为密码输入模式，以隐藏用户输入的内容。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit passwordLineEdit;passwordLineEdit.setEchoMode(QLineEdit::Password);layout.addWidget(&passwordLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为密码输入模式，用户输入的内容将以星号（*）显示。

信号与槽机制

QLineEdit提供了多种信号，用于处理文本变化、编辑完成等事件。

1.文本变化信号

textChanged和textEdited信号用于处理文本变化事件。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>
#include <QLabel>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;QLabel textChangedLabel("Text Changed: ");QLabel textEditedLabel("Text Edited: ");layout.addWidget(&lineEdit);layout.addWidget(&textChangedLabel);layout.addWidget(&textEditedLabel);QObject::connect(&lineEdit, &QLineEdit::textChanged, [&textChangedLabel](const QString &text) {textChangedLabel.setText("Text Changed: " + text);});QObject::connect(&lineEdit, &QLineEdit::textEdited, [&textEditedLabel](const QString &text) {textEditedLabel.setText("Text Edited: " + text);});window.show();return app.exec();
}

在这个示例中，textChanged信号在文本变化时触发，textEdited信号在用户编辑文本时触发。

2. 编辑完成信号

editingFinished信号在用户完成编辑并按下回车键或失去焦点时触发。

#include <QApplication>
#include <QLineEdit>
#include <QVBoxLayout>
#include <QWidget>
#include <QLabel>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit lineEdit;QLabel editingFinishedLabel("Editing Finished: ");layout.addWidget(&lineEdit);layout.addWidget(&editingFinishedLabel);QObject::connect(&lineEdit, &QLineEdit::editingFinished, [&lineEdit, &editingFinishedLabel]() {editingFinishedLabel.setText("Editing Finished: " + lineEdit.text());});window.show();return app.exec();
}

在这个示例中，editingFinished信号在用户完成编辑时触发，并显示编辑完成后的文本。

扩展功能

QLineEdit还支持一些扩展功能，如自动完成和上下文菜单。

1. 自动完成

可以使用QCompleter类实现QLineEdit的自动完成功能。

#include <QApplication>
#include <QLineEdit>
#include <QCompleter>
#include <QStringList>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);QLineEdit autoCompleteLineEdit;QStringList wordList = {"apple", "banana", "cherry", "date", "fig", "grape"};QCompleter completer(wordList);autoCompleteLineEdit.setCompleter(&completer);layout.addWidget(&autoCompleteLineEdit);window.show();return app.exec();
}

在这个示例中，QLineEdit被设置为支持自动完成，用户输入时会显示匹配的单词列表。

2. 上下文菜单

可以通过继承QLineEdit并重写contextMenuEvent方法自定义上下文菜单。

#include <QApplication>
#include <QLineEdit>
#include <QMenu>
#include <QVBoxLayout>
#include <QWidget>class CustomLineEdit : public QLineEdit {Q_OBJECTpublic:CustomLineEdit(QWidget *parent = nullptr) : QLineEdit(parent) {}protected:void contextMenuEvent(QContextMenuEvent *event) override {QMenu *menu = createStandardContextMenu();menu->addAction("Custom Action", this, SLOT(customAction()));menu->exec(event->globalPos());delete menu;}private slots:void customAction() {setText("Custom Action Triggered");}
};int main(int argc, char *argv[]) {QApplication app(argc, argv);QWidget window;QVBoxLayout layout(&window);CustomLineEdit customLineEdit;layout.addWidget(&customLineEdit);window.show();return app.exec();
}#include "main.moc"

在这个示例中，QLineEdit被继承并添加了一个自定义的上下文菜单项。

总结

QLineEdit是Qt框架中功能强大且灵活的单行文本输入控件。通过详细了解QLineEdit的基本用法、文本处理、输入验证、样式设置、信号与槽机制、扩展功能以及在Qt Designer中的使用，开发者可以在实际项目中充分利用QLineEdit的优势，构建出丰富多样的用户界面。无论是简单的文本输入、复杂的格式验证还是自定义样式的高级输入框，QLineEdit都能满足开发者的需求，使得应用程序更加友好和易用。