Класс QInputDialog

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

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

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

Свойства

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

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

Переопределённые открытые функции

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

Сигналы

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

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

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

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

• 5 общедоступных слотов унаследовано от QDialog
• 19 общедоступных слотов унаследовано от QWidget
• 1 общедоступный слот унаследовано от QObject
• 7 защищённых функций унаследовано от 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, если пользователь нажимает кнопку OK; в противном случае, она устанавливается в значение 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 = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())

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

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

QInputDialog::~QInputDialog()

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

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

[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 = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())

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

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] 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 = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())

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

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 = Q_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 = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

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

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

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

Если диалог принят, эта функция возвращает текст из текстового поля диалога. Если диалог отклонен, возвращается пустой 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 = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

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

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

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

Если диалог принят, эта функция возвращает текст из поля редактирования диалога. Если диалог отклонен, возвращается пустой 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.

[virtual] QSize QInputDialog::minimumSizeHint() const

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

void QInputDialog::open(QObject *receiver, const char *member)

Это перегруженная функция.

Эта функция подключает один из своих сигналов к слоту, указанному в receiver и member. Конкретный сигнал зависит от аргументов, указанных в member. Это:

• textValueSelected() если member имеет QString в качестве первого аргумента.
• intValueSelected() если member имеет int в качестве первого аргумента.
• 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(InputDialogOption option, bool on = true)

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

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

[virtual] void QInputDialog::setVisible(bool visible)

Переопределено из QWidget::setVisible().

[virtual] QSize QInputDialog::sizeHint() const

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

bool QInputDialog::testOption(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.