QInputDialog Class

メンバー関数ドキュメント

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

与えられたparent とウィンドウflags で新しい入力ダイアログを構築します。

[virtual noexcept] QInputDialog::~QInputDialog()

入力ダイアログを破棄します。

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

再インプリメント：QDialog::done(int r)。

ダイアログを閉じ、その結果コードをresult に設定します。 このダイアログがexec() で表示されている場合、 done() によってローカルイベントループが終了し、exec() がresult を返します。

QDialog::done()も参照 。

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

このシグナルは、ダイアログ内でdoubleの値が変化するたびに発せられます。現在の値はvalue で指定されます。

このシグナルは、入力ダイアログがDoubleInput モードで使用されている場合にのみ関連します。

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

このシグナルは、例えばOK ボタンをクリックするなどして、ユーザがダイアログを受諾して二重値を選択するたびに発せられます。選択された値は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 = Qt::WindowFlags(), double step = 1)

ユーザから浮動小数点数を取得するための静的便宜関数。

title label はユーザーに表示されるテキストです（何を入力すべきかが書かれていなければなりません）。 は、行編集で設定されるデフォルトの浮動小数点数です。 と は、ユーザーが選択できる最小値と最大値です。 は、小数点以下の桁数の最大値です。 は、ユーザーが矢印ボタンを押して値をインクリメントまたはデクリメントするときに値が変化する量です。value min max decimals step

ok がnullでない場合、 *ok は、ユーザーがOK を押した場合はtrueに、Cancel を押した場合は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 は、ユーザーがOK を押した場合はtrueに、Cancel を押した場合は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の場合、ユーザは自分のテキストを入力することができます。そうでない場合、ユーザは既存の項目の中から1つだけ選択することができます。

ok が nonnull の場合、ユーザーがOK を押した場合は*ok がtrue に、Cancel を押した場合は 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 が nonnull の場合、ユーザーがOK を押した場合は*ok がtrue に、Cancel を押した場合は false に設定されます。ダイアログの親はparent です。ダイアログはモーダルになり、指定されたウィジェットflags を使用します。

ダイアログが受け入れられた場合、この関数はダイアログのプレーンテキスト編集のテキストを返します。ダイアログが拒否された場合、NULLQString が返されます。

この静的関数はこのように使用します：

    bool ok;
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street", &ok);
    if (ok && !text.isEmpty())
        multiLineTextLabel->setText(text);

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は、ユーザーがOK を押した場合はtrueに、Cancel を押した場合はfalseに設定される。ダイアログの親はparent です。ダイアログはモーダルで、指定されたウィジェットflags を使用します。

ダイアログが受け入れられた場合、この関数はダイアログの行編集のテキストを返します。ダイアログが拒否された場合、NULLQString が返されます。

この静的関数はこのように使用します：

    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 モードで使用されている場合にのみ関連します。

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

このシグナルは、ユーザーがダイアログで整数値を選択するたびに発行されます。例えば、OK ボタンをクリックします。選択された値はvalue で指定されます。

このシグナルは、入力ダイアログがIntInput モードで使用される場合にのみ関連します。

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

再実装：QDialog::minimumSizeHint() const.

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

この関数は、シグナルの1つをreceiver とmember で指定されたスロットに接続します。具体的なシグナルは、member で指定された引数に依存します。これらは以下の通りである：

• textValueSelected()member の第1引数がQString の場合。
• intValueSelected()member の第1引数が int の場合。
• doubleValueSelected()member の第1引数がdoubleの場合。
• 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)

on が真であれば、与えられたoption を有効に設定する。そうでなければ、与えられた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

与えられたoption が有効な場合はtrue を返し、そうでない場合は false を返します。

options およびsetOption()も参照してください 。

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

このシグナルは、ダイアログ内の文字列が変更されるたびに発行されます。現在の文字列はtext で指定されます。

このシグナルは、入力ダイアログがTextInput モードで使用されている場合にのみ関連します。

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

このシグナルは、例えばOK ボタンをクリックするなどして、ユーザーがダイアログを受諾して文字列を選択するたびに発せられます。選択された文字列はtext で指定されます。

このシグナルは、入力ダイアログがTextInput モードで使用される場合にのみ関連します。