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(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 는 스핀박스(spinbox)의 기본값으로 설정될 정수입니다. 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인 경우 사용자는 직접 텍스트를 입력할 수 있으며, 그렇지 않은 경우 사용자는 기존 항목 중 하나만 선택할 수 있습니다.

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)

이 함수는 자신의 신호 중 하나를 receiver 및 member 로 지정된 슬롯에 연결합니다. 구체적인 신호는 member 에 지정된 인자에 따라 달라집니다. 인자는 다음과 같습니다:

• textValueSelected member 의 첫 번째 인수가 인 경우 ()입니다. 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 ' 모드로 사용될 때만 관련이 있습니다.