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 」ボタンをクリックするなどして）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 = 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(QStringLiteral("$%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 が null 以外の場合、ユーザーがOK を押すと*ok はtrue に、Cancel を押すと false に設定されます。ダイアログの親はparent です。ダイアログはモーダルであり、ウィジェットflags を使用します。

この関数は、現在の項目のテキストを返します。editable がtrueの場合は、コンボボックスの現在のテキストを返します。

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

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

ダイアログが承認された場合、この関数はダイアログのプレーンテキスト編集フィールドに入力されたテキストを返します。ダイアログが却下された場合は、nullのQString が返されます。

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

    bool ok{};
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street"_L1, &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 を使用します。

ダイアログが承認された場合、この関数はダイアログのラインエディット内のテキストを返します。ダイアログが却下された場合は、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 モードで使用されている場合にのみ関連します。

[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 の最初の引数がint型の場合、 が指定されている場合は()となります。QString
• intValueSelected member の最初の引数がintの場合、()となります。
• doubleValueSelected member の最初の引数が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 が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 」モードで使用されている場合にのみ関連します。