QSplitter Class Reference · PyQt4 中文文檔

# QSplitter Class Reference ## [[QtGui](index.htm) module] 該QSplitter類實現分離器部件。[More...](#details) 繼承[QFrame](qframe.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `__init__ (self, Qt.Orientation?orientation, QWidget?parent?=?None)` * `addWidget (self, QWidget?widget)` * `changeEvent (self, QEvent)` * `childEvent (self, QChildEvent)` * `bool childrenCollapsible (self)` * `int closestLegalPosition (self, int, int)` * `int count (self)` * `QSplitterHandle createHandle (self)` * `bool event (self, QEvent)` * `(int, int) getRange (self, int?index)` * `QSplitterHandle handle (self, int?index)` * `int handleWidth (self)` * `int indexOf (self, QWidget?w)` * `insertWidget (self, int?index, QWidget?widget)` * `bool isCollapsible (self, int?index)` * `QSize minimumSizeHint (self)` * `moveSplitter (self, int?pos, int?index)` * `bool opaqueResize (self)` * `Qt.Orientation orientation (self)` * `refresh (self)` * `resizeEvent (self, QResizeEvent)` * `bool restoreState (self, QByteArray?state)` * `QByteArray saveState (self)` * `setChildrenCollapsible (self, bool)` * `setCollapsible (self, int?index, bool)` * `setHandleWidth (self, int)` * `setOpaqueResize (self, bool?opaque?=?True)` * `setOrientation (self, Qt.Orientation)` * `setRubberBand (self, int?position)` * `setSizes (self, list-of-int?list)` * `setStretchFactor (self, int?index, int?stretch)` * `QSize sizeHint (self)` * `list-of-int sizes (self)` * `QWidget widget (self, int?index)` ### Special Methods * `__len__ (self)` ### Qt Signals * `void splitterMoved (int,int)` * * * ## Detailed Description 該QSplitter類實現分離器部件。分離器可以讓用戶通過拖動孩子們之間的邊界控制子控件的大小。任何數量的微件可以由單個分離器進行控制。典型的使用QSplitter的是創建了幾個小部件，并使用它們添加[insertWidget](qsplitter.html#insertWidget)（）或[addWidget](qsplitter.html#addWidget)（）。下面的例子將顯示一個[QListView](qlistview.html)，[QTreeView](qtreeview.html)和[QTextEdit](qtextedit.html)并排，有兩個分配器手柄： ``` QSplitter *splitter = new QSplitter(parent); [QListView](qlistview.html) *listview = new [QListView](qlistview.html); [QTreeView](qtreeview.html) *treeview = new [QTreeView](qtreeview.html); [QTextEdit](qtextedit.html) *textedit = new [QTextEdit](qtextedit.html); splitter->addWidget(listview); splitter->addWidget(treeview); splitter->addWidget(textedit); ``` 如果一個部件已經是一個QSplitter內部時，[insertWidget](qsplitter.html#insertWidget)（）或[addWidget](qsplitter.html#addWidget)（）被調用時，它會移動到新的位置。這可以用于以后重新排列在分離器的部件。您可以使用[indexOf](qsplitter.html#indexOf)（）[widget](qsplitter.html#widget)（）和[count](qsplitter.html#count)（）進入到分離器內的部件。默認QSplitter將其子水平（并排），你可以使用setOrientation （[Qt.Vertical](qt.html#Orientation-enum)）垂直放置其子出來。默認情況下，所有的widget可以大或小如用戶意愿之間的[minimumSizeHint](qsplitter.html#minimumSizeHint)（）（或[minimumSize](qwidget.html#minimumSize-prop)（））和[maximumSize](qwidget.html#maximumSize-prop)小部件（）。 QSplitter默認情況下，動態調整??其子。如果你寧愿QSplitter調整孩子只有在調整操作結束時，調用setOpaqueResize （假）。尺寸的小部件之間的初始分布是通過將初始大小與拉伸系數相乘確定。您也可以使用[setSizes](qsplitter.html#setSizes)（）來設置所有的部件的尺寸。該功能[sizes](qsplitter.html#sizes)（）返回由用戶設置的大小。或者，您可以保存和恢復窗口小部件的大小從[QByteArray](qbytearray.html) using [saveState](qsplitter.html#saveState)（）和[restoreState](qsplitter.html#restoreState)（）分別。當你[hide](qwidget.html#hide)（）一個子其空間將會是其他孩子分發。這將恢復當你[show](qwidget.html#show)（）一次。 * * * ## Method Documentation ``` QSplitter.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個水平拆分與_parent_傳遞給參數[QFrame](qframe.html)構造函數。 **See also** [setOrientation](qsplitter.html#orientation-prop)（）。 ``` QSplitter.__init__ (self, Qt.Orientation?orientation, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個分離器具有給定_orientation_和_parent_。 **See also** [setOrientation](qsplitter.html#orientation-prop)（）。 ``` QSplitter.addWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。將給定_widget_所有其他項目后分流器的布局。 If _widget_已經在分離器，將被移動到新的位置。 **See also** [insertWidget](qsplitter.html#insertWidget)（）[widget](qsplitter.html#widget)（）和[indexOf](qsplitter.html#indexOf)（）。 ``` QSplitter.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` QSplitter.childEvent (self, QChildEvent) ``` 從重新實現[QObject.childEvent](qobject.html#childEvent)（）。告訴孩子小部件描述的分配器_c_已經被插入或移除。這種方法也可以用來處理其中一個部件與所述分離器創建作為父母，但不與顯式添加的情況[insertWidget](qsplitter.html#insertWidget)（）或[addWidget](qsplitter.html#addWidget)（）。這是為了兼容而不是將小部件成新的代碼分離器的推薦方式。請使用[insertWidget](qsplitter.html#insertWidget)（）或[addWidget](qsplitter.html#addWidget)（）在新代碼。 **See also** [addWidget](qsplitter.html#addWidget)（）和[insertWidget](qsplitter.html#insertWidget)（）。 ``` bool QSplitter.childrenCollapsible (self) ``` ``` int QSplitter.closestLegalPosition (self, int, int) ``` 返回最接近的合法地位_pos_與索引窗口小部件的_index_。對于從右到左的語言，如阿拉伯語和希伯來語，水平分割的布局是相反的。位置然后從部件的右邊緣測量。 **See also** [getRange](qsplitter.html#getRange)（）。 ``` int QSplitter.count (self) ``` 返回包含在該分離器的布局的部件的數量。 **See also** [widget](qsplitter.html#widget)（）和[handle](qsplitter.html#handle)（）。 ``` QSplitterHandle QSplitter.createHandle (self) ``` [ 返回一個新的分流器句柄作為這個分配器的子部件。此功能可以在子類中重新實現來提供定制手柄的支持。 ](qsplitterhandle.html) [**See also**](qsplitterhandle.html) [handle](qsplitter.html#handle)（）和[indexOf](qsplitter.html#indexOf)（）。 ``` bool QSplitter.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` (int, int) QSplitter.getRange (self, int?index) ``` 返回索引分離器的有效范圍_index_在*_min_和*_max_如果_min_和_max_不為0。 ``` QSplitterHandle QSplitter.handle (self, int?index) ``` [ 在給定的返回句柄向左（或以上）在分離器的布局的項目_index_。索引為0的句柄總是隱藏。對于從右到左的語言，如阿拉伯語和希伯來語，水平分割的布局是相反的。手柄將是小部件的權于_index_。 ](qsplitterhandle.html) [**See also**](qsplitterhandle.html) [count](qsplitter.html#count)（）[widget](qsplitter.html#widget)（）[indexOf](qsplitter.html#indexOf)（）[createHandle](qsplitter.html#createHandle)（）和[setHandleWidth](qsplitter.html#handleWidth-prop)（）。 ``` int QSplitter.handleWidth (self) ``` ``` int QSplitter.indexOf (self, QWidget?w) ``` 返回索引中指定的分路器的布局_widget_。這也適用于手柄。手柄的編號從0 。因為有子控件居然有手柄，但手柄位置0永遠是隱藏的。 **See also** [count](qsplitter.html#count)（）和[widget](qsplitter.html#widget)（）。 ``` QSplitter.insertWidget (self, int?index, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。插入_widget_在給定的規定在分線器的布局_index_。 If _widget_已經在分離器，將被移動到新的位置。如果_index_是一個無效的索引，那么控件將被插入在最后。 **See also** [addWidget](qsplitter.html#addWidget)（）[indexOf](qsplitter.html#indexOf)（）和[widget](qsplitter.html#widget)（）。 ``` bool QSplitter.isCollapsible (self, int?index) ``` 返回True如果在部件_index_是可折疊的，否則返回False ``` QSize QSplitter.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（）。 ``` QSplitter.moveSplitter (self, int?pos, int?index) ``` 將分割器手柄的左邊緣或上邊緣處_index_盡可能靠近定位_pos_，它是從微件的左邊緣或上邊緣之間的距離。對于從右到左的語言，如阿拉伯語和希伯來語，水平分割的布局是相反的。_pos_然后，從部件的右邊緣之間的距離。 **See also** [splitterMoved](qsplitter.html#splitterMoved)（）[closestLegalPosition](qsplitter.html#closestLegalPosition)（）和[getRange](qsplitter.html#getRange)（）。 ``` bool QSplitter.opaqueResize (self) ``` ``` Qt.Orientation QSplitter.orientation (self) ``` [ ``` QSplitter.refresh (self) ``` 更新分路器的狀態。你不應該需要調用這個函數。 ``` QSplitter.resizeEvent (self, QResizeEvent) ``` ](qt.html#Orientation-enum) [從重新實現](qt.html#Orientation-enum)[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` bool QSplitter.restoreState (self, QByteArray?state) ``` 恢復分路器的布局到_state_規定。返回True如果狀態恢復，否則返回False 。通常，這是配合使用[QSettings](qsettings.html)從過去的會話還原大小。下面是一個例子：恢復分路器的狀態： ``` [QSettings](qsettings.html) settings; splitter->restoreState(settings.value("splitterSizes").toByteArray()); ``` 如果未能恢復分路器的布局可能會導致無效或外的最新數據所提供的字節數組中。 **See also** [saveState](qsplitter.html#saveState)（）。 ``` QByteArray QSplitter.saveState (self) ``` [ 保存分路器的布局的狀態。 ](qbytearray.html) [通常，這是配合使用](qbytearray.html)[QSettings](qsettings.html)要記住的大小為今后的會議。版本號碼被存儲作為數據的一部分。下面是一個例子： ``` [QSettings](qsettings.html) settings; settings.setValue("splitterSizes", splitter->saveState()); ``` **See also** [restoreState](qsplitter.html#restoreState)（）。 ``` QSplitter.setChildrenCollapsible (self, bool) ``` ``` QSplitter.setCollapsible (self, int?index, bool) ``` 設置是否在子構件索引_index_是可折疊_collapse_。默認情況下，孩子是可折疊的，這意味著用戶可以調整下來，大小為0 ，即使他們有一個非零[minimumSize](qwidget.html#minimumSize-prop)（）或[minimumSizeHint](qsplitter.html#minimumSizeHint)（）。這種行為可以基于每個插件基礎由通過設置在調用此函數，或全球范圍內為在分離器的所有部件被改變的[childrenCollapsible](qsplitter.html#childrenCollapsible-prop)屬性。 **See also** [isCollapsible](qsplitter.html#isCollapsible)（）和[childrenCollapsible](qsplitter.html#childrenCollapsible-prop)。 ``` QSplitter.setHandleWidth (self, int) ``` ``` QSplitter.setOpaqueResize (self, bool?opaque?=?True) ``` ``` QSplitter.setOrientation (self, Qt.Orientation) ``` ``` QSplitter.setRubberBand (self, int?position) ``` 顯示一個橡皮筋的位置_pos_。如果_pos_為負時，該橡膠帶被除去。 ``` QSplitter.setSizes (self, list-of-int?list) ``` 設置子控件的尺寸大小，以在給定的值_list_。如果分離器是水平的，該值設置每個插件的寬度以像素為單位，從左至右。如果分離器是垂直的，每個插件的高度被設置，從頂部到底部。在多馀的值_list_將被忽略。如果_list_包含的值太少，結果是不確定的，但程序仍然會表現良好。分配器部件的整體尺寸不會受到影響。相反，任何附加的/缺失的空間是按照體積的相對重量之間分配部件。如果指定大小為0 ，該部件將是不可見的。是小部件的大小策略保存。即，值越小則相應小窗口的最小尺寸暗示將由暗示的值來代替。 **See also** [sizes](qsplitter.html#sizes)（）。 ``` QSplitter.setStretchFactor (self, int?index, int?stretch) ``` 更新widget的大小政策在位置_index_以具有一個伸展因子_stretch_。 _stretch_是不實際的伸展系數;的有效伸長率是通過采取小窗口的初始大小，并將其與計算出的乘法_stretch_。此功能提供了方便。它相當于 ``` [QWidget](qwidget.html) *widget = splitter->widget(index); [QSizePolicy](qsizepolicy.html) policy = widget->sizePolicy(); policy.setHorizontalStretch(stretch); policy.setVerticalStretch(stretch); widget->setSizePolicy(policy); ``` **See also** [setSizes](qsplitter.html#setSizes)（）和[widget](qsplitter.html#widget)（）。 ``` QSize QSplitter.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` list-of-int QSplitter.sizes (self) ``` 返回此分路器的所有部件的尺寸參數列表。如果分離器的方向是水平的，該列表包含該部件的寬度以像素為單位，從左至右，如果方向是垂直的，該列表包含以像素為單位的窗口小部件的高度，從頂部到底部。給出的值到另一個分路器的[setSizes](qsplitter.html#setSizes)（）函數，會產生具有相同的布局，這其中一個分離器。需要注意的是看不見的小部件有大小為0 。 **See also** [setSizes](qsplitter.html#setSizes)（）。 ``` QWidget QSplitter.widget (self, int?index) ``` [ 返回該插件在給定的_index_在分離器的布局。 ](qwidget.html) [**See also**](qwidget.html) [count](qsplitter.html#count)（）[handle](qsplitter.html#handle)（）[indexOf](qsplitter.html#indexOf)（）和[insertWidget](qsplitter.html#insertWidget)（）。 ``` QSplitter.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void splitterMoved (int,int) ``` 這是該信號的默認超載。這個信號被發射時，分離器處理在一個特定的_index_已經被移動到位置_pos_。對于從右到左的語言，如阿拉伯語和希伯來語，水平分割的布局是相反的。_pos_然后，從部件的右邊緣之間的距離。 **See also** [moveSplitter](qsplitter.html#moveSplitter)（）。