Класс QInputDialog

Класс QInputDialog предоставляет простой диалог для получения единственного значения от пользователя. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Открытые типы

Свойства

Открытые функции

Реализованные публичные функции

Сигналы

Статические публичные члены

Подробное описание

Значение ввода может быть строкой, числом или элементом из списка. Для пользователя должна быть указана метка, поясняющая, что нужно ввести.

Предоставляются пять удобных статических функций: getText(), getMultiLineText(), getInt(), getDouble() и getItem(). Все функции можно использовать аналогичным образом, например:

    bool ok;
    QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                         tr("User name:"), QLineEdit::Normal,
                                         QDir::home().dirName(), &ok);
    if (ok && !text.isEmpty())
        textLabel->setText(text);

Переменная ok устанавливается в true, если пользователь нажимает кнопку ОК; в противном случае она устанавливается в false.

Пример Стандартных диалогов демонстрирует использование QInputDialog, а также других встроенных диалоговых окон Qt.

См. также QMessageBox и Пример Стандартных диалогов.

Документация по типам членов

перечисление QInputDialog::InputDialogOptionфлаги QInputDialog::InputDialogOptions

Это перечисление задает различные параметры, влияющие на внешний вид диалогового окна ввода.

Это перечисление было введено или изменено в Qt 4.5.

Тип InputDialogOptions — это псевдоним для QFlags<InputDialogOption>. Он хранит логическое ИЛИ сочетание значений InputDialogOption.

См. также options, setOption() и testOption().

перечисление QInputDialog::InputMode

Это перечисление описывает различные режимы ввода, которые можно выбрать для диалогового окна.

Это перечисление было введено или изменено в Qt 4.5.

См. также inputMode.

Документация по функциям-членам

QInputDialog::QInputDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Создаёт новое диалоговое окно ввода с заданным parent и флагами окна flags.

Эта функция была добавлена в Qt 4.5.

[signal] void QInputDialog::doubleValueChanged(double value)

Этот сигнал испускается всякий раз, когда значение с плавающей точкой изменяется в диалоговом окне. Текущее значение указано параметром value.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме DoubleInput.

Примечание: Сигнал уведомления для свойства doubleValue.

[signal] void QInputDialog::doubleValueSelected(double value)

Этот сигнал испускается всякий раз, когда пользователь выбирает значение с плавающей точкой, подтверждая диалоговое окно; например, нажимая кнопку OK. Выбранное значение указано параметром value.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме DoubleInput.

[signal] void QInputDialog::intValueChanged(int value)

Этот сигнал испускается всякий раз, когда целочисленное значение изменяется в диалоговом окне. Текущее значение указано параметром value.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме IntInput.

Примечание: Сигнал уведомления для свойства intValue.

[signal] void QInputDialog::intValueSelected(int value)

Этот сигнал испускается всякий раз, когда пользователь выбирает целочисленное значение, подтверждая диалоговое окно; например, нажимая кнопку OK. Выбранное значение указано параметром value.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме IntInput.

[signal] void QInputDialog::textValueChanged(const QString &text)

Этот сигнал испускается всякий раз, когда строка текста изменяется в диалоговом окне. Текущая строка указана параметром text.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме TextInput.

Примечание: Сигнал уведомления для свойства textValue.

[signal] void QInputDialog::textValueSelected(const QString &text)

Этот сигнал испускается всякий раз, когда пользователь выбирает строку текста, подтверждая диалоговое окно; например, нажимая кнопку OK. Выбранная строка указана параметром text.

Этот сигнал актуален только при использовании диалогового окна ввода в режиме TextInput.

[virtual] QInputDialog::~QInputDialog()

Удаляет диалоговое окно ввода.

Эта функция была добавлена в Qt 4.5.

[override virtual] void QInputDialog::done(int result)

Переопределяет: QDialog::done(int r).

Закрывает диалоговое окно и устанавливает его код результата в result. Если это диалоговое окно показано с помощью exec(), done() вызывает завершение локального цикла событий и exec() возвращает result.

См. также QDialog::done().

[static] double QInputDialog::getDouble(QWidget *parent, const QString &title, const QString &label, double value = 0, double min = -2147483647, double max = 2147483647, int decimals = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Статическая вспомогательная функция для получения числа с плавающей точкой от пользователя.

title — текст, отображаемый в строке заголовка диалогового окна. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). value — значение с плавающей точкой по умолчанию, которое будет установлено в поле ввода. min и max — минимальное и максимальное значения, которые может выбрать пользователь. decimals — максимальное количество десятичных знаков.

Если ok не равен nullptr, *ok будет установлен в true, если пользователь нажал OK, и в false, если пользователь нажал Отмена. Родительское окно диалогового окна — parent. Диалоговое окно будет модальным и использовать флаги flags.

Функция возвращает число с плавающей точкой, введённое пользователем.

Используйте эту статическую функцию следующим образом:

    bool ok;
    double d = QInputDialog::getDouble(this, tr("QInputDialog::getDouble()"),
                                       tr("Amount:"), 37.56, -10000, 10000, 2, &ok);
    if (ok)
        doubleLabel->setText(QString("$%1").arg(d));

См. также getText(), getInt(), getItem() и getMultiLineText().

[static] double QInputDialog::getDouble(QWidget *parent, const QString &title, const QString &label, double value, double min, double max, int decimals, bool *ok, Qt::WindowFlags flags, double step)

Это перегруженная функция.

Статическая вспомогательная функция для получения числа с плавающей точкой от пользователя.

title — текст, отображаемый в строке заголовка диалогового окна. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). value — значение с плавающей точкой по умолчанию, которое будет установлено в поле ввода. min и max — минимальное и максимальное значения, которые может выбрать пользователь. decimals — максимальное количество десятичных знаков. step — величина изменения значений, когда пользователь нажимает стрелки для увеличения или уменьшения значения.

Если ok не равен nullptr, *ok будет установлен в true, если пользователь нажал OK, и в false, если пользователь нажал Отмена. Родительское окно диалогового окна — parent. Диалоговое окно будет модальным и использовать флаги flags.

Функция возвращает число с плавающей точкой, введённое пользователем.

Используйте эту статическую функцию следующим образом:

    bool ok;
    double d = QInputDialog::getDouble(this, tr("QInputDialog::getDouble()"),
                                       tr("Amount:"), 37.56, -10000, 10000, 2, &ok);
    if (ok)
        doubleLabel->setText(QString("$%1").arg(d));

См. также getText(), getInt(), getItem() и getMultiLineText().

[static] int QInputDialog::getInt(QWidget *parent, const QString &title, const QString &label, int value = 0, int min = -2147483647, int max = 2147483647, int step = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Статическая удобная функция для получения целого числа от пользователя.

title — текст, отображаемый в строке заголовка диалога. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). value — значение по умолчанию для поля ввода. min и max — минимальное и максимальное значения, которые может выбрать пользователь. step — значение, на которое изменяется значение при нажатии кнопок со стрелками для увеличения или уменьшения значения.

Если ok не равен нулю, то *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительский элемент диалога — parent. Диалог будет модальным и использовать флаги виджета flags.

При успешном выполнении функция возвращает целое число, введённое пользователем; при ошибке — исходное значение value.

Используйте эту статическую функцию следующим образом:

    bool ok;
    int i = QInputDialog::getInt(this, tr("QInputDialog::getInt()"),
                                 tr("Percentage:"), 25, 0, 100, 1, &ok);
    if (ok)
        integerLabel->setText(tr("%1%").arg(i));

Эта функция была введена в Qt 4.5.

См. также getText(), getDouble(), getItem() и getMultiLineText().

[static] QString QInputDialog::getItem(QWidget *parent, const QString &title, const QString &label, const QStringList &items, int current = 0, bool editable = true, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Статическая удобная функция, позволяющая пользователю выбрать элемент из списка строк.

title — текст, отображаемый в строке заголовка диалога. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). items — список строк, который вставляется в раскрывающийся список. current — номер элемента, который должен быть текущим. inputMethodHints — подсказки для метода ввода, которые будут использоваться, если раскрывающийся список редактируемый и активен метод ввода.

Если editable равно true, пользователь может ввести свой текст; в противном случае пользователь может выбрать только один из существующих элементов.

Если ok не равен нулю, то *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительский элемент диалога — parent. Диалог будет модальным и использовать флаги виджета flags.

Функция возвращает текст текущего элемента или, если editable равно true, текущий текст раскрывающегося списка.

Используйте эту статическую функцию следующим образом:

    QStringList items;
    items << tr("Spring") << tr("Summer") << tr("Fall") << tr("Winter");

    bool ok;
    QString item = QInputDialog::getItem(this, tr("QInputDialog::getItem()"),
                                         tr("Season:"), items, 0, false, &ok);
    if (ok && !item.isEmpty())
        itemLabel->setText(item);

См. также getText(), getInt(), getDouble() и getMultiLineText().

[static] QString QInputDialog::getMultiLineText(QWidget *parent, const QString &title, const QString &label, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Статическая удобная функция для получения многострочного текста от пользователя.

title — текст, отображаемый в строке заголовка диалога. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). text — текст по умолчанию, который размещается в поле редактирования. inputMethodHints — подсказки для метода ввода, которые будут использоваться в виджете редактирования, если активен метод ввода.

Если ok не равен нулю, то *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительский элемент диалога — parent. Диалог будет модальным и использовать указанные флаги виджета flags.

Если диалог принят, функция возвращает текст в поле редактирования диалога. Если диалог отклонен, возвращается пустой QString.

Используйте эту статическую функцию следующим образом:

    bool ok;
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street", &ok);
    if (ok && !text.isEmpty())
        multiLineTextLabel->setText(text);

Эта функция была введена в Qt 5.2.

См. также getInt(), getDouble(), getItem() и getText().

[static] QString QInputDialog::getText(QWidget *parent, const QString &title, const QString &label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Статическая удобная функция для получения строки от пользователя.

title — текст, отображаемый в строке заголовка диалога. label — текст, отображаемый пользователю (он должен указывать, что нужно ввести). text — текст по умолчанию, который размещается в поле редактирования. mode — режим отображения символов в поле редактирования. inputMethodHints — подсказки для метода ввода, которые будут использоваться в виджете редактирования, если активен метод ввода.

Если ok не равен нулю, то *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительский элемент диалога — parent. Диалог будет модальным и использовать указанные флаги виджета flags.

Если диалог принят, функция возвращает текст в поле редактирования диалога. Если диалог отклонен, возвращается пустой QString.

Используйте эту статическую функцию следующим образом:

    bool ok;
    QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                         tr("User name:"), QLineEdit::Normal,
                                         QDir::home().dirName(), &ok);
    if (ok && !text.isEmpty())
        textLabel->setText(text);

См. также getInt(), getDouble(), getItem() и getMultiLineText().

[override virtual] QSize QInputDialog::minimumSizeHint() const

Переопределяет: QDialog::minimumSizeHint() const.

void QInputDialog::open(QObject *receiver, const char *member)

Эта функция подключает один из своих сигналов к слоту, указанному receiver и member. Конкретный сигнал зависит от аргументов, указанных в member. Это:

• textValueSelected() если member содержит QString в качестве первого аргумента.
• intValueSelected() если member содержит целое число в качестве первого аргумента.
• doubleValueSelected() если member содержит двойное число в качестве первого аргумента.
• accepted() если member НЕ содержит аргументов.

Сигнал будет отключён от слота при закрытии диалога.

Эта функция была введена в Qt 4.5.

void QInputDialog::setDoubleRange(double min, double max)

Устанавливает диапазон чисел с двойной точностью, принимаемых диалогом, когда используется режим DoubleInput, с минимальным и максимальным значениями, указанными min и max соответственно.

void QInputDialog::setIntRange(int min, int max)

Устанавливает диапазон целых чисел, принимаемых диалогом, когда используется режим IntInput, с минимальным и максимальным значениями, указанными min и max соответственно.

void QInputDialog::setOption(QInputDialog::InputDialogOption option, bool on = true)

Устанавливает указанный параметр option в состояние включения, если on равно true; в противном случае очищает указанный параметр.

См. также options и testOption().

[override virtual] void QInputDialog::setVisible(bool visible)

Переопределяет: QDialog::setVisible(bool visible).

[override virtual] QSize QInputDialog::sizeHint() const

Переопределяет: QDialog::sizeHint() const.

bool QInputDialog::testOption(QInputDialog::InputDialogOption option) const

Возвращает true, если указанный параметр option включён; в противном случае возвращает false.

См. также параметры и setOption().