Класс QInputDialog

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

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

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

Свойства

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

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

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

• 8 public функций унаследовано от QDialog
• 214 public функций унаследовано от QWidget
• 34 public функций унаследовано от QObject
• 14 public функций унаследовано от QPaintDevice

Сигналы

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

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

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

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

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

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

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

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

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

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

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

enum 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, *a 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, *a 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, *a 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 имеет double в качестве первого аргумента.
• 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; в противном случае, отключает заданный option.

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