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

Этот сигнал генерируется при изменении значения 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()

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

Эта функция была добавлена в 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(), 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));

Эта функция была добавлена в 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 не равен 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] 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 содержит вещественное число в качестве первого аргумента.
• 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.

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