QWizard Class Reference · PyQt4 中文文檔

# QWizard Class Reference ## [[QtGui](index.htm) module] 該QWizard類提供了一個向導框架。[More...](#details) 繼承[QDialog](qdialog.html)。 ### Types * `enum WizardButton { BackButton, NextButton, CommitButton, FinishButton, ..., Stretch }` * `enum WizardOption { IndependentPages, IgnoreSubTitles, ExtendedWatermarkPixmap, NoDefaultButton, ..., HaveCustomButton3 }` * `class **[WizardOptions](index.htm)**` * `enum WizardPixmap { WatermarkPixmap, LogoPixmap, BannerPixmap, BackgroundPixmap }` * `enum WizardStyle { ClassicStyle, ModernStyle, MacStyle, AeroStyle }` ### Methods * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `int addPage (self, QWizardPage?page)` * `back (self)` * `QAbstractButton button (self, WizardButton?which)` * `QString buttonText (self, WizardButton?which)` * `cleanupPage (self, int?id)` * `int currentId (self)` * `QWizardPage currentPage (self)` * `done (self, int?result)` * `bool event (self, QEvent?event)` * `QVariant field (self, QString?name)` * `bool hasVisitedPage (self, int?id)` * `initializePage (self, int?id)` * `next (self)` * `int nextId (self)` * `WizardOptions options (self)` * `QWizardPage page (self, int?id)` * `list-of-int pageIds (self)` * `paintEvent (self, QPaintEvent?event)` * `QPixmap pixmap (self, WizardPixmap?which)` * `removePage (self, int?id)` * `resizeEvent (self, QResizeEvent?event)` * `restart (self)` * `setButton (self, WizardButton?which, QAbstractButton?button)` * `setButtonLayout (self, list-of-QWizard.WizardButton?layout)` * `setButtonText (self, WizardButton?which, QString?text)` * `setDefaultProperty (self, str?className, str?property, str?changedSignal)` * `setField (self, QString?name, QVariant?value)` * `setOption (self, WizardOption?option, bool?on?=?True)` * `setOptions (self, WizardOptions?options)` * `setPage (self, int?id, QWizardPage?page)` * `setPixmap (self, WizardPixmap?which, QPixmap?pixmap)` * `setSideWidget (self, QWidget?widget)` * `setStartId (self, int?id)` * `setSubTitleFormat (self, Qt.TextFormat?format)` * `setTitleFormat (self, Qt.TextFormat?format)` * `setVisible (self, bool?visible)` * `setWizardStyle (self, WizardStyle?style)` * `QWidget sideWidget (self)` * `QSize sizeHint (self)` * `int startId (self)` * `Qt.TextFormat subTitleFormat (self)` * `bool testOption (self, WizardOption?option)` * `Qt.TextFormat titleFormat (self)` * `bool validateCurrentPage (self)` * `list-of-int visitedPages (self)` * `WizardStyle wizardStyle (self)` ### Qt Signals * `void currentIdChanged (int)` * `void customButtonClicked (int)` * `void helpRequested ()` * `void pageAdded (int)` * `void pageRemoved (int)` * * * ## Detailed Description 該QWizard類提供了一個向導框架。一個向導（也稱為Mac OS X上的助手）是一種特殊類型的輸入對話框，它包含的頁面順序。一個向導的目的是通過一步一個工藝步驟引導用戶。奇才是復雜或罕見的任務，用戶可能會發現很難學到有用的。 QWizard繼承[QDialog](qdialog.html)并表示一個向導。每個頁面都是一個[QWizardPage](qwizardpage.html)（一[QWidget](qwidget.html)子類）。要創建自己的向導，你可以直接使用這些類，或者你可以繼承他們進行更多的控制。主題： ### A Trivial Example 下面的例子演示了如何創建向導頁面，并將其添加到向導。對于更高級的示例，請參見[Class Wizard](index.htm)和[License Wizard](index.htm)。 ``` [QWizardPage](qwizardpage.html) *createIntroPage() { [QWizardPage](qwizardpage.html) *page = new [QWizardPage](qwizardpage.html); page->setTitle("Introduction"); [QLabel](qlabel.html) *label = new [QLabel](qlabel.html)("This wizard will help you register your copy " "of Super Product Two."); label->setWordWrap(true); [QVBoxLayout](qvboxlayout.html) *layout = new [QVBoxLayout](qvboxlayout.html); layout->addWidget(label); page->setLayout(layout); return page; } [QWizardPage](qwizardpage.html) *createRegistrationPage() { ... } [QWizardPage](qwizardpage.html) *createConclusionPage() { ... } int main(int argc, char *argv[]) { [QApplication](qapplication.html) app(argc, argv); [QString](qstring.html) translatorFileName = QLatin1String("qt_"); translatorFileName += [QLocale](qlocale.html).system().name(); [QTranslator](qtranslator.html) *translator = new [QTranslator](qtranslator.html)(&app); if (translator->load(translatorFileName, [QLibraryInfo](qlibraryinfo.html).location([QLibraryInfo](qlibraryinfo.html).TranslationsPath))) app.installTranslator(translator); QWizard wizard; wizard.addPage(createIntroPage()); wizard.addPage(createRegistrationPage()); wizard.addPage(createConclusionPage()); wizard.setWindowTitle("Trivial Wizard"); #ifdef Q_OS_SYMBIAN wizard.showMaximized(); #else wizard.show(); #endif return app.exec(); } ``` ### Wizard Look and Feel QWizard支持四個精靈的樣子： * [ClassicStyle](qwizard.html#WizardStyle-enum) * [ModernStyle](qwizard.html#WizardStyle-enum) * [MacStyle](qwizard.html#WizardStyle-enum) * [AeroStyle](qwizard.html#WizardStyle-enum) 你可以明確地設置一下使用使用[setWizardStyle](qwizard.html#wizardStyle-prop)（）（例如，如果你想同樣的外觀在所有平臺）。 | [ClassicStyle](qwizard.html#WizardStyle-enum) | [ModernStyle](qwizard.html#WizardStyle-enum) | [MacStyle](qwizard.html#WizardStyle-enum) | [AeroStyle](qwizard.html#WizardStyle-enum) | | --- | --- | --- | --- | | ![](https://img.kancloud.cn/c8/85/c88504153342d605560a2656510c9625_254x220.png) | ![](https://img.kancloud.cn/1e/ca/1ecabff647d29eb798a697455d640035_259x220.png) | ![](https://img.kancloud.cn/5d/04/5d0450b84da4762f19336148bc80eac6_307x220.png) | ![](https://img.kancloud.cn/91/55/915524979749748d7a504a1e7256a215_251x220.png) | | ![](https://img.kancloud.cn/df/50/df50c7c51e012f6762db1c78e7736a0c_254x220.png) | ![](https://img.kancloud.cn/b5/20/b520f3e7a3a7ebf0026ba9f5fb84353e_259x220.png) | ![](https://img.kancloud.cn/a1/e4/a1e4d1c4deafda224a49b52d15bd2c39_307x220.png) | ![](https://img.kancloud.cn/33/8a/338ad7c78250d72ef58cc8add3a0a83c_251x220.png) | 注意：[AeroStyle](qwizard.html#WizardStyle-enum)只有在Windows Vista系統上的alpha合成啟用效果。[ModernStyle](qwizard.html#WizardStyle-enum)作為當不滿足這個條件的后備。除了精靈的風格，也有控制精靈的外觀和感覺的幾個選項。這些可以使用設置[setOption](qwizard.html#setOption)（）或[setOptions](qwizard.html#options-prop)（）。例如，[HaveHelpButton](qwizard.html#WizardOption-enum)讓QWizard秀一**Help**連同其他向導按鈕按鈕。使用的向導按鈕的順序，你甚至可以更改為任意順序[setButtonLayout](qwizard.html#setButtonLayout)（），您最多可以添加三個自定義按鈕（例如，**Print**按鈕）按鈕行。這是通過調用實現[setButton](qwizard.html#setButton)（）或[setButtonText](qwizard.html#setButtonText)（）與[CustomButton1](qwizard.html#WizardButton-enum)，[CustomButton2](qwizard.html#WizardButton-enum)或[CustomButton3](qwizard.html#WizardButton-enum)設置按鈕，并且通過使[HaveCustomButton1](qwizard.html#WizardOption-enum)，[HaveCustomButton2](qwizard.html#WizardOption-enum)或[HaveCustomButton3](qwizard.html#WizardOption-enum)選項。每當用戶點擊自定義按鈕，[customButtonClicked](qwizard.html#customButtonClicked)（）被發射。例如： ``` wizard()->setButtonText(QWizard.CustomButton1, tr("&Print")); wizard()->setOption(QWizard.HaveCustomButton1, true); connect(wizard(), SIGNAL(customButtonClicked(int)), this, SLOT(printButtonClicked())); ``` ### Elements of a Wizard Page 向導包括一個序列的[QWizardPage](qwizardpage.html)秒。在任何時間，僅示出一個頁面。一個頁面具有以下屬性： * A [title](qwizardpage.html#title-prop). * A [subTitle](qwizardpage.html#subTitle-prop). * A set of pixmaps, which may or may not be honored, depending on the wizard's style: * [WatermarkPixmap](qwizard.html#WizardPixmap-enum) (used by [ClassicStyle](qwizard.html#WizardStyle-enum) and [ModernStyle](qwizard.html#WizardStyle-enum)) * [BannerPixmap](qwizard.html#WizardPixmap-enum) (used by [ModernStyle](qwizard.html#WizardStyle-enum)) * [LogoPixmap](qwizard.html#WizardPixmap-enum) (used by [ClassicStyle](qwizard.html#WizardStyle-enum) and [ModernStyle](qwizard.html#WizardStyle-enum)) * [BackgroundPixmap](qwizard.html#WizardPixmap-enum) (used by [MacStyle](qwizard.html#WizardStyle-enum)) 圖中初級講座展示QWizard如何呈現這些屬性，假設他們都是現在和[ModernStyle](qwizard.html#WizardStyle-enum)用于： ![](https://img.kancloud.cn/9b/8c/9b8c1dbcd89daa5c4d23f8d613ed20a4_753x466.png) 當[subTitle](qwizardpage.html#subTitle-prop)被設置， QWizard在報頭中顯示它，在這種情況下，它也使用了[BannerPixmap](qwizard.html#WizardPixmap-enum)和[LogoPixmap](qwizard.html#WizardPixmap-enum)裝飾頭。該[WatermarkPixmap](qwizard.html#WizardPixmap-enum)被顯示在左側，頭下方。在底部，有一排按鈕允許用戶瀏覽頁面。頁面本身（的[QWizardPage](qwizardpage.html)插件）佔據的標題，水印，按鈕行之間的區域。典型地，該網頁是[QWizardPage](qwizardpage.html)在其上[QGridLayout](qgridlayout.html)安裝，使用標準子部件（[QLabel](qlabel.html)秒，[QLineEdit](qlineedit.html)秒，等等）。如果精靈的風格[MacStyle](qwizard.html#WizardStyle-enum)，頁面看起來完全不同： ![](https://img.kancloud.cn/7d/be/7dbefb6d8c8df167c55ee16616c51c69_903x459.png) 水印，旗幟，徽像素圖是由忽略[MacStyle](qwizard.html#WizardStyle-enum)。如果[BackgroundPixmap](qwizard.html#WizardPixmap-enum)被設置，它被用作背景為向導，否則，一個默認的“助手”的圖像被使用。標題和副標題都是通過調用設置[QWizardPage.setTitle](qwizardpage.html#title-prop)（）和[QWizardPage.setSubTitle](qwizardpage.html#subTitle-prop)（）上的個人網頁。他們可能是純文本或HTML （見[titleFormat](qwizard.html#titleFormat-prop)和[subTitleFormat](qwizard.html#subTitleFormat-prop)）。該像素圖就可以設置全局使用的整個向導[setPixmap](qwizard.html#setPixmap)（），或在每個頁面的基礎上使用[QWizardPage.setPixmap](qwizardpage.html#setPixmap)（）。 ### Registering and Using Fields 在許多向導頁面的內容可能會影響后面的頁的字段的缺省值。為了便于頁面之間進行通信， QWizard支持一個“場”的機制，允許您注冊一個字段（例如，[QLineEdit](qlineedit.html)）上的一個頁面，訪問任何網頁它的價值。它也可以指定必填字段（即，必須在用戶之前被填充字段可以前進到下一個頁面）。要注冊一個字段，調用[QWizardPage.registerField](qwizardpage.html#registerField)（）字段。例如： ``` ClassInfoPage.ClassInfoPage([QWidget](qwidget.html) *parent) : [QWizardPage](qwizardpage.html)(parent) { ... classNameLabel = new [QLabel](qlabel.html)(tr("&Class name:")); classNameLineEdit = new [QLineEdit](qlineedit.html); classNameLabel->setBuddy(classNameLineEdit); baseClassLabel = new [QLabel](qlabel.html)(tr("B&ase class:")); baseClassLineEdit = new [QLineEdit](qlineedit.html); baseClassLabel->setBuddy(baseClassLineEdit); qobjectMacroCheckBox = new [QCheckBox](qcheckbox.html)(tr("Generate Q_OBJECT &macro")); registerField("className*", classNameLineEdit); registerField("baseClass", baseClassLineEdit); registerField("qobjectMacro", qobjectMacroCheckBox); ... } ``` 上面的代碼注冊三個字段，`className`，`baseClass`和`qobjectMacro`，這是三個子控件相關聯。星號（`*`）旁`className`表示必填字段。任何頁面的字段是從什么頁面訪問。例如： ``` void OutputFilesPage.initializePage() { [QString](qstring.html) className = field("className").toString(); headerLineEdit->setText(className.toLower() + ".h"); implementationLineEdit->setText(className.toLower() + ".cpp"); outputDirLineEdit->setText([QDir](qdir.html).convertSeparators([QDir](qdir.html).tempPath())); } ``` 在這里，我們稱之為[QWizardPage.field](qwizardpage.html#field)（）來訪問的內容`className`字段（這是在所定義的`ClassInfoPage`），并用它來初始化`OuputFilePage`。該字段的內容返回為一個[QVariant](qvariant.html)。當我們使用創建一個字段[QWizardPage.registerField](qwizardpage.html#registerField)（），我們通過一個唯一的字段名和窗口小部件。我們還可以提供一個Qt的屬性名字和一個“改變”信號（即所發射的屬性發生變化時的信號）作為第三和第四個參數，但是，這是沒有必要的最常見的Qt部件，如[QLineEdit](qlineedit.html)，[QCheckBox](qcheckbox.html)和[QComboBox](qcombobox.html)，因為QWizard知道查找哪些屬性。如果一個星號（`*`）追加到名字的時候該物業登記，該字段是_mandatory field_。當一個頁面有必填字段中，**Next**和/或**Finish**按鈕被激活，只有當所有必填字段被填充。考慮現場“裝” ， QWizard簡單地檢查該字段的當前值不等于原來的值（它有值時，[initializePage](qwizard.html#initializePage)（）被調用）。為[QLineEdit](qlineedit.html)和[QAbstractSpinBox](qabstractspinbox.html)子類， QWizard還檢查[hasAcceptableInput()](qlineedit.html#acceptableInput-prop)返回True ，兌現任何驗證或面具。是提供了方便QWizard的強制性場機制。一個更強大的（但也比較麻煩），另一種方法是重新實現[QWizardPage.isComplete](qwizardpage.html#isComplete)（）和以發射[QWizardPage.completeChanged](qwizardpage.html#completeChanged)（）信號時的頁面變得完整或不完整。的啟用/禁用狀態**Next**和/或**Finish**按鈕是向所述用戶輸入執行驗證的一種方法。另一種方式是重新實現[validateCurrentPage](qwizard.html#validateCurrentPage)（）（或[QWizardPage.validatePage](qwizardpage.html#validatePage)（））來執行一些最后一分鐘的驗證（并且顯示一個錯誤信息，如果用戶輸入了不完整的或無效的信息）。如果函數返回True，則下一個頁面顯示（或向導完成），否則，在當前頁面熬夜。 ### Creating Linear Wizards 大多數向導具有線性結構，第1頁其次是第2頁，依此類推直到最后一頁。該[Class Wizard](index.htm)例子是這樣的精靈。隨著QWizard ，線性精靈是通過實例的創建[QWizardPage](qwizardpage.html)s和利用它們插入[addPage](qwizard.html#addPage)（）。默認情況下，頁面都顯示在它們被添加的順序。例如： ``` ClassWizard.ClassWizard([QWidget](qwidget.html) *parent) : QWizard(parent) { addPage(new IntroPage); addPage(new ClassInfoPage); addPage(new CodeStylePage); addPage(new OutputFilesPage); addPage(new ConclusionPage); ... } ``` 當一個網頁是關于要顯示， QWizard電話[initializePage](qwizard.html#initializePage)（）（這反過來又調用[QWizardPage.initializePage](qwizardpage.html#initializePage)（））來使用默認值填充頁面。默認情況下，此功能不執行任何操作，但它可以被重新實現來初始化基于其它網頁的田地頁面的內容（見[example above](#initialize-page)）。如果用戶按下**Back**，[cleanupPage](qwizard.html#cleanupPage)（）被調用（這反過來又調用[QWizardPage.cleanupPage](qwizardpage.html#cleanupPage)（））。默認實現重置頁面的欄位為原始值（他們之前所擁有的價值觀[initializePage](qwizard.html#initializePage)（）被調用）。如果你想要的**Back**按鈕是無損，并保持用戶輸入的值，只需啟用[IndependentPages](qwizard.html#WizardOption-enum)選項。 ### Creating Non-Linear Wizards 一些向導是更復雜的，因為它們允許基于由用戶所提供的信息不同的遍歷路徑。該[License Wizard](index.htm)舉例說明這一點。它提供了五個向導頁，具體取決于哪個選項被選中，用戶可以到達不同的頁面。 ![](https://img.kancloud.cn/60/28/60281b15c4859cff82a88827568c4ea2_593x423.png) 在復雜的向導，頁面識別標識。這些ID通常定義使用一個枚舉。例如： ``` class LicenseWizard : public QWizard { ... enum { Page_Intro, Page_Evaluate, Page_Register, Page_Details, Page_Conclusion }; ... }; ``` 該頁面使用插入[setPage](qwizard.html#setPage)（），它接受一個ID和一個實例[QWizardPage](qwizardpage.html)（子類或）： ``` LicenseWizard.LicenseWizard([QWidget](qwidget.html) *parent) : QWizard(parent) { setPage(Page_Intro, new IntroPage); setPage(Page_Evaluate, new EvaluatePage); setPage(Page_Register, new RegisterPage); setPage(Page_Details, new DetailsPage); setPage(Page_Conclusion, new ConclusionPage); ... } ``` 默認情況下，頁面中顯示遞增的ID順序。提供一個動態的順序取決于用戶選擇的選項，我們必須重新實現[QWizardPage.nextId](qwizardpage.html#nextId)（）。例如： ``` int IntroPage.nextId() const { if (evaluateRadioButton->isChecked()) { return LicenseWizard.Page_Evaluate; } else { return LicenseWizard.Page_Register; } } int EvaluatePage.nextId() const { return LicenseWizard.Page_Conclusion; } int RegisterPage.nextId() const { if (upgradeKeyLineEdit->text().isEmpty()) { return LicenseWizard.Page_Details; } else { return LicenseWizard.Page_Conclusion; } } int DetailsPage.nextId() const { return LicenseWizard.Page_Conclusion; } int ConclusionPage.nextId() const { return -1; } ``` 這也將有可能把所有的邏輯在一個地方，在一個[QWizard.nextId](qwizard.html#nextId)（）重新實現。例如： ``` int LicenseWizard.nextId() const { switch (currentId()) { case Page_Intro: if (field("intro.evaluate").toBool()) { return Page_Evaluate; } else { return Page_Register; } case Page_Evaluate: return Page_Conclusion; case Page_Register: if (field("register.upgradeKey").toString().isEmpty()) { return Page_Details; } else { return Page_Conclusion; } case Page_Details: return Page_Conclusion; case Page_Conclusion: default: return -1; } } ``` 開始在另一個頁面比頁面具有最低的ID ，調用[setStartId](qwizard.html#startId-prop)（）。要測試一個網頁是否已被訪問，則調用[hasVisitedPage](qwizard.html#hasVisitedPage)（）。例如： ``` void ConclusionPage.initializePage() { [QString](qstring.html) licenseText; if (wizard()->hasVisitedPage(LicenseWizard.Page_Evaluate)) { licenseText = tr("Evaluation License Agreement: " "You can use this software for 30 days and make one " "backup, but you are not allowed to distribute it."); } else if (wizard()->hasVisitedPage(LicenseWizard.Page_Details)) { licenseText = tr("First-Time License Agreement: " "You can use this software subject to the license " "you will receive by email."); } else { licenseText = tr("Upgrade License Agreement: " "This software is licensed under the terms of your " "current license."); } bottomLabel->setText(licenseText); } ``` * * * ## Type Documentation ``` QWizard.WizardButton ``` 此枚舉指定一個向導按鈕。 | Constant | Value | Description | | --- | --- | --- | | `QWizard.BackButton` | `0` | 該**Back**按鈕（**Go Back**在Mac OS X ） | | `QWizard.NextButton` | `1` | 該**Next**按鈕（**Continue**在Mac OS X ） | | `QWizard.CommitButton` | `2` | 該**Commit**鈕 | | `QWizard.FinishButton` | `3` | 該**Finish**按鈕（**Done**在Mac OS X ） | | `QWizard.CancelButton` | `4` | 該**Cancel**按鈕（參見[NoCancelButton](qwizard.html#WizardOption-enum)） | | `QWizard.HelpButton` | `5` | 該**Help**按鈕（參見[HaveHelpButton](qwizard.html#WizardOption-enum)） | | `QWizard.CustomButton1` | `6` | 第一個用戶自定義按鈕（參見[HaveCustomButton1](qwizard.html#WizardOption-enum)） | | `QWizard.CustomButton2` | `7` | 第二個用戶自定義按鈕（也見[HaveCustomButton2](qwizard.html#WizardOption-enum)） | | `QWizard.CustomButton3` | `8` | 第三個用戶自定義按鈕（也見[HaveCustomButton3](qwizard.html#WizardOption-enum)） | 當調用下面的值才有用[setButtonLayout](qwizard.html#setButtonLayout)（）： | Constant | Value | Description | | --- | --- | --- | | `QWizard.Stretch` | `9` | 的水平伸展的按鈕布局 | **See also** [setButton](qwizard.html#setButton)（）[setButtonText](qwizard.html#setButtonText)（）[setButtonLayout](qwizard.html#setButtonLayout)（）和[customButtonClicked](qwizard.html#customButtonClicked)（）。 ``` QWizard.WizardOption ``` 此枚舉指定影響精靈的外觀和感覺的各種選項。 | Constant | Value | Description | | --- | --- | --- | | `QWizard.IndependentPages` | `0x00000001` | 頁面是相互獨立的（即，它們不會相互派生值）。 | | `QWizard.IgnoreSubTitles` | `0x00000002` | 不顯示任何字幕，即使它們被設置。 | | `QWizard.ExtendedWatermarkPixmap` | `0x00000004` | 任何延長[WatermarkPixmap](qwizard.html#WizardPixmap-enum)一路下跌到窗口的邊緣。 | | `QWizard.NoDefaultButton` | `0x00000008` | 不要使**Next** or **Finish**按鈕對話框的[default button](qpushbutton.html#default-prop)。 | | `QWizard.NoBackButtonOnStartPage` | `0x00000010` | 不顯示**Back**在開始頁面上按鈕。 | | `QWizard.NoBackButtonOnLastPage` | `0x00000020` | 不顯示**Back**在最后一頁按鈕。 | | `QWizard.DisabledBackButtonOnLastPage` | `0x00000040` | 關閉**Back**在最后一頁按鈕。 | | `QWizard.HaveNextButtonOnLastPage` | `0x00000080` | 顯示（禁用）**Next**在最后一頁按鈕。 | | `QWizard.HaveFinishButtonOnEarlyPages` | `0x00000100` | 顯示（禁用）**Finish**在非最后幾頁按鈕。 | | `QWizard.NoCancelButton` | `0x00000200` | 不顯示**Cancel**按鈕。 | | `QWizard.CancelButtonOnLeft` | `0x00000400` | 把**Cancel**上的左按鈕**Back**（而不是右側**Finish** or **Next**）。 | | `QWizard.HaveHelpButton` | `0x00000800` | 顯示**Help**按鈕。 | | `QWizard.HelpButtonOnRight` | `0x00001000` | 把**Help**上的按鍵布局（而不是在最左側）最右邊的按鈕。 | | `QWizard.HaveCustomButton1` | `0x00002000` | 顯示的第一個用戶自定義按鈕（[CustomButton1](qwizard.html#WizardButton-enum)）。 | | `QWizard.HaveCustomButton2` | `0x00004000` | 顯示第二個用戶自定義按鈕（[CustomButton2](qwizard.html#WizardButton-enum)）。 | | `QWizard.HaveCustomButton3` | `0x00008000` | 顯示第三個用戶自定義按鈕（[CustomButton3](qwizard.html#WizardButton-enum)）。 | 該WizardOptions類型是一個typedef為[QFlags](index.htm)\u003cWizardOption\u003e 。它存儲WizardOption值的或組合。 **See also** [setOptions](qwizard.html#options-prop)（）[setOption](qwizard.html#setOption)（）和[testOption](qwizard.html#testOption)（）。 ``` QWizard.WizardPixmap ``` 該枚舉指定可以與一個頁面相關聯的像素圖。 | Constant | Value | Description | | --- | --- | --- | | `QWizard.WatermarkPixmap` | `0` | 上一個左側的高像素圖[ClassicStyle](qwizard.html#WizardStyle-enum) or [ModernStyle](qwizard.html#WizardStyle-enum)頁面 | | `QWizard.LogoPixmap` | `1` | 右側的小像素圖[ClassicStyle](qwizard.html#WizardStyle-enum) or [ModernStyle](qwizard.html#WizardStyle-enum)頁頭 | | `QWizard.BannerPixmap` | `2` | 佔據的背景像素圖[ModernStyle](qwizard.html#WizardStyle-enum)頁頭 | | `QWizard.BackgroundPixmap` | `3` | 佔據的背景像素圖[MacStyle](qwizard.html#WizardStyle-enum)巫師 | **See also** [setPixmap](qwizard.html#setPixmap)（）[QWizardPage.setPixmap](qwizardpage.html#setPixmap)（）和[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)。 ``` QWizard.WizardStyle ``` 此枚舉指定所支持的不同的外觀[QWizard](qwizard.html)。 | Constant | Value | Description | | --- | --- | --- | | `QWizard.ClassicStyle` | `0` | 經典的Windows外觀 | | `QWizard.ModernStyle` | `1` | 現代的Windows外觀 | | `QWizard.MacStyle` | `2` | 的Mac OS X的外觀 | | `QWizard.AeroStyle` | `3` | Windows Aero的外觀 | **See also** [setWizardStyle](qwizard.html#wizardStyle-prop)（）[WizardOption](qwizard.html#WizardOption-enum)和[Wizard Look and Feel](qwizard.html#wizard-look-and-feel)。 * * * ## Method Documentation ``` QWizard.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個向導給定的_parent_和窗口_flags_。 **See also** [parent](qobject.html#parent)（）和[windowFlags](qwidget.html#windowFlags-prop)（）。 ``` int QWizard.addPage (self, QWizardPage?page) ``` 該_page_說法有它的所有權轉移給Qt的。將給定_page_精靈，并返回該頁面的ID 。該ID是保證比任何其他大的ID[QWizard](qwizard.html)到目前為止。 **See also** [setPage](qwizard.html#setPage)（）[page](qwizard.html#page)（）和[pageAdded](qwizard.html#pageAdded)（）。 ``` QWizard.back (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void back()`。返回到前一個頁面。這相當于按下**Back**按鈕。 **See also** [next](qwizard.html#next)（）[accept](qdialog.html#accept)（）[reject](qdialog.html#reject)（）和[restart](qwizard.html#restart)（）。 ``` QAbstractButton QWizard.button (self, WizardButton?which) ``` [ 返回對應于角色的按鈕_which_。 ](qabstractbutton.html) [**See also**](qabstractbutton.html) [setButton](qwizard.html#setButton)（）和[setButtonText](qwizard.html#setButtonText)（）。 ``` QString QWizard.buttonText (self, WizardButton?which) ``` 按鈕返回文本_which_。如果使用的是文本有奔集[setButtonText](qwizard.html#setButtonText)（），則返回該文本。默認情況下，按鈕上的文本取決于[wizardStyle](qwizard.html#wizardStyle-prop)。例如，在Mac OS X中，**Next**按鈕被稱為**Continue**。 **See also** [button](qwizard.html#button)（）[setButton](qwizard.html#setButton)（）[setButtonText](qwizard.html#setButtonText)（）[QWizardPage.buttonText](qwizardpage.html#buttonText)（）和[QWizardPage.setButtonText](qwizardpage.html#setButtonText)（）。 ``` QWizard.cleanupPage (self, int?id) ``` 這個虛函數被調用[QWizard](qwizard.html)清理頁面_id_用戶通過點擊它離開之前**Back**（除非[QWizard.IndependentPages](qwizard.html#WizardOption-enum)選項設置）。默認實現調用[QWizardPage.cleanupPage](qwizardpage.html#cleanupPage)（）頁（_id_）。 **See also** [QWizardPage.cleanupPage](qwizardpage.html#cleanupPage)（）和[initializePage](qwizard.html#initializePage)（）。 ``` int QWizard.currentId (self) ``` ``` QWizardPage QWizard.currentPage (self) ``` [ 返回一個指針，指向當前頁面，或者0，如果沒有當前頁面（例如，向導會顯示之前）。 ](qwizardpage.html) [這等同于調用頁面（](qwizardpage.html)[currentId](qwizard.html#currentId-prop)（））。 **See also** [page](qwizard.html#page)（）[currentId](qwizard.html#currentId-prop)（）和[restart](qwizard.html#restart)（）。 ``` QWizard.done (self, int?result) ``` 從重新實現[QDialog.done](qdialog.html#done)（）。 ``` bool QWizard.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QVariant QWizard.field (self, QString?name) ``` 返回字段的所謂的值_name_。此功能可用于訪問向導的任何頁面上的字段。 **See also** [QWizardPage.registerField](qwizardpage.html#registerField)（）[QWizardPage.field](qwizardpage.html#field)（）和[setField](qwizard.html#setField)（）。 ``` bool QWizard.hasVisitedPage (self, int?id) ``` 如果頁面歷史記錄中包含頁面，則返回True_id_否則，返回False 。 Pressing **Back**當前頁面標記為“未訪問”了。 **See also** [visitedPages](qwizard.html#visitedPages)（）。 ``` QWizard.initializePage (self, int?id) ``` 這個虛函數被調用[QWizard](qwizard.html)準備一頁_id_它表明無論是作為一個結果之前[QWizard.restart](qwizard.html#restart)（）被調用時，或者當用戶點擊的結果**Next**。（然而，如果[QWizard.IndependentPages](qwizard.html#WizardOption-enum)選項設置，此功能只在第一次調用的頁面顯示。）通過重新實現這個功能，可以確保基于前幾頁信息頁面的欄已正確初始化。默認實現調用[QWizardPage.initializePage](qwizardpage.html#initializePage)（）頁（_id_）。 **See also** [QWizardPage.initializePage](qwizardpage.html#initializePage)（）和[cleanupPage](qwizard.html#cleanupPage)（）。 ``` QWizard.next (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void next()`。前進到下一個頁面。這相當于按下**Next** or **Commit**按鈕。 **See also** [nextId](qwizard.html#nextId)（）[back](qwizard.html#back)（）[accept](qdialog.html#accept)（）[reject](qdialog.html#reject)（）和[restart](qwizard.html#restart)（）。 ``` int QWizard.nextId (self) ``` 這個虛函數被調用[QWizard](qwizard.html)找出當用戶點擊顯示哪些頁面**Next**按鈕。返回值是下一個頁面的ID ，或-1，如果沒有頁面如下。默認實現調用[QWizardPage.nextId](qwizardpage.html#nextId)（）對[currentPage](qwizard.html#currentPage)（）。通過重新實現此功能，您可以指定一個動態的頁面順序。 **See also** [QWizardPage.nextId](qwizardpage.html#nextId)（）和[currentPage](qwizard.html#currentPage)（）。 ``` WizardOptions QWizard.options (self) ``` [](index.htm) ``` QWizardPage QWizard.page (self, int?id) ``` [ 用給定的返回頁面_id_或0，如果不存在這樣的頁面。 ](qwizardpage.html) [**See also**](qwizardpage.html) [addPage](qwizard.html#addPage)（）和[setPage](qwizard.html#setPage)（）。 ``` list-of-int QWizard.pageIds (self) ``` 返回頁ID的列表。此功能被引入Qt的4.5 。 ``` QWizard.paintEvent (self, QPaintEvent?event) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` QPixmap QWizard.pixmap (self, WizardPixmap?which) ``` [ 返回角色像素圖組_which_。 ](qpixmap.html) [默認情況下，設置唯一的像素圖是](qpixmap.html)[BackgroundPixmap](qwizard.html#WizardPixmap-enum)在Mac OS X。 **See also** [setPixmap](qwizard.html#setPixmap)（）[QWizardPage.pixmap](qwizardpage.html#pixmap)（）和[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)。 ``` QWizard.removePage (self, int?id) ``` 刪除的頁面與給定_id_。[cleanupPage](qwizard.html#cleanupPage)（）將在必要時調用。 **Note:**刪除頁面可能影響的價值[startId](qwizard.html#startId-prop)屬性。此功能被引入Qt的4.5 。 **See also** [addPage](qwizard.html#addPage)（）[setPage](qwizard.html#setPage)（）[pageRemoved](qwizard.html#pageRemoved)（）和[startId](qwizard.html#startId-prop)（）。 ``` QWizard.resizeEvent (self, QResizeEvent?event) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QWizard.restart (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void restart()`。重新啟動向導在開始頁面。這個函數被自動調用該向導顯示時。 **See also** [startId](qwizard.html#startId-prop)（）。 ``` QWizard.setButton (self, WizardButton?which, QAbstractButton?button) ``` 該_button_說法有它的所有權轉移給Qt的。設置對應的角色按鈕_which_至_button_。要添加額外的按鈕向導（例如，一**Print**鈕），一個方法是調用SET按鈕（）與[CustomButton1](qwizard.html#WizardButton-enum)至[CustomButton3](qwizard.html#WizardButton-enum)，并使用make可見的按鈕[HaveCustomButton1](qwizard.html#WizardOption-enum)至[HaveCustomButton3](qwizard.html#WizardOption-enum)選項。 **See also** [button](qwizard.html#button)（）[setButtonText](qwizard.html#setButtonText)（）[setButtonLayout](qwizard.html#setButtonLayout)（）和[options](qwizard.html#options-prop)。 ``` QWizard.setButtonLayout (self, list-of-QWizard.WizardButton?layout) ``` 設置在該按鈕所顯示的順序_layout_，其中_layout_是的列表[WizardButton](qwizard.html#WizardButton-enum)秒。默認的布局取決于選項（例如，是否[HelpButtonOnRight](qwizard.html#WizardOption-enum)）被設置。如果你需要比更多的控制按鈕的布局你可以調用這個函數是什么[options](qwizard.html#options-prop)已經提供。您可以使用指定的布局橫向延伸[Stretch](qwizard.html#WizardButton-enum)。例如： ``` MyWizard.MyWizard([QWidget](qwidget.html) *parent) : [QWizard](qwizard.html)(parent) { ... [QList](index.htm)<[QWizard](qwizard.html).WizardButton> layout; layout << [QWizard](qwizard.html).Stretch << [QWizard](qwizard.html).BackButton << [QWizard](qwizard.html).CancelButton << [QWizard](qwizard.html).NextButton << [QWizard](qwizard.html).FinishButton; setButtonLayout(layout); ... } ``` **See also** [setButton](qwizard.html#setButton)（）[setButtonText](qwizard.html#setButtonText)（）和[setOptions](qwizard.html#options-prop)（）。 ``` QWizard.setButtonText (self, WizardButton?which, QString?text) ``` 按鈕設置文本_which_要_text_。默認情況下，按鈕上的文本取決于[wizardStyle](qwizard.html#wizardStyle-prop)。例如，在Mac OS X中，**Next**按鈕被稱為**Continue**。要添加額外的按鈕向導（例如，一**Print**鈕），一個方法是調用setButtonText （）與[CustomButton1](qwizard.html#WizardButton-enum)，[CustomButton2](qwizard.html#WizardButton-enum)或[CustomButton3](qwizard.html#WizardButton-enum)設定自己的文字，并使用make可見的按鈕[HaveCustomButton1](qwizard.html#WizardOption-enum)，[HaveCustomButton2](qwizard.html#WizardOption-enum)和/或[HaveCustomButton3](qwizard.html#WizardOption-enum)選項。在每個頁面的基礎上使用按鈕的文本也可以設置[QWizardPage.setButtonText](qwizardpage.html#setButtonText)（）。 **See also** [buttonText](qwizard.html#buttonText)（）[setButton](qwizard.html#setButton)（）[button](qwizard.html#button)（）[setButtonLayout](qwizard.html#setButtonLayout)（）[setOptions](qwizard.html#options-prop)（）和[QWizardPage.setButtonText](qwizardpage.html#setButtonText)（）。 ``` QWizard.setDefaultProperty (self, str?className, str?property, str?changedSignal) ``` 設置為默認屬性_className_要_property_和相關聯的變化信號是_changedSignal_。默認屬性時使用的一個實例_className_（它的一個子類或）傳遞給[QWizardPage.registerField](qwizardpage.html#registerField)（），并指定屬性。 [QWizard](qwizard.html)知道最常見的Qt部件。對于這些（或其子類），你不需要指定_property_或_changedSignal_。下表列出了這些小部件： | Widget | Property | Change Notification Signal | | --- | --- | --- | | [QAbstractButton](qabstractbutton.html) | bool [checked](qabstractbutton.html#checked-prop) | [toggled()](qabstractbutton.html#toggled) | | [QAbstractSlider](qabstractslider.html) | int [value](qabstractslider.html#value-prop) | [valueChanged()](qabstractslider.html#valueChanged) | | [QComboBox](qcombobox.html) | int [currentIndex](qcombobox.html#currentIndex-prop) | [currentIndexChanged()](qcombobox.html#currentIndexChanged) | | [QDateTimeEdit](qdatetimeedit.html) | [QDateTime](qdatetime.html) [dateTime](qdatetimeedit.html#dateTime-prop) | [dateTimeChanged()](qdatetimeedit.html#dateTimeChanged) | | [QLineEdit](qlineedit.html) | [QString](qstring.html) [text](qlineedit.html#text-prop) | [textChanged()](qlineedit.html#textChanged) | | [QListWidget](qlistwidget.html) | int [currentRow](qlistwidget.html#currentRow-prop) | [currentRowChanged()](qlistwidget.html#currentRowChanged) | | [QSpinBox](qspinbox.html) | int [value](qspinbox.html#value-prop) | [valueChanged()](qspinbox.html#valueChanged) | **See also** [QWizardPage.registerField](qwizardpage.html#registerField)（）。 ``` QWizard.setField (self, QString?name, QVariant?value) ``` 設置字段中稱為值_name_至_value_。此功能可用于在向導的任何頁面上設置的字段。 **See also** [QWizardPage.registerField](qwizardpage.html#registerField)（）[QWizardPage.setField](qwizardpage.html#setField)（）和[field](qwizard.html#field)（）。 ``` QWizard.setOption (self, WizardOption?option, bool?on?=?True) ``` 設置給定_option_被啟用，如果_on_是真的，否則，清除給定的_option_。 **See also** [options](qwizard.html#options-prop)，[testOption](qwizard.html#testOption)（）和[setWizardStyle](qwizard.html#wizardStyle-prop)（）。 ``` QWizard.setOptions (self, WizardOptions?options) ``` ``` QWizard.setPage (self, int?id, QWizardPage?page) ``` 該_page_說法有它的所有權轉移給Qt的。將給定_page_與給定的精靈_id_。 **Note:**添加頁面可能影響的價值[startId](qwizard.html#startId-prop)在財產的情況下它是沒有顯式設置。 **See also** [addPage](qwizard.html#addPage)（）[page](qwizard.html#page)（）和[pageAdded](qwizard.html#pageAdded)（）。 ``` QWizard.setPixmap (self, WizardPixmap?which, QPixmap?pixmap) ``` 設置像素圖的作用_which_至_pixmap_。該像素圖所使用的[QWizard](qwizard.html)顯示一個頁面時。其中像素圖實際使用依賴于[wizard style](qwizard.html#wizard-look-and-feel)。像素圖，也可以使用一個特定的頁面設置[QWizardPage.setPixmap](qwizardpage.html#setPixmap)（）。 **See also** [pixmap](qwizard.html#pixmap)（）[QWizardPage.setPixmap](qwizardpage.html#setPixmap)（）和[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)。 ``` QWizard.setSideWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。設置給定_widget_要顯示在該向導的左側。對于使用樣式[WatermarkPixmap](qwizard.html#WizardPixmap-enum)（[ClassicStyle](qwizard.html#WizardStyle-enum)和[ModernStyle](qwizard.html#WizardStyle-enum)）側部件上顯示水印的頂部，對于其它樣式或不設置水印當側部件上顯示該向導的左側。傳遞0表示無副作用小部件。當_widget_是不是0精靈reparents它。任何以前的側部件被隱藏。您可致電setSideWidget （）使用相同的部件在不同的時間。這里設置的所有部件將由向導時，它被摧毀，除非你單獨reparent小部件設置一些對方部件（或0 ）后刪除。默認情況下，無副作用小部件存在。此功能被引入Qt的4.7 。 **See also** [sideWidget](qwizard.html#sideWidget)（）。 ``` QWizard.setStartId (self, int?id) ``` ``` QWizard.setSubTitleFormat (self, Qt.TextFormat?format) ``` ``` QWizard.setTitleFormat (self, Qt.TextFormat?format) ``` ``` QWizard.setVisible (self, bool?visible) ``` 從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（）。 ``` QWizard.setWizardStyle (self, WizardStyle?style) ``` ``` QWidget QWizard.sideWidget (self) ``` [ 返回在向導或0的左側的小部件。默認情況下，無副作用小部件存在。此功能被引入Qt的4.7 。 ](qwidget.html) [**See also**](qwidget.html) [setSideWidget](qwizard.html#setSideWidget)（）。 ``` QSize QWizard.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` int QWizard.startId (self) ``` ``` Qt.TextFormat QWizard.subTitleFormat (self) ``` [ ``` bool QWizard.testOption (self, WizardOption?option) ``` 返回True如果給定的_option_被啟用，否則返回False 。 ](qt.html#TextFormat-enum) [**See also**](qt.html#TextFormat-enum) [options](qwizard.html#options-prop)，[setOption](qwizard.html#setOption)（）和[setWizardStyle](qwizard.html#wizardStyle-prop)（）。 ``` Qt.TextFormat QWizard.titleFormat (self) ``` [ ``` bool QWizard.validateCurrentPage (self) ``` ](qt.html#TextFormat-enum) [這個虛函數被調用](qt.html#TextFormat-enum)[QWizard](qwizard.html)當用戶點擊**Next** or **Finish**執行一些最后一分鐘的驗證。如果返回True，則下一個頁面顯示（或向導完成），否則，在當前頁面熬夜。默認實現調用[QWizardPage.validatePage](qwizardpage.html#validatePage)（）對[currentPage](qwizard.html#currentPage)（）。如果可能的話，它通常是更好的風格禁用**Next** or **Finish**按鈕（通過指定[mandatory fields](qwizard.html#mandatory-fields)或通過重新實現[QWizardPage.isComplete](qwizardpage.html#isComplete)（）），而不是重新實現validateCurrentPage （）。 **See also** [QWizardPage.validatePage](qwizardpage.html#validatePage)（）和[currentPage](qwizard.html#currentPage)（）。 ``` list-of-int QWizard.visitedPages (self) ``` 返回瀏覽過的網頁的ID列表，在其中的網頁被訪問的順序。 Pressing **Back**當前頁面標記為“未訪問”了。 **See also** [hasVisitedPage](qwizard.html#hasVisitedPage)（）。 ``` WizardStyle QWizard.wizardStyle (self) ``` [ * * * ## Qt Signal Documentation ``` void currentIdChanged (int) ``` 這是該信號的默認超載。這個信號被發射時，當前頁面的變化，與新的當前_id_。 ](qwizard.html#WizardStyle-enum) [**See also**](qwizard.html#WizardStyle-enum) [currentId](qwizard.html#currentId-prop)（）和[currentPage](qwizard.html#currentPage)（）。 ``` void customButtonClicked (int) ``` 這是該信號的默認超載。當用戶點擊自定義按鈕這個信號被發射。_which_可以[CustomButton1](qwizard.html#WizardButton-enum)，[CustomButton2](qwizard.html#WizardButton-enum)或[CustomButton3](qwizard.html#WizardButton-enum)。默認情況下，顯示沒有自定義按鈕。通話[setOption](qwizard.html#setOption)（）與[HaveCustomButton1](qwizard.html#WizardOption-enum)，[HaveCustomButton2](qwizard.html#WizardOption-enum)或[HaveCustomButton3](qwizard.html#WizardOption-enum)有一個，并使用[setButtonText](qwizard.html#setButtonText)（）或[setButton](qwizard.html#setButton)（）來配置它。 **See also** [helpRequested](qwizard.html#helpRequested)（）。 ``` void helpRequested () ``` This is the default overload of this signal. 當用戶點擊這個信號被發射的**Help**按鈕。缺省情況下，**Help**顯示按鈕。調用的SetOption （[HaveHelpButton](qwizard.html#WizardOption-enum)，真）有一個。例如： ``` LicenseWizard.LicenseWizard([QWidget](qwidget.html) *parent) : [QWizard](qwizard.html)(parent) { ... setOption(HaveHelpButton, true); connect(this, SIGNAL(helpRequested()), this, SLOT(showHelp())); ... } void LicenseWizard.showHelp() { static [QString](qstring.html) lastHelpMessage; [QString](qstring.html) 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](qmessagebox.html).information(this, tr("License Wizard Help"), message); } ``` **See also** [customButtonClicked](qwizard.html#customButtonClicked)（）。 ``` void pageAdded (int) ``` 這是該信號的默認超載。每當一個頁面被添加到向導這個信號被發射。在頁面的_id_作為參數傳遞。此功能被引入Qt的4.7 。 **See also** [addPage](qwizard.html#addPage)（）[setPage](qwizard.html#setPage)（）和[startId](qwizard.html#startId-prop)（）。 ``` void pageRemoved (int) ``` 這是該信號的默認超載。每當一個頁面被從向導刪除這個信號被發射。在頁面的_id_作為參數傳遞。此功能被引入Qt的4.7 。 **See also** [removePage](qwizard.html#removePage)（）和[startId](qwizard.html#startId-prop)（）。