# QSplitterHandle Class Reference ## [[QtGui](index.htm) module] 該QSplitterHandle類提供??處理分離器的功能。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Methods * `__init__ (self, Qt.Orientation?o, QSplitter?parent)` * `int closestLegalPosition (self, int?p)` * `bool event (self, QEvent)` * `mouseMoveEvent (self, QMouseEvent)` * `mousePressEvent (self, QMouseEvent)` * `mouseReleaseEvent (self, QMouseEvent)` * `moveSplitter (self, int?p)` * `bool opaqueResize (self)` * `Qt.Orientation orientation (self)` * `paintEvent (self, QPaintEvent)` * `resizeEvent (self, QResizeEvent)` * `setOrientation (self, Qt.Orientation?o)` * `QSize sizeHint (self)` * `QSplitter splitter (self)` * * * ## Detailed Description 該QSplitterHandle類提供??處理分離器的功能。 QSplitterHandle通常人們所認為的，當他們想到一個分離器。它是用于調整大小的窗口小部件的把手。 用一個典型的開發[QSplitter](qsplitter.html)永遠不用擔心QSplitterHandle 。提供它是為了誰想要分配器手柄，提供額外的功能，如彈出式菜單的開發。 典型的方法之一將創造分配器手柄是子類化[QSplitter](qsplitter.html)然后重新實現[QSplitter.createHandle](qsplitter.html#createHandle)（ ）實例化自定義的分配器手柄。例如，最小[QSplitter](qsplitter.html)子類可能看起來像這樣： ``` class Splitter : public [QSplitter](qsplitter.html) { public: Splitter([Qt](qt.html).Orientation orientation, [QWidget](qwidget.html) *parent = 0); protected: QSplitterHandle *createHandle(); }; ``` 該[createHandle()](qsplitter.html#createHandle)實現簡單地構造了一個自定義的分配器手柄，稱為`Splitter`在這個例子中： ``` QSplitterHandle *Splitter.createHandle() { return new SplitterHandle(orientation(), this); } ``` 對一個給定的句柄信息可以使用類似的功能來獲得[orientation](qsplitterhandle.html#orientation)（）和[opaqueResize](qsplitterhandle.html#opaqueResize)（） ，并從它的父分離器檢索。像這些細節可以用來給定制處理不同的外觀取決于分離器的方向。 該自定義手柄子類的復雜性取決于它需要執行的任務。一個簡單的子類可能只提供一個[paintEvent](qsplitterhandle.html#paintEvent)（）實現： ``` void SplitterHandle.paintEvent([QPaintEvent](qpaintevent.html) *event) { [QPainter](qpainter.html) painter(this); if (orientation() == [Qt](qt.html).Horizontal) { gradient.setStart(rect().left(), rect().height()/2); gradient.setFinalStop(rect().right(), rect().height()/2); } else { gradient.setStart(rect().width()/2, rect().top()); gradient.setFinalStop(rect().width()/2, rect().bottom()); } painter.fillRect(event->rect(), [QBrush](qbrush.html)(gradient)); } ``` 在該示例中，預定義的梯度設置不同，這取決于手柄的方向。 QSplitterHandle提供了一個合理的尺寸暗示的手柄，所以子類并不需要提供一個重新實現[sizeHint](qsplitterhandle.html#sizeHint)（ ），除非手柄有特殊尺寸要求。 * * * ## Method Documentation ``` QSplitterHandle.__init__ (self, Qt.Orientation?o, QSplitter?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 創建[QSplitter](qsplitter.html)用給定的處理_orientation_和[QSplitter](qsplitter.html) _parent_。 ``` int QSplitterHandle.closestLegalPosition (self, int?p) ``` 返回最接近的合法地位_pos_的分路器手柄。該位置從分離器的左邊或頂邊測量，即使是從右到左的語言。 **See also** [QSplitter.closestLegalPosition](qsplitter.html#closestLegalPosition)（）和[moveSplitter](qsplitterhandle.html#moveSplitter)（ ） 。 ``` bool QSplitterHandle.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QSplitterHandle.mouseMoveEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（ ） 。 ``` QSplitterHandle.mousePressEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QSplitterHandle.mouseReleaseEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（ ） 。 ``` QSplitterHandle.moveSplitter (self, int?p) ``` 告訴分路器來移動該句柄來定位_pos_，它是從微件的左邊緣或上邊緣之間的距離。 需要注意的是_pos_也從左側（或頂部）測量從右到左的語言。這個函數將映射_pos_調用前的適當位置[QSplitter.moveSplitter](qsplitter.html#moveSplitter)（ ） 。 **See also** [QSplitter.moveSplitter](qsplitter.html#moveSplitter)（）和[closestLegalPosition](qsplitterhandle.html#closestLegalPosition)（ ） 。 ``` bool QSplitterHandle.opaqueResize (self) ``` 返回True如果部件是動態調整大小（不透明） ，否則返回False 。這個值是由控制[QSplitter](qsplitter.html)。 **See also** [QSplitter.opaqueResize](qsplitter.html#opaqueResize-prop)（ ） 。 ``` Qt.Orientation QSplitterHandle.orientation (self) ``` [](qt.html#Orientation-enum) [返回手柄的方向。這通常是由傳播](qt.html#Orientation-enum)[QSplitter](qsplitter.html)。 **See also** [setOrientation](qsplitterhandle.html#setOrientation)（）和[QSplitter.orientation](qsplitter.html#orientation-prop)（ ） 。 ``` QSplitterHandle.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QSplitterHandle.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QSplitterHandle.setOrientation (self, Qt.Orientation?o) ``` 設置分離器手柄的方向向_orientation_。這通常是由傳播[QSplitter](qsplitter.html)。 **See also** [orientation](qsplitterhandle.html#orientation)（）和[QSplitter.setOrientation](qsplitter.html#orientation-prop)（ ） 。 ``` QSize QSplitterHandle.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QSplitter QSplitterHandle.splitter (self) ``` [ 返回與此分路器句柄相關聯的分離器。 ](qsplitter.html) [**See also**](qsplitter.html) [QSplitter.handle](qsplitter.html#handle)（ ） 。