QWizard Class

멤버 함수 문서

[explicit] QWizard::QWizard(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

지정된 parent 및 window flags 를 사용하여 마법사를 생성합니다.

parent() 및 windowFlags()도 참조하십시오 .

[virtual noexcept] QWizard::~QWizard()

마법사와 그 페이지들을 삭제하고, 할당된 리소스를 모두 해제합니다.

int QWizard::addPage(QWizardPage *page)

지정된 ‘ page ’를 마법사에 추가하고, 해당 페이지의 ID를 반환합니다.

이 ID는 지금까지 QWizard 에 있는 다른 어떤 ID보다 반드시 더 큰 값이 됩니다.

setPage(), page(), pageAdded()도 참조하십시오 .

[slot] void QWizard::back()

이전 페이지로 돌아갑니다.

이는 ' Back ' 버튼을 누르는 것과 동일합니다.

next(), accept(), reject(), restart()도 참조하십시오 .

QAbstractButton *QWizard::button(QWizard::WizardButton which) const

which 역할에 해당하는 버튼을 반환합니다.

setButton() 및 setButtonText()도 참조하십시오 .

QString QWizard::buttonText(QWizard::WizardButton which) const

which 버튼에 표시된 텍스트를 반환합니다.

setButtonText()를 사용하여 텍스트가 설정된 경우, 이 텍스트가 반환됩니다.

기본적으로 버튼의 텍스트는 wizardStyle 에 따라 달라집니다. 예를 들어, macOS에서는 Next 버튼이 Continue 로 표시됩니다.

button(), setButton(), setButtonText(), QWizardPage::buttonText() 및 QWizardPage::setButtonText()도 참조하십시오 .

[virtual protected] void QWizard::cleanupPage(int id)

이 가상 함수는 사용자가 Back 을 클릭하여 페이지를 떠나기 직전에 QWizard 이 페이지 id 을 정리하기 위해 호출합니다( QWizard::IndependentPages 옵션이 설정되어 있지 않은 경우).

기본 구현은 page(id)에서 QWizardPage::cleanupPage()를 호출합니다.

QWizardPage::cleanupPage() 및 initializePage()도 참조하십시오 .

[signal] void QWizard::currentIdChanged(int id)

이 신호는 현재 페이지가 변경될 때, 새로운 현재 페이지 id 와 함께 발생합니다.

currentId() 및 currentPage()도 참조하십시오 .

QWizardPage *QWizard::currentPage() const

현재 페이지에 대한 포인터를 반환하거나, 현재 페이지가 없는 경우(예: 마법사가 표시되기 전) nullptr 을 반환합니다.

이는 page(currentId())를 호출하는 것과 동일합니다.

page(), currentId(), restart()도 참조하십시오 .

[signal] void QWizard::customButtonClicked(int which)

이 신호는 사용자가 사용자 정의 버튼을 클릭할 때 발생합니다. ` which `은 ` CustomButton1`, ` CustomButton2` 또는 ` CustomButton3`일 수 있습니다.

기본적으로 사용자 정의 버튼은 표시되지 않습니다. 사용자 정의 버튼을 표시하려면 HaveCustomButton1, HaveCustomButton2 또는 HaveCustomButton3 을 인수로 전달하여 setOption()을 호출하고, setButtonText() 또는 setButton()을 사용하여 해당 버튼을 구성하십시오.

helpRequested()도 참조하십시오 .

[override virtual protected] void QWizard::done(int result)

QDialog::done(int r)을 재구현합니다.

[override virtual protected] bool QWizard::event(QEvent *event)

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

QVariant QWizard::field(const QString &name) const

name 라는 필드의 값을 반환합니다.

이 함수는 마법사의 모든 페이지에서 필드에 접근하는 데 사용할 수 있습니다.

QWizardPage::registerField(), QWizardPage::field() 및 setField()도 참조하십시오 .

bool QWizard::hasVisitedPage(int id) const

페이지 기록에 id 페이지가 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

Back 를 누르면 현재 페이지가 다시 "미방문" 상태로 표시됩니다.

visitedIds()도 참조하십시오 .

[signal] void QWizard::helpRequested()

이 신호는 사용자가 ‘ Help ’ 버튼을 클릭할 때 전송됩니다.

기본적으로 ‘ Help ’ 버튼은 표시되지 않습니다. 이 버튼을 표시하려면 setOption(HaveHelpButton, true)를 호출하십시오.

예시:

LicenseWizard::LicenseWizard(QWidget *parent)
    : QWizard(parent)
{
    ...
    setOption(HaveHelpButton, true);
    connect(this, &QWizard::helpRequested, this, &LicenseWizard::showHelp);
    ...
}

void LicenseWizard::showHelp()
{
    static QString lastHelpMessage;

    QString message;

    switch (currentId()) {
    case Page_Intro:
        message = tr("The decision you make here will affect which page you "
                     "get to see next.");
        break;
    ...
    default:
        message = tr("This help is likely not to be of any help.");
    }

    QMessageBox::information(this, tr("License Wizard Help"), message);

}

customButtonClicked()도 참조하십시오 .

[virtual protected] void QWizard::initializePage(int id)

이 가상 함수는 ` QWizard `에 의해 호출되며, ` QWizard::restart()`가 호출되거나 사용자가 ` Next`를 클릭하여 페이지가 표시되기 직전에 ` id ` 페이지를 준비합니다. (단, ` QWizard::IndependentPages ` 옵션이 설정된 경우, 이 함수는 페이지가 처음 표시될 때만 호출됩니다.)

이 함수를 재구현하면 이전 페이지의 필드를 기반으로 해당 페이지의 필드가 올바르게 초기화되도록 할 수 있습니다.

기본 구현에서는 page(id)에서 QWizardPage::initializePage()을 호출합니다.

QWizardPage::initializePage() 및 cleanupPage()도 참조하십시오 .

[override virtual protected] bool QWizard::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

QWidget::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)를 재구현합니다.

[slot] void QWizard::next()

다음 페이지로 넘어갑니다.

이는 Next 또는 Commit 버튼을 누르는 것과 동일합니다.

nextId(), back(), accept(), reject(), restart()도 참조하십시오 .

[virtual] int QWizard::nextId() const

이 가상 함수는 사용자가 ‘ Next ’ 버튼을 클릭했을 때 표시할 페이지를 확인하기 위해 ` QWizard `에 의해 호출됩니다.

반환 값은 다음 페이지의 ID이며, 다음 페이지가 없는 경우에는 -1을 반환합니다.

기본 구현은 currentPage()에서 QWizardPage::nextId()를 호출합니다.

이 함수를 재구현하면 동적인 페이지 순서를 지정할 수 있습니다.

QWizardPage::nextId() 및 currentPage()도 참조하십시오 .

QWizardPage *QWizard::page(int id) const

지정된 id 에 해당하는 페이지를 반환하며, 해당 페이지가 없는 경우 nullptr 를 반환합니다.

addPage() 및 setPage()도 참조하십시오 .

[signal] void QWizard::pageAdded(int id)

이 신호는 마법사에 페이지가 추가될 때마다 발생합니다. 해당 페이지의 id 가 매개변수로 전달됩니다.

addPage(), setPage(), startId()도 참조하십시오 .

QList<int> QWizard::pageIds() const

페이지 ID 목록을 반환합니다.

[signal] void QWizard::pageRemoved(int id)

이 신호는 마법사에서 페이지가 제거될 때마다 발생합니다. 해당 페이지의 id 가 매개변수로 전달됩니다.

removePage() 및 startId()도 참조하십시오 .

[override virtual protected] void QWizard::paintEvent(QPaintEvent *event)

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

QPixmap QWizard::pixmap(QWizard::WizardPixmap which) const

which 역할에 설정된 픽스맵을 반환합니다.

기본적으로 macOS에서는 BackgroundPixmap 만 설정되어 있습니다.

setPixmap(), QWizardPage::pixmap() 및 Elements of a Wizard Page도 참조하십시오 .

void QWizard::removePage(int id)

지정된 ` id` 값을 가진 페이지를 제거합니다. 필요한 경우 ` cleanupPage()`가 호출됩니다.

addPage(), setPage(), pageRemoved(), startId()도 참조하십시오 .

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

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

[slot] void QWizard::restart()

마법사를 시작 페이지에서 다시 시작합니다. 이 함수는 마법사가 표시될 때 자동으로 호출됩니다.

startId()도 참조하십시오 .

void QWizard::setButton(QWizard::WizardButton which, QAbstractButton *button)

which 역할에 해당하는 버튼을 button 로 설정합니다.

마법사에 추가 버튼(예: Print 버튼)을 추가하려면, setButton()을 호출하여 CustomButton1 를 CustomButton3 로 설정하고, HaveCustomButton1 를 HaveCustomButton3 옵션으로 지정하여 버튼을 표시하는 방법이 있습니다.

button(), setButtonText(), setButtonLayout() 및 options도 참조하십시오 .

void QWizard::setButtonLayout(const QList<QWizard::WizardButton> &layout)

버튼이 표시되는 순서를 ` layout`으로 설정합니다. 여기서 ` layout `은 ` WizardButton` 객체들의 목록입니다.

기본 레이아웃은 설정된 옵션(예: HelpButtonOnRight)에 따라 달라집니다. options 가 제공하는 것보다 버튼 레이아웃에 대한 더 세밀한 제어가 필요한 경우 이 함수를 호출할 수 있습니다.

Stretch 을 사용하여 레이아웃에서 가로 확장 비율을 지정할 수 있습니다.

예:

MyWizard::MyWizard(QWidget *parent)
    : QWizard(parent)
{
    //...
    QList<QWizard::WizardButton> layout;
    layout << QWizard::Stretch << QWizard::BackButton << QWizard::CancelButton
           << QWizard::NextButton << QWizard::FinishButton;
    setButtonLayout(layout);
    //...
}

setButton(), setButtonText(), setOptions()도 참조하십시오 .

void QWizard::setButtonText(QWizard::WizardButton which, const QString &text)

which 버튼의 텍스트를 text 로 설정합니다.

기본적으로 버튼의 텍스트는 wizardStyle 에 따라 달라집니다. 예를 들어, macOS에서는 Next 버튼이 Continue 로 표시됩니다.

마법사에 추가 버튼(예: Print 버튼)을 추가하는 한 가지 방법은 setButtonText()를 호출하여 CustomButton1, CustomButton2 또는 CustomButton3 로 텍스트를 설정하고, HaveCustomButton1, HaveCustomButton2 및/또는 HaveCustomButton3 옵션을 사용하여 버튼을 표시하는 것입니다.

QWizardPage::setButtonText()를 사용하여 페이지별로 버튼 텍스트를 설정할 수도 있습니다.

buttonText(), setButton(), button(), setButtonLayout(), setOptions(), QWizardPage::setButtonText()도 참조하십시오 .

[slot] void QWizard::setCurrentId(int id)

currentId 과 id 사이의 페이지를 방문하지 않고, currentId 을 id 으로 설정합니다.

다음과 같은 경우 페이지 변경 없이 반환됩니다.

• 마법사에 페이지가 없는 경우
• 현재 페이지가 유효하지 않은 경우
• 지정된 페이지가 currentId()과 동일한 경우
• 지정된 페이지가 범위 밖인 경우

참고: 페이지를 앞으로 건너뛰어 id 가 0인 경우, 페이지 방문 기록이 삭제됩니다.

currentId()도 참조하십시오 .

void QWizard::setDefaultProperty(const char *className, const char *property, const char *changedSignal)

className 의 기본 속성을 property 로, 관련 변경 신호를 changedSignal 로 설정합니다.

기본 속성은 className (또는 그 하위 클래스 중 하나)의 인스턴스가 QWizardPage::registerField()에 전달되었을 때, 속성이 지정되지 않은 경우에 사용됩니다.

QWizard 는 가장 일반적인 Qt 위젯을 인식합니다. 이러한 위젯(또는 그 하위 클래스)의 경우, property 나 changedSignal 을 명시적으로 지정할 필요가 없습니다. 아래 표에는 이러한 위젯들이 나열되어 있습니다:

QWizardPage::registerField()도 참조하십시오 .

void QWizard::setField(const QString &name, const QVariant &value)

name 라는 필드의 값을 value 로 설정합니다.

이 함수는 마법사의 모든 페이지에서 필드를 설정하는 데 사용할 수 있습니다.

QWizardPage::registerField(), QWizardPage::setField() 및 field()도 참조하십시오 .

void QWizard::setOption(QWizard::WizardOption option, bool on = true)

on 가 true인 경우, 지정된 option 를 활성화하고, 그렇지 않은 경우 지정된 option 를 해제합니다.

options, testOption(), setWizardStyle()도 참조하십시오 .

void QWizard::setPage(int id, QWizardPage *page)

지정된 page 를 지정된 id 를 가진 마법사에 추가합니다.

addPage(), page(), pageAdded()도 참조하십시오 .

void QWizard::setPixmap(QWizard::WizardPixmap which, const QPixmap &pixmap)

which 역할에 대한 픽스맵을 pixmap 로 설정합니다.

QWizard 는 페이지를 표시할 때 픽스맵을 사용합니다. 실제로 어떤 픽스맵이 사용되는지는 wizard style 에 따라 다릅니다.

QWizardPage::setPixmap()를 사용하여 특정 페이지에 대한 픽스맵을 설정할 수도 있습니다.

pixmap(), QWizardPage::setPixmap(), Elements of a Wizard Page도 참조하십시오 .

void QWizard::setSideWidget(QWidget *widget)

지정된 ‘ widget ’을 마법사의 왼쪽에 표시하도록 설정합니다. ‘ WatermarkPixmap ’(ClassicStyle 및 ModernStyle)를 사용하는 스타일의 경우, 사이드 위젯은 워터마크 위에 표시되며, 다른 스타일이나 워터마크가 지정되지 않은 경우에는 사이드 위젯이 마법사의 왼쪽에 표시됩니다.

nullptr 를 전달하면 측면 위젯이 표시되지 않습니다.

widget 가 nullptr 가 아닐 경우, 마법사는 사이드 위젯의 부모 요소를 재설정합니다.

기존의 사이드 위젯은 모두 숨겨집니다.

다른 시점에 동일한 위젯으로 setSideWidget()을 호출할 수 있습니다.

여기에서 설정된 모든 위젯은 다른 사이드 위젯(또는 nullptr)을 설정한 후 별도로 부모를 재설정하지 않는 한, 마법사가 소멸될 때 삭제됩니다.

기본적으로 사이드 위젯은 존재하지 않습니다.

sideWidget()도 참조하십시오 .

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

QDialog::setVisible(bool visible)을 재구현합니다.

QWidget *QWizard::sideWidget() const

마법사의 왼쪽에 있는 위젯 또는 nullptr 을 반환합니다.

기본적으로 측면 위젯은 없습니다.

setSideWidget()도 참조하십시오 .

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

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

bool QWizard::testOption(QWizard::WizardOption option) const

지정된 option 가 활성화되어 있으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

options, setOption() 및 setWizardStyle()도 참조하십시오 .

[virtual] bool QWizard::validateCurrentPage()

이 가상 함수는 사용자가 Next 또는 Finish 을 클릭하여 마지막 순간에 유효성 검사를 수행할 때 QWizard 에 의해 호출됩니다. 이 함수가 true 을 반환하면 다음 페이지가 표시되거나(또는 마법사가 종료됩니다); 그렇지 않으면 현재 페이지가 그대로 유지됩니다.

기본 구현에서는 currentPage()에서 QWizardPage::validatePage()를 호출합니다.

가능한 경우, `validateCurrentPage()`를 재구현하는 것보다 ` Next ` 또는 ` Finish ` 버튼을 비활성화하는 것(` mandatory fields `을 지정하거나 ` QWizardPage::isComplete()`를 재구현하여)이 일반적으로 더 바람직한 방식입니다.

QWizardPage::validatePage() 및 currentPage()도 참조하십시오 .

QList<int> QWizard::visitedIds() const

방문한 페이지의 ID 목록을, 페이지를 방문한 순서대로 반환합니다.

hasVisitedPage()도 참조하십시오 .