QRubberBand Class Reference · PyQt4 中文文檔

# QRubberBand Class Reference ## [[QtGui](index.htm) module] 該QRubberBand類提供了一個矩形或線條，可以顯示一個選擇或邊界。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum Shape { Line, Rectangle }` ### Methods * `__init__ (self, Shape, QWidget?parent?=?None)` * `changeEvent (self, QEvent)` * `bool event (self, QEvent?e)` * `initStyleOption (self, QStyleOptionRubberBand?option)` * `move (self, QPoint?p)` * `move (self, int?ax, int?ay)` * `moveEvent (self, QMoveEvent)` * `paintEvent (self, QPaintEvent)` * `resize (self, int?w, int?h)` * `resize (self, QSize?s)` * `resizeEvent (self, QResizeEvent)` * `setGeometry (self, QRect?r)` * `setGeometry (self, int?ax, int?ay, int?aw, int?ah)` * `Shape shape (self)` * `showEvent (self, QShowEvent)` * * * ## Detailed Description 該QRubberBand類提供了一個矩形或線條，可以顯示一個選擇或邊界。一種橡膠帶通常用來顯示一個新的邊界區域（如在一個[QSplitter](qsplitter.html)或[QDockWidget](qdockwidget.html)那是出塢）。歷史上使用這種已實施[QPainter](qpainter.html)和XOR ，但這種方法并不總是正確的，因為渲染可能發生在下面的橡皮筋??窗口工作，但橡皮筋之前已經被“抹掉” 。每當你需要渲染圍繞一個給定區域橡皮筋（或代表一行），你可以創建一個QRubberBand ，然后調用[setGeometry](qrubberband.html#setGeometry)（）[move](qrubberband.html#move)（）或[resize](qrubberband.html#resize)（）來定位并調整其大小。一個常見的模式是這樣做與鼠標事件一起使用。例如： ``` void Widget.mousePressEvent([QMouseEvent](qmouseevent.html) *event) { origin = event->pos(); if (!rubberBand) rubberBand = new QRubberBand(QRubberBand.Rectangle, this); rubberBand->setGeometry([QRect](qrect.html)(origin, [QSize](qsize.html)())); rubberBand->show(); } void Widget.mouseMoveEvent([QMouseEvent](qmouseevent.html) *event) { rubberBand->setGeometry([QRect](qrect.html)(origin, event->pos()).normalized()); } void Widget.mouseReleaseEvent([QMouseEvent](qmouseevent.html) *event) { rubberBand->hide(); // determine selection, for example using QRect.intersects() // and QRect.contains(). } ``` 如果你傳遞一個父QRubberBand的構造函數，橡皮筋將只顯示內部其父，但停留在其他的子控件的頂部。如果沒有父母傳遞， QRubberBand將作為一個頂級窗口部件。 Call [show](qwidget.html#show)（）以使橡膠帶清晰可見;也當橡膠帶不是頂層。隱藏或銷毀的部件將使得橡膠帶消失。橡膠帶可以是一個[Rectangle](qrubberband.html#Shape-enum)或[Line](qrubberband.html#Shape-enum)（垂直或水平），這取決于[shape](qrubberband.html#shape)（）獲給予該建造。 * * * ## Type Documentation ``` QRubberBand.Shape ``` 此枚舉指定什么形狀的[QRubberBand](qrubberband.html)應該有。這是向下傳遞到樣式系統的繪圖提示，并且可以由每個被解釋[QStyle](qstyle.html)。 | Constant | Value | Description | | --- | --- | --- | | `QRubberBand.Line` | `0` | A [QRubberBand](qrubberband.html)可以代表一個垂直或水平線。幾何中仍給予[rect](qwidget.html#rect-prop)（）而行，將填補在大多數款式給定的幾何形狀。 | | `QRubberBand.Rectangle` | `1` | A [QRubberBand](qrubberband.html)可以表示一個矩形。有些款式會將此解釋為填充（通常半透明）長方形或矩形輪廓。 | * * * ## Method Documentation ``` QRubberBand.__init__ (self, Shape, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造形狀的橡皮筋_s_，與父_p_。默認情況下，一個長方形的橡膠帶（_s_ is `Rectangle`）將使用的掩模，使該矩形的小邊界是所有可見。有些款式（例如，原生的Mac OS X ）將改變這一點，并調用[QWidget.setWindowOpacity](qwidget.html#windowOpacity-prop)（）方法使一個半透明填充選擇矩形。 ``` QRubberBand.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` bool QRubberBand.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QRubberBand.initStyleOption (self, QStyleOptionRubberBand?option) ``` 初始化_option_與其它的值[QRubberBand](qrubberband.html)。當他們需要一個這種方法是有用的子類[QStyleOptionRubberBand](qstyleoptionrubberband.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（）。 ``` QRubberBand.move (self, QPoint?p) ``` 移動橡皮筋到點（_x_，_y_）。 **See also** [resize](qrubberband.html#resize)（）。 ``` QRubberBand.move (self, int?ax, int?ay) ``` 這是一個重載函數。移動橡皮筋指向_p_。 **See also** [resize](qrubberband.html#resize)（）。 ``` QRubberBand.moveEvent (self, QMoveEvent) ``` 從重新實現[QWidget.moveEvent](qwidget.html#moveEvent)（）。 ``` QRubberBand.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` QRubberBand.resize (self, int?w, int?h) ``` 調整大小的橡皮筋??，使得其寬度為_width_，它的高度是_height_。 **See also** [move](qrubberband.html#move)（）。 ``` QRubberBand.resize (self, QSize?s) ``` 這是一個重載函數。調整大小的橡皮筋??，使新的大小是_size_。 **See also** [move](qrubberband.html#move)（）。 ``` QRubberBand.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QRubberBand.setGeometry (self, QRect?r) ``` 設置橡皮筋的幾何_rect_，它的父窗口部件的坐標系中指定。 **See also** [QWidget.geometry](qwidget.html#geometry-prop)。 ``` QRubberBand.setGeometry (self, int?ax, int?ay, int?aw, int?ah) ``` 這是一個重載函數。設置橡皮的幾何形狀，其左上角位于該點的矩形（_x_，_y_）中，用由指定的尺寸_width_和_height_。幾何體指定的父窗口部件的坐標系中。 ``` Shape QRubberBand.shape (self) ``` [ 返回此橡皮筋的形狀。形狀只能在構造設置。 ``` QRubberBand.showEvent (self, QShowEvent) ``` ](qrubberband.html#Shape-enum) [從重新實現](qrubberband.html#Shape-enum)[QWidget.showEvent](qwidget.html#showEvent)（）。