Читаем Основы программирования в Linux полностью

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

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

#include

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.

Упражнение 17.4. Виджет QLineEdit

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