QProgressDialog Class

    QProgressDialog progress("Copying files...", "Abort Copy", 0, numFiles, this);
    progress.setWindowModality(Qt::WindowModal);

    for (int i = 0; i < numFiles; i++) {
        progress.setValue(i);

        if (progress.wasCanceled())
            break;
        //... copy one file
    }
    progress.setValue(numFiles);

// Operation constructor
Operation::Operation(QObject *parent)
    : QObject(parent), steps(0)
{
    pd = new QProgressDialog("Operation in progress.", "Cancel", 0, 100);
    connect(pd, &QProgressDialog::canceled, this, &Operation::cancel);
    t = new QTimer(this);
    connect(t, &QTimer::timeout, this, &Operation::perform);
    t->start(0);
}

void Operation::perform()
{
    pd->setValue(steps);
    //... perform one percent of the operation
    steps++;
    if (steps > pd->maximum())
        t->stop();
}

void Operation::cancel()
{
    t->stop();
    //... cleanup
}

멤버 함수 문서

[explicit] QProgressDialog::QProgressDialog(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

진행률 대화 상자를 작성합니다.

기본 설정입니다:

• 레이블 텍스트가 비어 있습니다.
• 취소 버튼 텍스트는 (번역된) "취소"입니다.
• 최소값은 0입니다;
• 최대값은 100입니다.

parent 인수는 대화 상자의 부모 위젯입니다. 위젯 플래그인 f 는 QDialog::QDialog() 생성자에게 전달됩니다.

setLabelText(), setCancelButtonText(), setCancelButton(), setMinimum() 및 setMaximum()도 참조하세요 .

QProgressDialog::QProgressDialog(const QString &labelText, const QString &cancelButtonText, int minimum, int maximum, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

진행률 대화 상자를 작성합니다.

labelText 은 사용자에게 진행 상황을 알리는 데 사용되는 텍스트입니다.

cancelButtonText 은 취소 버튼에 표시할 텍스트입니다. QString()이 전달되면 취소 버튼이 표시되지 않습니다.

minimum 및 maximum 은 이 진행률 대화 상자에 진행률을 표시하는 작업의 단계 수입니다. 예를 들어 50개의 파일을 검사하는 작업의 경우 이 값의 최소값은 0이고 최대값은 50이 됩니다. 첫 번째 파일을 검사하기 전에 setValue(0)을 호출합니다. 각 파일이 처리될 때마다 setValue(1), setValue(2) 등을 호출하고 마지막 파일을 검사한 후 마지막으로 setValue(50)을 호출합니다.

parent 인수는 대화 상자의 부모 위젯입니다. 부모인 parent 와 위젯 플래그인 f 는 QDialog::QDialog() 생성자에게 전달됩니다.

setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), setMinimum() 및 setMaximum()도 참조하세요 .

[virtual noexcept] QProgressDialog::~QProgressDialog()

진행률 대화 상자를 삭제합니다.

[slot] void QProgressDialog::cancel()

진행률 대화 상자를 초기화합니다. wasCanceled()는 진행률 대화 상자가 재설정될 때까지 참이 됩니다. 진행률 대화 상자가 숨겨집니다.

[signal] void QProgressDialog::canceled()

이 신호는 취소 버튼을 클릭할 때 방출됩니다. 기본적으로 cancel() 슬롯에 연결됩니다.

wasCanceled()도 참조하세요 .

[override virtual protected] void QProgressDialog::changeEvent(QEvent *ev)

다시 구현합니다: QWidget::changeEvent(QEvent * 이벤트).

[override virtual protected] void QProgressDialog::closeEvent(QCloseEvent *e)

다시 구현합니다: QDialog::closeEvent(QCloseEvent *e).

[protected slot] void QProgressDialog::forceShow()

알고리즘이 시작되고 minimumDuration 밀리초가 지난 후에도 대화 상자가 여전히 숨겨져 있는 경우 대화 상자를 표시합니다.

setMinimumDuration()도 참조하세요 .

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

대화 상자를 열고 canceled() 신호를 receiver 및 member 에 지정된 슬롯에 연결합니다.

대화 상자가 닫히면 신호가 슬롯에서 연결이 끊어집니다.

[slot] void QProgressDialog::reset()

진행률 대화 상자를 초기화합니다. autoClose ()가 참이면 진행률 대화 상자가 숨겨집니다.

setAutoClose() 및 setAutoReset()도 참조하세요 .

[override virtual protected] void QProgressDialog::resizeEvent(QResizeEvent *event)

다시 구현합니다: QDialog::resizeEvent(QResizeEvent *).

void QProgressDialog::setBar(QProgressBar *bar)

진행률 표시줄 위젯을 bar 으로 설정합니다. 진행률 대화 상자의 크기가 그에 맞게 조정됩니다. 진행률 대화 상자는 필요한 경우 삭제되는 bar 진행률의 소유권을 가지므로 스택에 할당된 진행률 표시줄을 사용하지 마세요.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

취소 버튼을 푸시 버튼인 cancelButton 으로 설정합니다. 진행 대화 상자가 이 버튼의 소유권을 가지며 필요할 때 삭제되므로 스택에 있는 객체의 주소를 전달하지 말고 new()를 사용하여 버튼을 만드세요. nullptr 을 전달하면 취소 버튼이 표시되지 않습니다.

setCancelButtonText()도 참조하세요 .

[slot] void QProgressDialog::setCancelButtonText(const QString &cancelButtonText)

취소 버튼의 텍스트를 cancelButtonText 로 설정합니다. 텍스트가 QString()으로 설정되어 있으면 취소 버튼이 숨겨지고 삭제됩니다.

setCancelButton()도 참조하세요 .

void QProgressDialog::setLabel(QLabel *label)

레이블을 label 로 설정합니다. 진행률 대화 상자의 크기가 그에 맞게 조정됩니다. 레이블은 진행률 대화 상자의 소유가 되며 필요할 때 삭제되므로 스택에 있는 객체의 주소를 전달하지 마세요.

setLabelText()도 참조하세요 .

[slot] void QProgressDialog::setRange(int minimum, int maximum)

진행률 대화 상자의 최소값과 최대값을 각각 minimum 및 maximum 으로 설정합니다.

maximum 이 minimum 보다 작으면 minimum 이 유일한 법적 값이 됩니다.

현재 값이 새 범위를 벗어나면 진행률 대화 상자가 reset()로 재설정됩니다.

minimum 및 maximum 을참조하세요 .

[override virtual protected] void QProgressDialog::showEvent(QShowEvent *e)

다시 구현합니다: QDialog::showEvent(QShowEvent * 이벤트).

[override virtual] QSize QProgressDialog::sizeHint() const

재구현합니다: QDialog::sizeHint() const.

진행률 대화 상자의 내용에 맞는 크기를 반환합니다. 진행률 대화 상자는 필요에 따라 자체적으로 크기를 조정하므로 직접 호출할 필요가 없습니다.