Класс QInputDialog

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

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

Публичные типы

Свойства

• 2 свойства унаследованы от QDialog
• 59 свойств унаследованы от QWidget
• 1 свойство унаследовано от QObject

Публичные функции

Реализованные общедоступные функции

• 8 общедоступных функций, унаследованных от QDialog
• 214 общедоступных функций, унаследованных от QWidget
• 31 общедоступных функций, унаследованных от QObject
• 14 общедоступных функций, унаследованных от QPaintDevice

Сигналы

• 3 сигнала, унаследованные от QDialog
• 3 сигнала, унаследованные от QWidget
• 2 сигнала, унаследованные от QObject

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

• 5 статических публичных членов, унаследованных от QWidget
• 9 статических публичных членов, унаследованных от QObject

Дополнительные унаследованные члены

• 5 публичных слотов, унаследованных от QDialog
• 19 публичных слотов, унаследованных от QWidget
• 1 публичный слот, унаследованный от QObject
• 6 защищённых функций, унаследованных от QDialog
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice
• 1 защищённый слот, унаследованный от QWidget

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

Класс 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, объединённых по OR.

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

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

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

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

См. также inputMode.

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

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

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

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

[virtual] QInputDialog::~QInputDialog()

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

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

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

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

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

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

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

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

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

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

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

Этот сигнал испускается всякий раз, когда пользователь выбирает значение типа double, приняв диалоговое окно (например, нажав кнопку ОК). Выбранное значение задаётся параметром value.

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

[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 = ...)

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

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

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

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

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

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

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

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

    bool ok;
    int i = QInputDialog::getInt(this, tr("QInputDialog::getInteger()"),
                                 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::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] QString QInputDialog::getMultiLineText(QWidget *parent, const QString &title, const QString &label, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = ..., 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::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().

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

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

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

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

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

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

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

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

Переопределено из QDialog::minimumSizeHint().

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().

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

Переопределено из QDialog::sizeHint().

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

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

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

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

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

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

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

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

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

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