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

Мэтью Нейл

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

Обязательный символ	Символы, которые разрешены, но не обязательны	Значение
A	a	Символы ASCII А–Z, а–z
N	n	Символы ASCII A–Z, a–z, 0–9
X	x	Любой символ
9	0	Цифры 0–9
D	d	Цифры 1–9

Наша

inputMask

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

Таблица 17.2

Символ	Значение
#	Разрешен, но не обязателен знак +/-
>	Преобразует все последующие введенные символы в символы верхнего регистра.
<	Преобразует все последующие введенные символы в символы нижнего регистра
!	Останавливает преобразование регистра
\	Символ управляющей последовательности для применения специальных символов в качестве разделителей

Все остальные символы в

inputMask

действуют как разделители в поле ввода

QLineEdit

.

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

Таблица 17.3

Пример	Допустимый ввод
"AAAAAA-999D"	Допустимо Athens-2004, но не Sydney-2000 или Atlanta-1996
"ААААnn-99-99;"	Допустимо March-03-12, но не Мау-03-12 или September-03-12
"000.000.000.000"	Допустим IP-адрес, например, 192.168.0.1

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

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

QLineEdit

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

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>