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 приведены примеры таких символов и их значения.
| Обязательный символ | Символы, которые разрешены, но не обязательны | Значение |
|---|---|---|
| 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).
| Символ | Значение |
|---|---|
# | Разрешен, но не обязателен знак +/- |
> | Преобразует все последующие введенные символы в символы верхнего регистра. |
< | Преобразует все последующие введенные символы в символы нижнего регистра |
! | Останавливает преобразование регистра |
\ | Символ управляющей последовательности для применения специальных символов в качестве разделителей |
Все остальные символы в inputMask действуют как разделители в поле ввода QLineEdit.
В табл. 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.
QLineEditПосмотрим, как действует виджет QLineEdit.
1. Сначала — заголовочный файл LineEdit.h:
#include
#include
#include
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
#include
#include
#include
#include
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");