Класс 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 и Пример стандартных диалогов.

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

enum QInputDialog::InputDialogOptionflags QInputDialog::InputDialogOptions

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

Тип InputDialogOptions является псевдонимом для QFlags<InputDialogOption>. Он хранит комбинацию значений InputDialogOption, объединённых оператором OR.

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

enum QInputDialog::InputMode

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

См. также inputMode.

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

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

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

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

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

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

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

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

Этот сигнал испускается всякий раз, когда пользователь выбирает значение типа double, подтверждая диалог; например, нажав кнопку 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()

Уничтожает диалог ввода.

[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(), double step = 1)

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

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

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

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

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

    bool ok;
    double d = QInputDialog::getDouble(this, tr("QInputDialog::getDouble()"),
                                       tr("Amount:"), 37.56, -10000, 10000, 2, &ok,
                                       Qt::WindowFlags(), 1);
    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())

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

…

См. также 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 не равен null, *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, since 5.2] 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 не равен null, *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительским элементом диалогового окна является parent. Диалоговое окно будет модальным и использует указанные флаги виджета flags.

Если диалоговое окно принято, эта функция возвращает текст из поля редактирования простого текста диалогового окна. Если диалоговое окно отклонено, возвращается null 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 не равен null, *ok будет установлен в true, если пользователь нажал ОК, и в false, если пользователь нажал Отмена. Родительским элементом диалогового окна является parent. Диалоговое окно будет модальным и использует указанные флаги виджета flags.

Если диалоговое окно принято, эта функция возвращает текст из поля редактирования строки диалогового окна. Если диалоговое окно отклонено, возвращается null 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 имеет double в качестве первого аргумента.
• accepted() если member не имеет аргументов.

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

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; в противном случае очищает заданный option.

См. также 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.

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