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 が nonnull の場合、ユーザが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)

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

• textValueSelected member の第1引数が の場合、() 。QString
• intValueSelected()member の第1引数が int の場合。
• doubleValueSelected()member の第1引数がdoubleの場合。
• accepted()member に引数がない場合。

ダイアログが閉じられると、シグナルはスロットから切断されます。

void QInputDialog::setDoubleRange(double min, double max)

min とmax でそれぞれ最小値と最大値を指定し、DoubleInput モードで使用する場合にダイアログが受け付ける倍精度浮動小数点値の範囲を設定します。

void QInputDialog::setIntRange(int min, int max)

IntInput モードで使用するときにダイアログが受け付ける整数値の範囲を設定します。最小値と最大値はそれぞれmin とmax で指定します。

void QInputDialog::setOption(QInputDialog::InputDialogOption option, bool on = true)

on が true の場合、与えられた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 モードで使用される場合にのみ関連します。