Основы программирования в 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>
Поделиться:
Популярные книги
Кровь Севера
3. Викинг
Фантастика:
альтернативная история
9.14
рейтинг книги
Корона мечей
7. Колесо Времени
Фантастика:
фэнтези
8.62
рейтинг книги
Будущее разума
Научно-образовательная:
прочая научная литература
физика
8.00
рейтинг книги
Бремя власти
3. Государи московские
Научно-образовательная:
история
7.25
рейтинг книги
Дьявольская секта (Сборник)
Бестселлер
Детективы:
криминальные детективы
боевики
5.00
рейтинг книги
Директива Джэнсона
Детективы:
шпионские детективы
7.00
рейтинг книги
Ключник
2. Викс
Фантастика:
фэнтези
рпг
попаданцы
9.25
рейтинг книги
Архимаг. Пробуждение. Трилогия
56. В одном томе
Фантастика:
научная фантастика
9.32
рейтинг книги
Самодержец пустыни
Проза:
историческая проза
6.25
рейтинг книги
Шайтан Иван 5
5. Шайтан Иван
Фантастика:
попаданцы
альтернативная история
историческое фэнтези
5.50
рейтинг книги
Санкт-Петербург. Автобиография
Научно-образовательная:
история
5.00
рейтинг книги
Печать мастера
6. Гибрид
Фантастика:
попаданцы
технофэнтези
аниме
фэнтези
6.00
рейтинг книги
Том 2. Рассказы и пьесы 1904-1907
2. Собрание сочинений в шести томах
Проза:
русская классическая проза
5.00
рейтинг книги
Локки 7. Потомок бога
7. Локки
Фантастика:
аниме
эпическая фантастика
фэнтези
5.00