# QRegion Class Reference ## [[QtGui](index.htm) module] 該QRegion類指定一個畫家的剪輯區域。[More...](#details) ### Types * `enum RegionType { Rectangle, Ellipse }` ### Methods * `__init__ (self)` * `__init__ (self, int?x, int?y, int?w, int?h, RegionType?type?=?QRegion.Rectangle)` * `__init__ (self, QRect?r, RegionType?type?=?QRegion.Rectangle)` * `__init__ (self, QPolygon?a, Qt.FillRule?fillRule?=?Qt.OddEvenFill)` * `__init__ (self, QBitmap?bitmap)` * `__init__ (self, QRegion?region)` * `__init__ (self, QVariant?variant)` * `QRect boundingRect (self)` * `bool contains (self, QPoint?p)` * `bool contains (self, QRect?r)` * `QRegion eor (self, QRegion?r)` * `QRegion intersect (self, QRegion?r)` * `QRegion intersected (self, QRegion?r)` * `QRegion intersected (self, QRect?r)` * `bool intersects (self, QRegion?r)` * `bool intersects (self, QRect?r)` * `bool isEmpty (self)` * `int numRects (self)` * `int rectCount (self)` * `list-of-QRect rects (self)` * `QRegion subtract (self, QRegion?r)` * `QRegion subtracted (self, QRegion?r)` * `swap (self, QRegion?other)` * `translate (self, int?dx, int?dy)` * `translate (self, QPoint?p)` * `QRegion translated (self, int?dx, int?dy)` * `QRegion translated (self, QPoint?p)` * `QRegion unite (self, QRegion?r)` * `QRegion united (self, QRegion?r)` * `QRegion united (self, QRect?r)` * `QRegion xored (self, QRegion?r)` ### Special Methods * `QRegion __add__ (self, QRegion?r)` * `QRegion __add__ (self, QRect?r)` * `QRegion __and__ (self, QRegion?r)` * `QRegion __and__ (self, QRect?r)` * `int __bool__ (self)` * `int __contains__ (self, QPoint?p)` * `int __contains__ (self, QRect?r)` * `bool __eq__ (self, QRegion?r)` * `QRegion __iadd__ (self, QRegion?r)` * `QRegion __iadd__ (self, QRect?r)` * `QRegion __iand__ (self, QRegion?r)` * `QRegion __iand__ (self, QRect?r)` * `QRegion __ior__ (self, QRegion?r)` * `QRegion __isub__ (self, QRegion?r)` * `QRegion __ixor__ (self, QRegion?r)` * `QRegion __mul__ (self, QMatrix?m)` * `QRegion __mul__ (self, QTransform?m)` * `bool __ne__ (self, QRegion?r)` * `QRegion __or__ (self, QRegion?r)` * `QRegion __sub__ (self, QRegion?r)` * `QRegion __xor__ (self, QRegion?r)` * * * ## Detailed Description 該QRegion類指定一個畫家的剪輯區域。 QRegion一起使用[QPainter.setClipRegion](qpainter.html#setClipRegion)（ ），以限制油漆區，以什么需要上漆。還有一個[QWidget.repaint](qwidget.html#repaint)（ ）函數，它接受一個QRegion參數。 QRegion對于減少屏幕區域由一個重繪更新量的最佳工具。 這個類是不適合于構建形狀呈現，尤其是作為輪廓。使用[QPainterPath](qpainterpath.html)創建路徑和形狀與使用[QPainter](qpainter.html)。 QRegion是[implicitly shared](index.htm#implicitly-shared)類。 ### Creating and Using Regions 一個區域可以由一個矩形，橢圓形，多邊形或一個位圖被創建。復雜區域可以通過結合簡單的使用區域來創建[united](qregion.html#united)（ ）[intersected](qregion.html#intersected)（ ）[subtracted](qregion.html#subtracted)（） ，或[xored](qregion.html#xored)（） （異或） 。您可以使用移動區域[translate](qregion.html#translate)（ ） 。 您可以測試是否一個區域[isEmpty](qregion.html#isEmpty)（） ，或者如果它[contains](qregion.html#contains)（ ）一[QPoint](qpoint.html) or [QRect](qrect.html)。該邊框可以找到[boundingRect](qregion.html#boundingRect)（ ） 。 該功能[rects](qregion.html#rects)（）給出的區域的分解成矩形。 使用復雜的區域的例子： ``` void MyWidget.paintEvent([QPaintEvent](qpaintevent.html) *) { QRegion r1([QRect](qrect.html)(100, 100, 200, 80), // r1: elliptic region QRegion.Ellipse); QRegion r2([QRect](qrect.html)(100, 120, 90, 30)); // r2: rectangular region QRegion r3 = r1.intersected(r2); // r3: intersection [QPainter](qpainter.html) painter(this); painter.setClipRegion(r3); ... // paint clipped graphics } ``` ### Additional License Information 在嵌入式Linux ， Windows CE和X11平臺上，這個類的部分依靠以以下授權協議獲得的代碼： 版權所有（c ）1987 X聯盟 特此免費授予的，對任何獲得本軟件副本及相關文檔文件（ “軟件” ） ，以處理本軟件不受任何限制，包括但不限于使用權，復制，修改，合并，發布，分發，再許可和/或銷售軟件副本，并允許他人為之軟體家具是這樣做的，須符合下列條件： 上述版權聲明和本許可聲明應包含在所有的副本或實質性部分的軟件。 本軟件按“原樣”，沒有任何形式的擔保，明示或默示的擔保，包括但不限于適銷性，適用于特定用途和非侵權的保證。在任何情況下X聯盟承擔任何索賠，損害賠償或其他責任，無論是合同行為，侵權行為或其他原因所產生的，運出或與本軟件或使用，或軟件中的其他交易。 除本通知所載， X聯盟的名稱不得用于廣告或其他方式來促進銷售，使用或本軟件中的其他交易未經X聯盟事先書面授權。 版權所有1987年由數字設備公司，梅納德，馬薩諸塞。 保留所有權利 許可使用，復制，修改和分發本軟件及其文檔的任何目的免費特此授予，前提是上述版權聲明出現在所有副本中，并且兩種版權聲明和本許可聲明出現在支持文檔，并且在廣告或宣傳有關軟件分發沒有具體的不能用數字的名稱，事先書面許可。 DIGITAL聲明不提供本軟件有關，包括對適銷性和適用性的所有默示保證，在任何情況下數字都不對任何特殊，間接或后果性損害或任何損害因無法使用，數據丟失或利潤，無論是在動作的合同，疏忽或其它侵權行為，所產生的或與本軟件的使用或性能。 * * * ## Type Documentation ``` QRegion.RegionType ``` 指定區域的要創建的形狀。 | Constant | Value | Description | | --- | --- | --- | | `QRegion.Rectangle` | `0` | 該區域復蓋了整個矩形。 | | `QRegion.Ellipse` | `1` | 該區域是在矩形內的橢圓形。 | * * * ## Method Documentation ``` QRegion.__init__ (self) ``` 構造一個空區域。 **See also** [isEmpty](qregion.html#isEmpty)（ ） 。 ``` QRegion.__init__ (self, int?x, int?y, int?w, int?h, RegionType?type?=?QRegion.Rectangle) ``` 構造一個矩形或橢圓形區域。 If _t_ is `Rectangle`的區域是填充矩形（_x_，_y_，_w_，_h_） 。如果_t_ is `Ellipse`，該地區是充滿橢圓與中心（_x_+_w_/ 2，_y_+_h_/ 2）和尺寸（_w_，_h_） 。 ``` QRegion.__init__ (self, QRect?r, RegionType?type?=?QRegion.Rectangle) ``` 從點陣列構造一個多邊形區域_a_由指定的填充規則_fillRule_。 If _fillRule_ is [Qt.WindingFill](qt.html#FillRule-enum)，多邊形區域是使用捲繞算法中定義，如果是[Qt.OddEvenFill](qt.html#FillRule-enum)，奇偶填充算法被使用。 **Warning:**這個構造函數可以用來創建復雜的地區使用時，將減緩畫。 ``` QRegion.__init__ (self, QPolygon?a, Qt.FillRule?fillRule?=?Qt.OddEvenFill) ``` ``` QRegion.__init__ (self, QBitmap?bitmap) ``` 構造一個新的區域，它等于區域_r_。 ``` QRegion.__init__ (self, QRegion?region) ``` 從位圖構造一個區域_bm_。 所得到的區域由以位圖的像素的_bm_是[Qt.color1](qt.html#GlobalColor-enum)，好像每個像素是一個1×1的矩形。 這個構造函數可以創建復雜的地區使用時，將減緩畫。請注意，繪圖蒙面像素映射可以做到更快使用[QPixmap.setMask](qpixmap.html#setMask)（ ） 。 ``` QRegion.__init__ (self, QVariant?variant) ``` 這是一個重載函數。 創建基于rectange區域_r_與區域類型_t_。 如果矩形是無效的空區域將被創建。 **See also** [QRegion.RegionType](qregion.html#RegionType-enum)。 ``` QRect QRegion.boundingRect (self) ``` [](qrect.html) [返回此區域的邊界矩形。一個空的區域給出了一個矩形，它是](qrect.html)[QRect.isNull](qrect.html#isNull)（ ） 。 ``` bool QRegion.contains (self, QPoint?p) ``` 如果該區域包含該點，則返回True_p_否則返回False 。 ``` bool QRegion.contains (self, QRect?r) ``` 這是一個重載函數。 如果該區域的矩形重疊，則返回True_r_否則返回False 。 ``` QRegion QRegion.eor (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.intersect (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.intersected (self, QRegion?r) ``` [ 返回作為此區域的交集和地區_r_。  該圖顯示了兩個橢圓區域的交界處。 這個函數中引入了Qt 4.2中。 ](qregion.html) [**See also**](qregion.html) [subtracted](qregion.html#subtracted)（ ）[united](qregion.html#united)（）和[xored](qregion.html#xored)（ ） 。 ``` QRegion QRegion.intersected (self, QRect?r) ``` [ 返回作為此區域的交集和給定的區域_rect_。 此功能被引入Qt的4.4 。 ](qregion.html) [**See also**](qregion.html) [subtracted](qregion.html#subtracted)（ ）[united](qregion.html#united)（）和[xored](qregion.html#xored)（ ） 。 ``` bool QRegion.intersects (self, QRegion?r) ``` 如果這個區域相交，則返回True_region_，否則返回False 。 這個函數中引入了Qt 4.2中。 ``` bool QRegion.intersects (self, QRect?r) ``` 如果這個區域相交，則返回True_rect_，否則返回False 。 這個函數中引入了Qt 4.2中。 ``` bool QRegion.isEmpty (self) ``` 返回True如果該區域為空，否則返回False 。空白區是一個不包含任何點的區域中。 例如： ``` [QRegion](qregion.html) r1(10, 10, 20, 20); r1.isEmpty(); // false [QRegion](qregion.html) r3; r3.isEmpty(); // true [QRegion](qregion.html) r2(40, 40, 20, 20); r3 = r1.intersected(r2); // r3: intersection of r1 and r2 r3.isEmpty(); // true r3 = r1.united(r2); // r3: union of r1 and r2 r3.isEmpty(); // false ``` ``` int QRegion.numRects (self) ``` ``` int QRegion.rectCount (self) ``` 返回將在返回矩形數[rects](qregion.html#rects)（ ） 。 此功能被引入Qt的4.6 。 ``` list-of-QRect QRegion.rects (self) ``` 返回非重疊的矩形組成區域的數組。 所有矩形的并集等于原來的區域。 **See also** [setRects](qregion.html#setRects)（ ） 。 ``` QRegion QRegion.subtract (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.subtracted (self, QRegion?r) ``` [ 返回其是區域_r_減去這一地區。  圖中示出了結果，當在右側的橢圓是從左側的橢圓（減去`left - right`） 。 這個函數中引入了Qt 4.2中。 ](qregion.html) [**See also**](qregion.html) [intersected](qregion.html#intersected)（ ）[united](qregion.html#united)（）和[xored](qregion.html#xored)（ ） 。 ``` QRegion.swap (self, QRegion?other) ``` 交換區_other_與這一地區。這個操作是非常快的，而且永遠不會。 此功能被引入Qt的4.8 。 ``` QRegion.translate (self, int?dx, int?dy) ``` 平移（移動）的區域_dx_沿X軸和_dy_沿著Y軸。 ``` QRegion.translate (self, QPoint?p) ``` 這是一個重載函數。 轉譯區_point__.x()_沿x軸和_point__.y()_沿著y軸，相對于當前位置。正值移動的區域向右和向下。 轉換為給定的_point_。 ``` QRegion QRegion.translated (self, int?dx, int?dy) ``` [ 返回區域的一個副本被翻譯_dx_沿x軸和_dy_沿著y軸，相對于當前位置。正值移動的區域向右和向下。 這個函數是Qt 4.1中引入。 ](qregion.html) [**See also**](qregion.html) [translate](qregion.html#translate)（ ） 。 ``` QRegion QRegion.translated (self, QPoint?p) ``` [ 這是一個重載函數。 返回regtion的副本翻譯_p__.x()_沿x軸和_p__.y()_沿著y軸，相對于當前位置。正值移動矩形向右和向下。 這個函數是Qt 4.1中引入。 ](qregion.html) [**See also**](qregion.html) [translate](qregion.html#translate)（ ） 。 ``` QRegion QRegion.unite (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.united (self, QRegion?r) ``` [ 返回作為此區域的和工會的區域_r_。  該圖顯示了兩個橢圓區域的聯合。 這個函數中引入了Qt 4.2中。 ](qregion.html) [**See also**](qregion.html) [intersected](qregion.html#intersected)（ ）[subtracted](qregion.html#subtracted)（）和[xored](qregion.html#xored)（ ） 。 ``` QRegion QRegion.united (self, QRect?r) ``` [ 返回作為此區域的和工會給定一個區域_rect_。 此功能被引入Qt的4.4 。 ](qregion.html) [**See also**](qregion.html) [intersected](qregion.html#intersected)（ ）[subtracted](qregion.html#subtracted)（）和[xored](qregion.html#xored)（ ） 。 ``` QRegion QRegion.xored (self, QRegion?r) ``` [ 返回作為此區域的異或（ XOR）和一個區_r_。  該圖顯示了專用的兩個橢圓區域或。 這個函數中引入了Qt 4.2中。 ](qregion.html) [**See also**](qregion.html) [intersected](qregion.html#intersected)（ ）[united](qregion.html#united)（）和[subtracted](qregion.html#subtracted)（ ） 。 ``` QRegion QRegion.__add__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__add__ (self, QRect?r) ``` [](qregion.html) ``` QRegion QRegion.__and__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__and__ (self, QRect?r) ``` [ ``` int QRegion.__bool__ (self) ``` ``` int QRegion.__contains__ (self, QPoint?p) ``` ``` int QRegion.__contains__ (self, QRect?r) ``` ``` bool QRegion.__eq__ (self, QRegion?r) ``` ](qregion.html) ``` QRegion QRegion.__iadd__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__iadd__ (self, QRect?r) ``` [](qregion.html) ``` QRegion QRegion.__iand__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__iand__ (self, QRect?r) ``` [](qregion.html) ``` QRegion QRegion.__ior__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__isub__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__ixor__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__mul__ (self, QMatrix?m) ``` [](qregion.html) ``` QRegion QRegion.__mul__ (self, QTransform?m) ``` [ ``` bool QRegion.__ne__ (self, QRegion?r) ``` ](qregion.html) ``` QRegion QRegion.__or__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__sub__ (self, QRegion?r) ``` [](qregion.html) ``` QRegion QRegion.__xor__ (self, QRegion?r) ``` [](qregion.html)