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 によって呼び出される。

デフォルトの実装では、 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::restart() が呼び出された結果、またはユーザがNext をクリックした結果、id ページが表示される直前に、QWizard によって呼び出され、ページを準備します (ただし、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 ロールに設定されている pixmap を返します。

デフォルトでは、設定されている pixmap は 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 (またはそのサブクラスの 1 つ) のインスタンスが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)

指定されたid で、指定されたpage をウィザードに追加します。

addPage()、page()、pageAdded()も参照してください 。

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

ロールwhich の pixmap をpixmap に設定します。

pixmapは、ページを表示するときにQWizard 。どのpixmapが実際に使用されるかは、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()も参照 。