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(0), setValue(2) 등을 호출하고, 마지막 파일을 검사한 후에는 setValue(50)을 호출합니다.

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

setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), setMinimum() 및 setMaximum()도 참조하십시오 .

[virtual noexcept] QProgressDialog::~QProgressDialog()

진행 상황 대화 상자를 닫습니다.

[slot] void QProgressDialog::cancel()

진행 상황 대화 상자를 초기화합니다. 진행 상황 대화 상자가 초기화될 때까지 ` wasCanceled()`의 반환 값이 `true`가 됩니다. 진행 상황 대화 상자가 숨겨집니다.

[signal] void QProgressDialog::canceled()

이 신호는 취소 버튼을 클릭했을 때 발생합니다. 기본적으로 cancel() 슬롯에 연결되어 있습니다.

wasCanceled()항목도 참조하십시오 .

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

QWidget::changeEvent(QEvent *event)를 재구현합니다.

[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()의 값이 true인 경우 진행 상황 대화 상자가 숨겨집니다.

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 *event)을 재구현합니다.

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

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

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