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)

이 신호는 대화 상자에서 이중 값이 변경될 때마다 발생합니다. 현재 값은 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 을 누르면 참으로 설정되고 Cancel 을 누르면 거짓으로 설정됩니다. 대화 상자의 부모는 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 가 널이 아닌 경우 *ok 은 사용자가 OK 을 누르면 참으로 설정되고 Cancel 을 누르면 거짓으로 설정됩니다. 대화 상자의 부모는 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 이 참이면 사용자가 직접 텍스트를 입력할 수 있으며, 그렇지 않으면 기존 항목 중 하나만 선택할 수 있습니다.

ok 가 null이 아닌 경우 *ok는 사용자가 OK 을 누르면 참으로 설정되고 Cancel 을 누르면 거짓으로 설정됩니다. 대화 상자의 부모는 parent 입니다. 대화 상자는 모달이며 위젯 flags 을 사용합니다.

이 함수는 현재 항목의 텍스트를 반환하거나 editable 이 참이면 콤보 상자의 현재 텍스트를 반환합니다.

이 정적 함수는 다음과 같이 사용합니다:

    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 가 null이 아닌 경우 *ok는 사용자가 OK 을 누르면 참으로 설정되고 Cancel 을 누르면 거짓으로 설정됩니다. 대화 상자의 부모는 parent 입니다. 대화 상자는 모달이며 지정된 위젯 flags 을 사용합니다.

대화 상자가 수락되면 이 함수는 대화 상자의 일반 텍스트 편집 텍스트를 반환합니다. 대화 상자가 거부되면 null 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);

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 을 누르면 참으로 설정되고 Cancel 을 누르면 거짓으로 설정됩니다. 대화 상자의 부모는 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 이 참이면 지정된 option 을 활성화하도록 설정하고, 그렇지 않으면 지정된 option 을 지웁니다.

options 및 testOption()도 참조하세요 .

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

다시 구현합니다: QDialog::setVisible(bool 표시).

[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 모드에서 사용되는 경우에만 관련이 있습니다.