QWizard Class

멤버 함수 문서

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

주어진 parent 및 창 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::IndependentPages 옵션이 설정되지 않은 경우)를 클릭하여 페이지를 떠나기 직전에 id 페이지를 정리하기 위해 QWizard 에서 호출됩니다.

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

QWizardPage::cleanupPage() 및 initializePage()도 참조하세요 .

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

이 신호는 현재 페이지가 변경될 때 새로운 현재 id.

currentId() 및 currentPage()도 참조하세요 .

QWizardPage *QWizard::currentPage() const

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

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

page(), currentId() 및 restart()도 참조하세요 .

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

which 는 CustomButton1, CustomButton2 또는 CustomButton3 일 수 있습니다.

기본적으로 사용자 지정 버튼은 표시되지 않습니다. setOption ()에 HaveCustomButton1, HaveCustomButton2, 또는 HaveCustomButton3 을 호출하고 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 * 이벤트).

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::restart()가 호출되거나 사용자가 Next 을 클릭한 결과 id 페이지가 표시되기 직전에 QWizard 에서 호출하여 페이지를 준비합니다(단, QWizard::IndependentPages 옵션이 설정된 경우 이 함수는 페이지가 처음 표시될 때만 호출됩니다).

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

기본 구현은 페이지(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

이 가상 함수는 QWizard 에서 호출하여 사용자가 Next 버튼을 클릭할 때 표시할 페이지를 찾습니다.

반환 값은 다음 페이지의 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 * 이벤트).

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 버튼)을 추가하려면 CustomButton1 ~ CustomButton3 로 setButton()을 호출하고 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 버튼)을 추가하려면 CustomButton1, CustomButton2, 또는 CustomButton3 으로 setButtonText()를 호출하여 텍스트를 설정하고 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 이 참이면 지정된 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 표시).

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()를 호출합니다.

가능하면 유효성 검사 페이지()를 다시 구현하는 것보다 mandatory fields 또는 QWizardPage::isComplete()를 다시 구현하여 Next 또는 Finish 버튼을 비활성화하는 것이 일반적으로 더 나은 스타일입니다.

QWizardPage::validatePage() 및 currentPage()도 참조하세요 .

QList<int> QWizard::visitedIds() const

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

hasVisitedPage()도 참조하세요 .