QStackedWidget Class Reference · PyQt4 中文文檔

# QStackedWidget Class Reference ## [[QtGui](index.htm) module] 該QStackedWidget類提供了一個堆疊部件，其中只有一個小部件是可見的時間的。[More...](#details) 繼承[QFrame](qframe.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int addWidget (self, QWidget?w)` * `int count (self)` * `int currentIndex (self)` * `QWidget currentWidget (self)` * `bool event (self, QEvent?e)` * `int indexOf (self, QWidget)` * `int insertWidget (self, int?index, QWidget?w)` * `removeWidget (self, QWidget?w)` * `setCurrentIndex (self, int?index)` * `setCurrentWidget (self, QWidget?w)` * `QWidget widget (self, int)` ### Special Methods * `__len__ (self)` ### Qt Signals * `void currentChanged (int)` * `void widgetRemoved (int)` * * * ## Detailed Description 該QStackedWidget類提供了一個堆疊部件，其中只有一個小部件是可見的時間的。 QStackedWidget可以用來創建類似于通過提供一個用戶接口[QTabWidget](qtabwidget.html)。它是建立在頂部的便利布局小部件[QStackedLayout](qstackedlayout.html)類。喜歡[QStackedLayout](qstackedlayout.html)， QStackedWidget可以構造并填充了一系列子控件（ “頁” ）中： ``` [QWidget](qwidget.html) *firstPageWidget = new [QWidget](qwidget.html); [QWidget](qwidget.html) *secondPageWidget = new [QWidget](qwidget.html); [QWidget](qwidget.html) *thirdPageWidget = new [QWidget](qwidget.html); QStackedWidget *stackedWidget = new QStackedWidget; stackedWidget->addWidget(firstPageWidget); stackedWidget->addWidget(secondPageWidget); stackedWidget->addWidget(thirdPageWidget); [QVBoxLayout](qvboxlayout.html) *layout = new [QVBoxLayout](qvboxlayout.html); layout->addWidget(stackedWidget); setLayout(layout); ``` QStackedWidget沒有提供內在的手段來切換頁面的用戶。這通常是通過做[QComboBox](qcombobox.html)或[QListWidget](qlistwidget.html)用于存儲QStackedWidget的頁面的標題。例如： ``` [QComboBox](qcombobox.html) *pageComboBox = new [QComboBox](qcombobox.html); pageComboBox->addItem(tr("Page 1")); pageComboBox->addItem(tr("Page 2")); pageComboBox->addItem(tr("Page 3")); connect(pageComboBox, SIGNAL(activated(int)), stackedWidget, SLOT(setCurrentIndex(int))); ``` 當填充堆疊部件，該部件被添加到內部列表。該[indexOf](qstackedwidget.html#indexOf)（）函數返回在該列表中一個部件的指標。窗口小部件可以被使用添加到該列表的末尾的[addWidget](qstackedwidget.html#addWidget)（）函數，或者使用插入一個給定索引處的[insertWidget](qstackedwidget.html#insertWidget)（）函數。該[removeWidget](qstackedwidget.html#removeWidget)（）函數會移除堆疊部件一個部件。包含在堆疊部件的部件的數量，可使用所獲得的[count](qstackedwidget.html#count-prop)（）函數。該[widget](qstackedwidget.html#widget)（）函數返回的部件在給定的索引位置。這顯示在屏幕上的小部件的指數由下式給出[currentIndex](qstackedwidget.html#currentIndex-prop)（），并且可以使用被改變[setCurrentIndex](qstackedwidget.html#currentIndex-prop)（）。以類似的方式，將當前顯示的窗口小部件可以使用被檢索的[currentWidget](qstackedwidget.html#currentWidget)（）函數，并使用改變了[setCurrentWidget](qstackedwidget.html#setCurrentWidget)（）函數。每當當前部件的疊層部件的改變或一個部件被從堆疊的部件移除時，[currentChanged](qstackedwidget.html#currentChanged)（）和[widgetRemoved](qstackedwidget.html#widgetRemoved)（）信號被分別發射。 * * * ## Method Documentation ``` QStackedWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QStackedWidget](qstackedwidget.html)用給定的_parent_。 **See also** [addWidget](qstackedwidget.html#addWidget)（）和[insertWidget](qstackedwidget.html#insertWidget)（）。 ``` int QStackedWidget.addWidget (self, QWidget?w) ``` 該_w_說法有它的所有權轉移給Qt的。添加給定的_widget_到[QStackedWidget](qstackedwidget.html)并返回索引位置。所有權_widget_到傳遞[QStackedWidget](qstackedwidget.html)。如果[QStackedWidget](qstackedwidget.html)為空，此函數被調用之前，_widget_成為當前窗口小部件。 **See also** [insertWidget](qstackedwidget.html#insertWidget)（）[removeWidget](qstackedwidget.html#removeWidget)（）和[setCurrentWidget](qstackedwidget.html#setCurrentWidget)（）。 ``` int QStackedWidget.count (self) ``` ``` int QStackedWidget.currentIndex (self) ``` ``` QWidget QStackedWidget.currentWidget (self) ``` [ 返回當前窗口小部件，或者0 ，如果沒有子控件。 ](qwidget.html) [**See also**](qwidget.html) [currentIndex](qstackedwidget.html#currentIndex-prop)（）和[setCurrentWidget](qstackedwidget.html#setCurrentWidget)（）。 ``` bool QStackedWidget.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` int QStackedWidget.indexOf (self, QWidget) ``` 返回給定索引_widget_，或-1，如果給定的_widget_不是的孩子[QStackedWidget](qstackedwidget.html)。 **See also** [currentIndex](qstackedwidget.html#currentIndex-prop)（）和[widget](qstackedwidget.html#widget)（）。 ``` int QStackedWidget.insertWidget (self, int?index, QWidget?w) ``` 該_w_說法有它的所有權轉移給Qt的。插入給定_widget_在給定的_index_在[QStackedWidget](qstackedwidget.html)。所有權_widget_到傳遞[QStackedWidget](qstackedwidget.html)。如果_index_超出范圍時，_widget_追加（在這種情況下，它是實際的指數_widget_即返回）。如果[QStackedWidget](qstackedwidget.html)為空，此函數被調用之前，給定的_widget_成為當前窗口小部件。插入一個新的widget指數小于或等于當前的索引處將增加當前索引，但保持當前的窗口小部件。 **See also** [addWidget](qstackedwidget.html#addWidget)（）[removeWidget](qstackedwidget.html#removeWidget)（）和[setCurrentWidget](qstackedwidget.html#setCurrentWidget)（）。 ``` QStackedWidget.removeWidget (self, QWidget?w) ``` 移除_widget_從[QStackedWidget](qstackedwidget.html)。即，_widget_ is _not_刪除，但簡單地從層疊布局除去，導致它被隱藏。 **Note:**所有權_widget_恢復到應用程序。 **See also** [addWidget](qstackedwidget.html#addWidget)（）[insertWidget](qstackedwidget.html#insertWidget)（）和[currentWidget](qstackedwidget.html#currentWidget)（）。 ``` QStackedWidget.setCurrentIndex (self, int?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentIndex(int)`。 ``` QStackedWidget.setCurrentWidget (self, QWidget?w) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentWidget(QWidget *)`。設置當前窗口小部件被指定_widget_。新的當前窗口小部件必須已經包含在這個堆疊部件。 **See also** [currentWidget](qstackedwidget.html#currentWidget)（）和[setCurrentIndex](qstackedwidget.html#currentIndex-prop)（）。 ``` QWidget QStackedWidget.widget (self, int) ``` [ 返回該插件在給定的_index_或0，如果不存在這樣的窗口小部件。 ](qwidget.html) [**See also**](qwidget.html) [currentWidget](qstackedwidget.html#currentWidget)（）和[indexOf](qstackedwidget.html#indexOf)（）。 ``` QStackedWidget.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void currentChanged (int) ``` 這是該信號的默認超載。這個信號被發射時的電流小窗口改變。該參數保存_index_新的當前窗口小部件，或者為-1 ，如果沒有一個新的（例如，如果沒有部件在[QStackedWidget](qstackedwidget.html)）。 **See also** [currentWidget](qstackedwidget.html#currentWidget)（）和[setCurrentWidget](qstackedwidget.html#setCurrentWidget)（）。 ``` void widgetRemoved (int) ``` 這是該信號的默認超載。每當一個部件被去除這個信號被發射。 widget的_index_作為參數傳遞。 **See also** [removeWidget](qstackedwidget.html#removeWidget)（）。