Книга: Основы программирования в Linux

QLineEdit

QLineEdit

QLineEdit — виджет для ввода однострочного текста. Применяйте его для ввода коротких фрагментов текста, таких как имя пользователя. В виджете QLineEdit можно ограничить длину вводимого текста с помощью маски ввода, предлагающей заполнить шаблон, или для дополнительного контроля можно применить функцию проверки допустимости, например, чтобы убедиться в том, что пользователь вводит корректные дату, номер телефона или подобные величины. У виджета QLineEdit есть функции редактирования, позволяющие выбирать части текста, вырезать и вставлять, отменять и повторять изменения, как командами пользователя, так и средствами API.

Далее перечислены конструкторы и наиболее полезные методы.

#include <qlineedit.h>
QLineEdit::QLineEdit(QWidget *parent, const char* name = 0);
QLineEdit::QLineEdit(const QString& contents, QWidget *parent,
 const char *name = 0);
QLineEdit::QLineEdit(const QString& contents, const QString& inputMask,
 QWidget *parent, const char* name = 0);
void setInputMask(const QString& inputMask);
void insert(const QString& newText);
bool isModified(void);
void setMaxLength(int length);
void setReadOnly(bool read);
void setText(const QString &text);
QString text(void);
void setEchoMode(EchoMode mode);

В конструкторах вы задаете как обычно родительский виджет и имя виджета с помощью параметров parent и name.

Интересно свойство EchoMode, определяющее способ отображения текста в виджете. Оно может принимать одно из трех значений:

? QLineEdit::Normal — отображать вводимые символы (по умолчанию);

? QLineEdit::Password — отображать звездочки на месте символов;

? QLineEdit::NoEcho — ничего не отображать. Задается режим отображения с помощью метода setEchoMode:

lineEdit->setEchoMode(QLineEdit::Password);

Усовершенствование, внесенное в версию Qt 3.2, — свойство inputMask, ограничивающее ввод в соответствии с правилом маски.

inputMask — это строка, сформированная из символов, каждый из которых соответствует правилу, принимающему диапазон определенных символов. Если вы знакомы с регулярными выражениями, inputMask использует во многом тот же самый принцип.

Есть два сорта символов, формирующих inputMask: первые указывают на необходимость присутствия определенного символа, вторые при наличии символа добиваются его соответствия заданному правилу. В табл. 17.1 приведены примеры таких символов и их значения.

Таблица 17.1

Наша inputMask — это строка, сформированная комбинацией этих символов и необязательно завершающаяся точкой с запятой. Существуют дополнительные специальные символы, у которых также есть значения (табл. 17.2).

Таблица 17.2

Все остальные символы в inputMask действуют как разделители в поле ввода QLineEdit.

В табл. 17.3 приведены примеры масок ввода и соответствующий им текст для ввода.

Таблица 17.3

Выполните упражнение 17.4.

Посмотрим, как действует виджет QLineEdit.

1. Сначала — заголовочный файл LineEdit.h:

#include <qmainwindow.h>
#include <qlineedit.h>
#include <qstring.h>
class LineEdit : public QMainWindow {
 Q_OBJECT
public:
 LineEdit(QWidget *parent = 0, const char *name = 0);
 QLineEdit *password_entry;
private slots:
 void Clicked();
};

2. LineEdit.cpp — уже знакомый файл реализации класса:

#include "LineEdit.moc"
#include <qpushbutton.h>
#include <qapplication.h>
#include <qlabel.h>
#include <qlayout.h>
#include <iostream>
LineEdit::LineEdit(QWidget *parent, const char *name) :
 QMainWindow(parent, name) {
 QWidget *widget = new QWidget(this);
 setCentralWidget(widget);

3. Для компоновки виджетов примените QGridLayout. Задайте число строк и столбцов, величины отступов и расстояния между виджетами:

 QGridLayout *grid = new QGridLayout(widget, 3, 2, 10, 10, "grid");
 QLineEdit *username_entry = new QLineEdit(widget, "username_entry");
 password_entry = new QLineEdit(widget, "password_entry");
 password_entry->setEchoMode(QLineEdit::Password);
 grid->addWidget(new QLabel("Username", widget, "userlabel"), 0, 0, 0);
 grid->addwidget(new QLabel("Password", widget, "passwordlabel"), 1, 0, 0);
 grid->addWidget(username_entry, 0, 1, 0);
 grid->addWidget(password_entry, 1, 1, 0);
 QPushButton *button = new QPushButton("Ok", widget, "button");
 grid->addWidget(button, 2, 1, Qt::AlignRight);
 resize(350, 200);
 connect(button, SIGNAL(clicked()), this, SLOT(Clicked()));
}
void LineEdit::Clicked(void) {
 std::cout << password_entry->text() << "n";
}
int main(int argc, char **argv) {
 QApplication app(argc, argv);
 LineEdit *window = new LineEdit();
 app.setMainWidget(window);
 window->show();
 return app.exec();
}

Выполнив эту программу, вы должны получить результат, показанный на рис. 17.5.

Рис. 17.5

Как это работает

Вы создали два виджета QLineEdit, один подготовили для ввода пароля, задав EchoMode, и заставили его выводить содержимое при щелчке мышью кнопки PushButton. Обратите внимание на виджет QGridLayout, который очень полезен для размещения виджетов в табличной сетке. Когда виджет вставляется в сетку таблицы, вы передаете номер строки и столбца, нумерация начинается с 0, нулевые номера строки и столбца у верхней левой ячейки.

Оглавление книги