QRegion ¶

QRegion class specifies a clip region for a painter. 更多 …

概要 ¶

函数 ¶

def __add__ (r)
def __add__ (r)
def __and__ (r)
def __and__ (r)
def __eq__ (r)
def __iadd__ (r)
def __iadd__ (r)
def __ior__ (r)
def __isub__ (r)
def __ixor__ (r)
def __mul__ (, m)
def __mul__ (, m)
def __ne__ (r)
def __or__ (r)
def __sub__ (r)
def __xor__ (r)
def begin ()
def boundingRect ()
def cbegin ()
def cend ()
def contains (p)
def contains (r)
def end ()
def intersected (r)
def intersected (r)
def intersects (r)
def intersects (r)
def isEmpty ()
def isNull ()
def rectCount ()
def rects ()
def setRects (rect, num)
def subtracted (r)
def swap (other)
def translate (dx, dy)
def translate (p)
def translated (dx, dy)
def translated (p)
def united (r)
def united (r)
def xored (r)

详细描述 ¶

QRegion is used with setClipRegion() to limit the paint area to what needs to be painted. There is also a repaint() function that takes a QRegion 参数。 QRegion is the best tool for minimizing the amount of screen area to be updated by a repaint.

This class is not suitable for constructing shapes for rendering, especially as outlines. Use QPainterPath to create paths and shapes for use with QPainter .

QRegion 是隐式共享类。

创建和使用区域 ¶

A region can be created from a rectangle, an ellipse, a polygon or a bitmap. Complex regions may be created by combining simple regions using united() , intersected() , subtracted() ，或 xored() (exclusive or). You can move a region using translate() .

You can test whether a region isEmpty() or if it contains() a QPoint or QRect . The bounding rectangle can be found with boundingRect() .

Iteration over the region (with begin() , end() , or C++11 ranged-for loops) gives a decomposition of the region into rectangles.

Example of using complex regions:
class MyWidget (QWidget):
    # ...
    def paintEvent(self):
        r1 = QRegion(QRect(100, 100, 200, 80), QRegion.Ellipse) # r1: elliptic region
                )
        r2 = QRect(100, 120, 90, 30)   # r2: rectangular region
        r3 = r1.intersected(r2)        # r3: intersection
        painter = QPainter(self)
        painter.setClipRegion(r3)
        ...                            # paint clipped graphics
												
另请参阅

setClipRegion() setClipRect() QPainterPath

class QRegion ¶

QRegion(bitmap)

QRegion(pa[, fillRule=Qt.OddEvenFill])

QRegion(r[, t=Rectangle])

QRegion(region)

QRegion(x, y, w, h[, t=Rectangle])

param w

int

param x

int

param y

int

param h

int

param fillRule

FillRule

param bitmap

QBitmap

param region

QRegion

param r

QRect

param t

RegionType

param pa

QPolygon

Constructs an empty region.

另请参阅

isEmpty()

Constructs a rectangular or elliptic region.

若 t is Rectangle , the region is the filled rectangle ( x , y , w , h )。若 t is Ellipse , the region is the filled ellipse with center at ( x + w / 2, y + h / 2) and size ( w ,``h`` ).

PySide2.QtGui.QRegion. RegionType ¶

Specifies the shape of the region to be created.

常量	描述
QRegion.Rectangle	the region covers the entire rectangle.
QRegion.Ellipse	the region is an ellipse inside the rectangle.

PySide2.QtGui.QRegion. begin ( ) ¶

返回类型: QRect

返回 const_iterator pointing to the beginning of the range of non-overlapping rectangles that make up the region.

The union of all the rectangles is equal to the original region.

另请参阅

rbegin() cbegin() end()

PySide2.QtGui.QRegion. boundingRect ( ) ¶

返回类型: QRect

Returns the bounding rectangle of this region. An empty region gives a rectangle that is isNull() .

PySide2.QtGui.QRegion. cbegin ( ) ¶

返回类型: QRect

如同 begin() .

PySide2.QtGui.QRegion. cend ( ) ¶

返回类型: QRect

如同 end() .

PySide2.QtGui.QRegion. contains ( p ) ¶

参数: p – QPoint
返回类型: bool

PySide2.QtGui.QRegion. contains ( r ) ¶

参数: r – QRect
返回类型: bool

PySide2.QtGui.QRegion. end ( ) ¶

返回类型: QRect

返回 const_iterator pointing to one past the end of non-overlapping rectangles that make up the region.

The union of all the rectangles is equal to the original region.

另请参阅

rend() cend() begin()

PySide2.QtGui.QRegion. intersected ( r ) ¶

参数: r – QRect
返回类型: QRegion

PySide2.QtGui.QRegion. intersected ( r ) ¶

参数: r – QRegion
返回类型: QRegion

PySide2.QtGui.QRegion. intersects ( r ) ¶

参数: r – QRect
返回类型: bool

PySide2.QtGui.QRegion. intersects ( r ) ¶

参数: r – QRegion
返回类型: bool

PySide2.QtGui.QRegion. isEmpty ( ) ¶

返回类型: bool

返回 true 若区域为空；否则返回 false 。空区域是不包含任何点的区域。

范例：

												r1 = QRegion(10, 10, 20, 20)
r1.isNull()                // false
r1.isEmpty()               // false
r2 = QRegion(40, 40, 20, 20)
r3 = QRegion()
r3.isNull()                // true
r3.isEmpty()               // true
r3 = r1.intersected(r2)    // r3: intersection of r1 and r2
r3.isNull()                // false
r3.isEmpty()               // true
r3 = r1.united(r2)         // r3: union of r1 and r2
r3.isNull()                // false
r3.isEmpty()               // false
												
											

PySide2.QtGui.QRegion. isNull ( ) ¶

返回类型: bool

返回 true 若区域为空；否则返回 false . An empty region is a region that contains no points. This function is the same as isEmpty

另请参阅

isEmpty()

PySide2.QtGui.QRegion. __ne__ ( r ) ¶

参数: r – QRegion
返回类型: bool

返回 true if this region is different from the other region; otherwise returns false .

PySide2.QtGui.QRegion. __and__ ( r ) ¶

参数: r – QRect
返回类型: QRegion

PySide2.QtGui.QRegion. __and__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

PySide2.QtGui.QRegion. __mul__ ( m ) ¶

参数: m – QMatrix
返回类型: QRegion

PySide2.QtGui.QRegion. __mul__ ( m ) ¶

参数: m – QTransform
返回类型: QRegion

PySide2.QtGui.QRegion. __add__ ( r ) ¶

参数: r – QRect
返回类型: QRegion

PySide2.QtGui.QRegion. __add__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

PySide2.QtGui.QRegion. __iadd__ ( r ) ¶

参数: r – QRect
返回类型: QRegion

PySide2.QtGui.QRegion. __iadd__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

PySide2.QtGui.QRegion. __sub__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the subtracted() function to this region and r . r1-r2 相当于 r1.subtracted(r2) .

另请参阅

subtracted()

PySide2.QtGui.QRegion. __isub__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the subtracted() function to this region and r and assigns the result to this region. r1-=r2 相当于 r1 = r1.subtracted(r2) .

另请参阅

subtracted()

PySide2.QtGui.QRegion. __eq__ ( r ) ¶

参数: r – QRegion
返回类型: bool

返回 true if the region is equal to r ；否则返回 false。

PySide2.QtGui.QRegion. __xor__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the xored() function to this region and r . r1^r2 相当于 r1.xored(r2) .

另请参阅

xored()

PySide2.QtGui.QRegion. __ixor__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the xored() function to this region and r and assigns the result to this region. r1^=r2 相当于 r1 = r1.xored(r2) .

另请参阅

xored()

PySide2.QtGui.QRegion. __or__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the united() function to this region and r . r1|r2 相当于 r1.united(r2) .

另请参阅

united() operator+()

PySide2.QtGui.QRegion. __ior__ ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Applies the united() function to this region and r and assigns the result to this region. r1|=r2 相当于 r1 = r1.united(r2) .

另请参阅

united()

PySide2.QtGui.QRegion. rectCount ( ) ¶

返回类型: int

Returns the number of rectangles that this region is composed of. Same as end() - begin() .

PySide2.QtGui.QRegion. rects ( ) ¶

返回类型

注意

此函数被弃用。

使用 begin() and end() 代替。

Returns an array of non-overlapping rectangles that make up the region.

The union of all the rectangles is equal to the original region.

另请参阅

setRects()

PySide2.QtGui.QRegion. setRects ( rect , num ) ¶

参数

rect – QRect
num – int

Sets the region using the array of rectangles specified by rects and number . The rectangles must be optimally Y-X sorted and follow these restrictions:

The rectangles must not intersect.
All rectangles with a given top coordinate must have the same height.
No two rectangles may abut horizontally (they should be combined into a single wider rectangle in that case).
The rectangles must be sorted in ascending order, with Y as the major sort key and X as the minor sort key.

另请参阅

rects()

PySide2.QtGui.QRegion. subtracted ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Returns a region which is r subtracted from this region.

The figure shows the result when the ellipse on the right is subtracted from the ellipse on the left ( left - right ).

另请参阅

intersected() united() xored()

PySide2.QtGui.QRegion. swap ( other ) ¶

参数: other – QRegion

Swaps region other with this region. This operation is very fast and never fails.

PySide2.QtGui.QRegion. translate ( p ) ¶

参数: p – QPoint

这是重载函数。

Translates the region point .x() along the x axis and point .y() along the y axis, relative to the current position. Positive values move the region to the right and down.

Translates to the given point .

PySide2.QtGui.QRegion. translate ( dx , dy ) ¶

参数

dx – int
dy – int

Translates (moves) the region dx along the X axis and dy along the Y axis.

PySide2.QtGui.QRegion. translated ( p ) ¶

参数: p – QPoint
返回类型: QRegion

这是重载函数。

Returns a copy of the regtion that is translated p .x() along the x axis and p .y() along the y axis, relative to the current position. Positive values move the rectangle to the right and down.

另请参阅

translate()

PySide2.QtGui.QRegion. translated ( dx , dy ) ¶

参数

dx – int
dy – int

返回类型

QRegion

Returns a copy of the region that is translated dx along the x axis and dy along the y axis, relative to the current position. Positive values move the region to the right and down.

另请参阅

translate()

PySide2.QtGui.QRegion. united ( r ) ¶

参数: r – QRect
返回类型: QRegion

PySide2.QtGui.QRegion. united ( r ) ¶

参数: r – QRegion
返回类型: QRegion

PySide2.QtGui.QRegion. xored ( r ) ¶

参数: r – QRegion
返回类型: QRegion

Returns a region which is the exclusive or (XOR) of this region and r .

The figure shows the exclusive or of two elliptical regions.

另请参阅

intersected() united() subtracted()

内容表

上一话题

下一话题

快速搜索

QRegion ¶

概要 ¶

函数 ¶

详细描述 ¶

创建和使用区域 ¶