Класс 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

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

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

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

перечисление 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())

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

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

Если ok не равен null, *ok будет установлен в true, если пользователь нажал OK, и в 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));

См. также 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, если пользователь нажал OK, и в 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, если пользователь нажал OK, и в 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, если пользователь нажал OK, и в 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 содержит число с плавающей точкой в качестве первого аргумента.
• 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().