QWizardPage Class Reference · PyQt4 中文文檔

# QWizardPage Class Reference ## [[QtGui](index.htm) module] 該QWizardPage類是向導頁面的基類。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `QString buttonText (self, QWizard.WizardButton?which)` * `cleanupPage (self)` * `QVariant field (self, QString?name)` * `initializePage (self)` * `bool isCommitPage (self)` * `bool isComplete (self)` * `bool isFinalPage (self)` * `int nextId (self)` * `QPixmap pixmap (self, QWizard.WizardPixmap?which)` * `registerField (self, QString?name, QWidget?widget, str?property?=?None, signal?changedSignal?=?0)` * `registerField (self, QString?name, QWidget?widget, str?property?=?None, SIGNAL()?changedSignal?=?0)` * `setButtonText (self, QWizard.WizardButton?which, QString?text)` * `setCommitPage (self, bool?commitPage)` * `setField (self, QString?name, QVariant?value)` * `setFinalPage (self, bool?finalPage)` * `setPixmap (self, QWizard.WizardPixmap?which, QPixmap?pixmap)` * `setSubTitle (self, QString?subTitle)` * `setTitle (self, QString?title)` * `QString subTitle (self)` * `QString title (self)` * `bool validatePage (self)` * `QWizard wizard (self)` ### Qt Signals * `void completeChanged ()` * * * ## Detailed Description 該QWizardPage類是向導頁面的基類。 [QWizard](qwizard.html)代表一個向導。每個頁面都是一個QWizardPage 。當您創建自己的向導，您可以直接使用QWizardPage ，或者你可以繼承它進行更多的控制。一個頁面有如下屬性，這是由提供[QWizard](qwizard.html)：一[title](qwizardpage.html#title-prop)，一[subTitle](qwizardpage.html#subTitle-prop)和[set of pixmaps](qwizardpage.html#setPixmap)。看[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)了解詳情。當一個頁面被（使用添加向導[QWizard.addPage](qwizard.html#addPage)（）或[QWizard.setPage](qwizard.html#setPage)（）），[wizard](qwizardpage.html#wizard)（）返回一個指向相關[QWizard](qwizard.html)對象。頁面提供了可重新實現以提供自定義行為五個虛擬函數： * [initializePage](qwizardpage.html#initializePage)() is called to initialize the page's contents when the user clicks the wizard's **Next** button. If you want to derive the page's default from what the user entered on previous pages, this is the function to reimplement. * [cleanupPage](qwizardpage.html#cleanupPage)() is called to reset the page's contents when the user clicks the wizard's **Back** button. * [validatePage](qwizardpage.html#validatePage)() validates the page when the user clicks **Next** or **Finish**. It is often used to show an error message if the user has entered incomplete or invalid information. * [nextId](qwizardpage.html#nextId)() returns the ID of the next page. It is useful when [creating non-linear wizards](qwizard.html#creating-non-linear-wizards), which allow different traversal paths based on the information provided by the user. * [isComplete](qwizardpage.html#isComplete)() is called to determine whether the **Next** and/or **Finish** button should be enabled or disabled. If you reimplement [isComplete](qwizardpage.html#isComplete)(), also make sure that [completeChanged](qwizardpage.html#completeChanged)() is emitted whenever the complete state changes. 一般情況下，**Next**按鈕和**Finish**向導按鈕是互斥的。如果[isFinalPage](qwizardpage.html#isFinalPage)（）返回True ，**Finish**可用，否則**Next**是可用的。默認情況下，[isFinalPage](qwizardpage.html#isFinalPage)（）為真，只有當[nextId](qwizardpage.html#nextId)（）返回-1 。如果你想顯示**Next**和**Final**同時一個頁面（讓用戶執行一個“早完成” ），調用setFinalPage （真）在該網頁。對于支持早期完成向導，您可能還需要設置[HaveNextButtonOnLastPage](qwizard.html#WizardOption-enum)和[HaveFinishButtonOnEarlyPages](qwizard.html#WizardOption-enum)在該向導的選項。在許多向導頁面的內容可能會影響后面的頁的字段的缺省值。為了便于頁面之間進行通信，[QWizard](qwizard.html)支持["field" mechanism](qwizard.html#registering-and-using-fields)這允許您注冊一個字段（例如，一[QLineEdit](qlineedit.html)）上的一個頁面，訪問任何網頁它的價值。字段是全球整個向導，很容易讓任何一個網頁訪問另一個頁面存儲的信息，而不必把所有的邏輯[QWizard](qwizard.html)或具有明確的頁面了解對方。字段使用登記[registerField](qwizardpage.html#registerField)（），并且可以在任何時間使用訪問[field](qwizardpage.html#field)（）和[setField](qwizardpage.html#setField)（）。 * * * ## Method Documentation ``` QWizardPage.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個向導頁中給定的_parent_。當頁面使用插入向導[QWizard.addPage](qwizard.html#addPage)（）或[QWizard.setPage](qwizard.html#setPage)（），父被自動設置為向導。 **See also** [wizard](qwizardpage.html#wizard)（）。 ``` QString QWizardPage.buttonText (self, QWizard.WizardButton?which) ``` 按鈕返回文本_which_此頁面上。如果使用的是文本有奔集[setButtonText](qwizardpage.html#setButtonText)（），則返回該文本。否則，如果文本已經使用設置[QWizard.setButtonText](qwizard.html#setButtonText)（），則返回該文本。默認情況下，按鈕上的文本取決于[QWizard.wizardStyle](qwizard.html#wizardStyle-prop)。例如，在Mac OS X中，**Next**按鈕被稱為**Continue**。 **See also** [setButtonText](qwizardpage.html#setButtonText)（）[QWizard.buttonText](qwizard.html#buttonText)（）和[QWizard.setButtonText](qwizard.html#setButtonText)（）。 ``` QWizardPage.cleanupPage (self) ``` 這個虛函數被調用[QWizard.cleanupPage](qwizard.html#cleanupPage)（）用戶通過點擊離開頁面時**Back**（除非[QWizard.IndependentPages](qwizard.html#WizardOption-enum)選項設置）。默認實現重置頁面的欄位為原始值（他們之前所擁有的價值觀[initializePage](qwizardpage.html#initializePage)（）被調用）。 **See also** [QWizard.cleanupPage](qwizard.html#cleanupPage)（）[initializePage](qwizardpage.html#initializePage)（）和[QWizard.IndependentPages](qwizard.html#WizardOption-enum)。 ``` QVariant QWizardPage.field (self, QString?name) ``` 返回字段的所謂的值_name_。此功能可用于訪問向導的任何頁面上的字段。這等同于調用[wizard](qwizardpage.html#wizard)（） - \u003e[field](qwizard.html#field)（_name_）。例如： ``` 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())); } ``` **See also** [QWizard.field](qwizard.html#field)（）[setField](qwizardpage.html#setField)（）和[registerField](qwizardpage.html#registerField)（）。 ``` QWizardPage.initializePage (self) ``` 這個虛函數被調用[QWizard.initializePage](qwizard.html#initializePage)（）編寫的網頁也顯示無論是作為一個結果之前[QWizard.restart](qwizard.html#restart)（）被調用時，或者當用戶點擊的結果**Next**。（然而，如果[QWizard.IndependentPages](qwizard.html#WizardOption-enum)選項設置，此功能只在第一次調用的頁面顯示。）通過重新實現這個功能，可以確保基于前幾頁信息頁面的欄已正確初始化。例如： ``` 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())); } ``` 默認實現不執行任何操作。 **See also** [QWizard.initializePage](qwizard.html#initializePage)（）[cleanupPage](qwizardpage.html#cleanupPage)（）和[QWizard.IndependentPages](qwizard.html#WizardOption-enum)。 ``` bool QWizardPage.isCommitPage (self) ``` 返回True如果該頁面是一個提交頁面，否則返回False 。 **See also** [setCommitPage](qwizardpage.html#setCommitPage)（）。 ``` bool QWizardPage.isComplete (self) ``` 這個虛函數被調用[QWizard](qwizard.html)以確定是否**Next** or **Finish**按鈕應該被啟用或禁用。默認實現返回True，如果所有[mandatory fields](qwizard.html#mandatory-fields)充滿，否則返回False 。如果重新實現此功能，請確保發射[completeChanged](qwizardpage.html#completeChanged)（），從您的實現，只要在isComplete的值（）變化的其馀部分。這確保了[QWizard](qwizard.html)更新其按鈕的啟用或禁用狀態。重新實現的一個示例是可 [here](http://qt.nokia.com/doc/qq/qq22-qwizard.html#validatebeforeitstoolate)。 **See also** [completeChanged](qwizardpage.html#completeChanged)（）和[isFinalPage](qwizardpage.html#isFinalPage)（）。 ``` bool QWizardPage.isFinalPage (self) ``` 調用此函數由[QWizard](qwizard.html)以確定是否**Finish**按鈕應顯示該頁面與否。默認情況下，如果沒有下一個頁面（即返回True ，[nextId](qwizardpage.html#nextId)（）返回-1 ），否則返回False 。通過顯式調用setFinalPage （真），可以讓用戶執行“最早完成” 。 **See also** [isComplete](qwizardpage.html#isComplete)（）和[QWizard.HaveFinishButtonOnEarlyPages](qwizard.html#WizardOption-enum)。 ``` int QWizardPage.nextId (self) ``` 這個虛函數被調用[QWizard.nextId](qwizard.html#nextId)（）來找出當用戶點擊顯示哪些頁面**Next**按鈕。返回值是下一個頁面的ID ，或-1，如果沒有頁面如下。默認情況下，這個函數返回的最低編號大于當前頁面的ID ，或-1，如果沒有這樣的標識。通過重新實現此功能，您可以指定一個動態的頁面順序。例如： ``` int IntroPage.nextId() const { if (evaluateRadioButton->isChecked()) { return LicenseWizard.Page_Evaluate; } else { return LicenseWizard.Page_Register; } } ``` **See also** [QWizard.nextId](qwizard.html#nextId)（）。 ``` QPixmap QWizardPage.pixmap (self, QWizard.WizardPixmap?which) ``` [ 返回角色像素圖組_which_。 ](qpixmap.html) [像素圖，也可以使用整個向導設置](qpixmap.html)[QWizard.setPixmap](qwizard.html#setPixmap)（），在這種情況下，他們申請不指定像素圖的所有頁面。 **See also** [setPixmap](qwizardpage.html#setPixmap)（）[QWizard.pixmap](qwizard.html#pixmap)（）和[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)。 ``` QWizardPage.registerField (self, QString?name, QWidget?widget, str?property?=?None, signal?changedSignal?=?0) ``` 創建一個名為場_name_用給定的相關聯_property_的給定_widget_。從那時起，該屬性使用變得方便[field](qwizardpage.html#field)（）和[setField](qwizardpage.html#setField)（）。字段是全球整個向導，很容易讓任何一個網頁訪問另一個頁面存儲的信息，而不必把所有的邏輯[QWizard](qwizard.html)或具有明確的頁面了解對方。 If _name_帶星號結尾（`*`），該字段是必填字段。當一個頁面有必填字段中，**Next**和/或**Finish**按鈕被激活，只有當所有必填字段被填充。這需要_changedSignal_被指定的，告訴[QWizard](qwizard.html)重新檢查的必填字段存儲的值。 [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) | 您可以使用[QWizard.setDefaultProperty](qwizard.html#setDefaultProperty)（）將條目添加到該表或復蓋現有條目。考慮現場“裝” ，[QWizard](qwizard.html)簡單地檢查他們的當前值不等于其原始值（它們之前所擁有的價值[initializePage](qwizardpage.html#initializePage)（）被調用）。為[QLineEdit](qlineedit.html)，它還會檢查[hasAcceptableInput()](qlineedit.html#acceptableInput-prop)返回True ，兌現任何驗證或面具。 [QWizard](qwizard.html)提供方便的必填字段機制。它可以通過重新實現被繞過[QWizardPage.isComplete](qwizardpage.html#isComplete)（）。 **See also** [field](qwizardpage.html#field)（）[setField](qwizardpage.html#setField)（）和[QWizard.setDefaultProperty](qwizard.html#setDefaultProperty)（）。 ``` QWizardPage.registerField (self, QString?name, QWidget?widget, str?property?=?None, SIGNAL()?changedSignal?=?0) ``` ``` QWizardPage.setButtonText (self, QWizard.WizardButton?which, QString?text) ``` 按鈕設置文本_which_要_text_此頁面上。默認情況下，按鈕上的文本取決于[QWizard.wizardStyle](qwizard.html#wizardStyle-prop)，而是可以被重新定義為向導如使用整體[QWizard.setButtonText](qwizard.html#setButtonText)（）。 **See also** [buttonText](qwizardpage.html#buttonText)（）[QWizard.setButtonText](qwizard.html#setButtonText)（）和[QWizard.buttonText](qwizard.html#buttonText)（）。 ``` QWizardPage.setCommitPage (self, bool?commitPage) ``` 設置這個頁面是一個提交頁面，如果_commitPage_為True，否則，設置它是一個正常的頁面。一個提交頁面是代表它無法通過單擊撤消的操作頁面**Back** or **Cancel**。 A **Commit**按鈕取代了**Next**提交頁面上按鈕。點擊這個按鈕簡單地調用[QWizard.next](qwizard.html#next)（）就像點擊**Next**一樣。直接提交頁面中輸入一個頁面都有它**Back**按鈕禁用。 **See also** [isCommitPage](qwizardpage.html#isCommitPage)（）。 ``` QWizardPage.setField (self, QString?name, QVariant?value) ``` 設置字段中稱為值_name_至_value_。此功能可用于在向導的任何頁面上設置的字段。這等同于調用[wizard](qwizardpage.html#wizard)（） - \u003e[setField(_name_, _value_)](qwizard.html#setField)。 **See also** [QWizard.setField](qwizard.html#setField)（）[field](qwizardpage.html#field)（）和[registerField](qwizardpage.html#registerField)（）。 ``` QWizardPage.setFinalPage (self, bool?finalPage) ``` 顯式設置此頁面是最終的，如果_finalPage_是真實的。調用setFinalPage （真）后，[isFinalPage](qwizardpage.html#isFinalPage)（）返回True，并且**Finish**按鈕是可見的（如果啟用[isComplete](qwizardpage.html#isComplete)（）返回True ）。調用setFinalPage （假）后，[isFinalPage](qwizardpage.html#isFinalPage)（）返回True ，如果[nextId](qwizardpage.html#nextId)（）返回-1 ，否則返回False 。 **See also** [isFinalPage](qwizardpage.html#isFinalPage)（）[isComplete](qwizardpage.html#isComplete)（）和[QWizard.HaveFinishButtonOnEarlyPages](qwizard.html#WizardOption-enum)。 ``` QWizardPage.setPixmap (self, QWizard.WizardPixmap?which, QPixmap?pixmap) ``` 設置像素圖的作用_which_至_pixmap_。該像素圖所使用的[QWizard](qwizard.html)顯示一個頁面時。其中像素圖實際使用依賴于[wizard style](qwizard.html#wizard-look-and-feel)。像素圖，也可以使用整個向導設置[QWizard.setPixmap](qwizard.html#setPixmap)（），在這種情況下，他們申請不指定像素圖的所有頁面。 **See also** [pixmap](qwizardpage.html#pixmap)（）[QWizard.setPixmap](qwizard.html#setPixmap)（）和[Elements of a Wizard Page](qwizard.html#elements-of-a-wizard-page)。 ``` QWizardPage.setSubTitle (self, QString?subTitle) ``` ``` QWizardPage.setTitle (self, QString?title) ``` ``` QString QWizardPage.subTitle (self) ``` ``` QString QWizardPage.title (self) ``` ``` bool QWizardPage.validatePage (self) ``` 這個虛函數被調用[QWizard.validateCurrentPage](qwizard.html#validateCurrentPage)（）當用戶點擊**Next** or **Finish**執行一些最后一分鐘的驗證。如果返回True，則下一個頁面顯示（或向導完成），否則，在當前頁面熬夜。默認實現返回True 。如果可能的話，它通常是更好的風格禁用**Next** or **Finish**按鈕（通過指定[mandatory fields](qwizard.html#mandatory-fields)或者重新實現[isComplete](qwizardpage.html#isComplete)（）），而不是重新實現validatePage （）。 **See also** [QWizard.validateCurrentPage](qwizard.html#validateCurrentPage)（）和[isComplete](qwizardpage.html#isComplete)（）。 ``` QWizard QWizardPage.wizard (self) ``` [](qwizard.html) [返回與此頁面，或0相關的向導，如果這個頁面沒有被插入](qwizard.html)[QWizard](qwizard.html)還沒有。 **See also** [QWizard.addPage](qwizard.html#addPage)（）和[QWizard.setPage](qwizard.html#setPage)（）。 * * * ## Qt Signal Documentation ``` void completeChanged () ``` 這是該信號的默認超載。這個信號被發射時的頁面（即，值的完整狀態[isComplete](qwizardpage.html#isComplete)（））的變化。如果你重新實現[isComplete](qwizardpage.html#isComplete)（），一定要發出completeChanged （）時的值[isComplete](qwizardpage.html#isComplete)（）的變化，以確保[QWizard](qwizard.html)更新其按鈕的啟用或禁用狀態。 **See also** [isComplete](qwizardpage.html#isComplete)（）。