QRegion Class Reference - 《PyQt4 中文文档》

[ QtGui module]
Detailed Description
- Creating and Using Regions
- Additional License Information
Type Documentation
Method Documentation

[QtGui module]

该QRegion类指定一个画家的剪辑区域。More…

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（），以限制油漆区，以什么需要上漆。还有一个QWidget.repaint（）函数，它接受一个QRegion参数。 QRegion对于减少屏幕区域由一个重绘更新量的最佳工具。

这个类是不适合于构建形状呈现，尤其是作为轮廓。使用QPainterPath创建路径和形状与使用QPainter。

QRegion是implicitly shared类。

Creating and Using Regions

一个区域可以由一个矩形，椭圆形，多边形或一个位图被创建。复杂区域可以通过结合简单的使用区域来创建united（）intersected（）subtracted（），或xored（）（异或）。您可以使用移动区域translate（）。

您可以测试是否一个区域isEmpty（），或者如果它contains（）一QPoint or QRect。该边框可以找到boundingRect（）。

该功能rects（）给出的区域的分解成矩形。

使用复杂的区域的例子：

 void MyWidget.paintEvent([QPaintEvent](docs_qpaintevent.html) *)
 {
     QRegion r1([QRect](docs_qrect.html)(100, 100, 200, 80),    // r1: elliptic region
                QRegion.Ellipse);
     QRegion r2([QRect](docs_qrect.html)(100, 120, 90, 30));    // r2: rectangular region
     QRegion r3 = r1.intersected(r2);        // r3: intersection
     [QPainter](docs_qpainter.html) painter(this);
     painter.setClipRegion(r3);
     ...                                     // paint clipped graphics
 }

Additional License Information

在嵌入式Linux ， Windows CE和X11平台上，这个类的部分依靠以以下授权协议获得的代码：

特此免费授予的，对任何获得本软件副本及相关文档文件（ “软件” ），以处理本软件不受任何限制，包括但不限于使用权，复制，修改，合并，发布，分发，再许可和/或销售软件副本，并允许他人为之软体家具是这样做的，须符合下列条件：

本软件按“原样”，没有任何形式的担保，明示或默示的担保，包括但不限于适销性，适用于特定用途和非侵权的保证。在任何情况下X联盟承担任何索赔，损害赔偿或其他责任，无论是合同行为，侵权行为或其他原因所产生的，运出或与本软件或使用，或软件中的其他交易。

除本通知所载， X联盟的名称不得用于广告或其他方式来促进销售，使用或本软件中的其他交易未经X联盟事先书面授权。

DIGITAL声明不提供本软件有关，包括对适销性和适用性的所有默示保证，在任何情况下数字都不对任何特殊，间接或后果性损害或任何损害因无法使用，数据丢失或利润，无论是在动作的合同，疏忽或其它侵权行为，所产生的或与本软件的使用或性能。

Type Documentation

QRegion.RegionType

指定区域的要创建的形状。

Constant	Value	Description
`QRegion.Rectangle`	`0`	该区域复盖了整个矩形。
`QRegion.Ellipse`	`1`	该区域是在矩形内的椭圆形。

Method Documentation

QRegion.__init__ (self)

构造一个空区域。

See also 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.OddEvenFill，奇偶填充算法被使用。

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，好像每个像素是一个1×1的矩形。

这个构造函数可以创建复杂的地区使用时，将减缓画。请注意，绘图蒙面像素映射可以做到更快使用QPixmap.setMask（）。

QRegion.__init__ (self, QVariant variant)

这是一个重载函数。

创建基于rectange区域r与区域类型t。

如果矩形是无效的空区域将被创建。

See also QRegion.RegionType。

QRect QRegion.boundingRect (self)

返回此区域的边界矩形。一个空的区域给出了一个矩形，它是 QRect.isNull（）。

bool QRegion.contains (self, QPoint p)

如果该区域包含该点，则返回Truep否则返回False 。

bool QRegion.contains (self, QRect r)

这是一个重载函数。

如果该区域的矩形重叠，则返回Truer否则返回False 。

QRegion QRegion.eor (self, QRegion r)

QRegion QRegion.intersect (self, QRegion r)

QRegion QRegion.intersected (self, QRegion r)

[

返回作为此区域的交集和地区r。

QRegion Class Reference - 图1

该图显示了两个椭圆区域的交界处。

这个函数中引入了Qt 4.2中。

](qregion.html)

See also subtracted（）united（）和xored（）。

QRegion QRegion.intersected (self, QRect r)

[

返回作为此区域的交集和给定的区域rect。

此功能被引入Qt的4.4 。

](docs_qregion.html)

See also subtracted（）united（）和xored（）。

bool QRegion.intersects (self, QRegion r)

如果这个区域相交，则返回Trueregion，否则返回False 。

这个函数中引入了Qt 4.2中。

bool QRegion.intersects (self, QRect r)

如果这个区域相交，则返回Truerect，否则返回False 。

这个函数中引入了Qt 4.2中。

bool QRegion.isEmpty (self)

返回True如果该区域为空，否则返回False 。空白区是一个不包含任何点的区域中。

例如：

 [QRegion](docs_qregion.html) r1(10, 10, 20, 20);
 r1.isEmpty();               // false
 [QRegion](docs_qregion.html) r3;
 r3.isEmpty();               // true
 [QRegion](docs_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（）。

此功能被引入Qt的4.6 。

list-of-QRect QRegion.rects (self)

返回非重叠的矩形组成区域的数组。

所有矩形的并集等于原来的区域。

See also setRects（）。

QRegion QRegion.subtract (self, QRegion r)

QRegion QRegion.subtracted (self, QRegion r)

[

返回其是区域r减去这一地区。

QRegion Class Reference - 图2

图中示出了结果，当在右侧的椭圆是从左侧的椭圆（减去left - right）。

这个函数中引入了Qt 4.2中。

](qregion.html)

See also intersected（）united（）和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中引入。

](docs_qregion.html)

See also translate（）。

QRegion QRegion.translated (self, QPoint p)

[

这是一个重载函数。

返回regtion的副本翻译p.x()沿x轴和p.y()沿着y轴，相对于当前位置。正值移动矩形向右和向下。

这个函数是Qt 4.1中引入。

](docs_qregion.html)

See also translate（）。

QRegion QRegion.unite (self, QRegion r)

QRegion QRegion.united (self, QRegion r)

[

返回作为此区域的和工会的区域r。

QRegion Class Reference - 图3

该图显示了两个椭圆区域的联合。

这个函数中引入了Qt 4.2中。

](qregion.html)

See also intersected（）subtracted（）和xored（）。

QRegion QRegion.united (self, QRect r)

[

返回作为此区域的和工会给定一个区域rect。

此功能被引入Qt的4.4 。

](docs_qregion.html)

See also intersected（）subtracted（）和xored（）。

QRegion QRegion.xored (self, QRegion r)

[

返回作为此区域的异或（ XOR）和一个区r。

QRegion Class Reference - 图4

该图显示了专用的两个椭圆区域或。

这个函数中引入了Qt 4.2中。

](qregion.html)

See also intersected（）united（）和subtracted（）。

QRegion QRegion.__add__ (self, QRegion r)

QRegion QRegion.__add__ (self, QRect r)

QRegion QRegion.__and__ (self, QRegion r)

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)

](docs_qregion.html)

QRegion QRegion.__iadd__ (self, QRegion r)

QRegion QRegion.__iadd__ (self, QRect r)

QRegion QRegion.__iand__ (self, QRegion r)

QRegion QRegion.__iand__ (self, QRect r)

QRegion QRegion.__ior__ (self, QRegion r)

QRegion QRegion.__isub__ (self, QRegion r)

QRegion QRegion.__ixor__ (self, QRegion r)

QRegion QRegion.__mul__ (self, QMatrix m)

QRegion QRegion.__mul__ (self, QTransform m)

[

bool QRegion.__ne__ (self, QRegion r)

](docs_qregion.html)

QRegion QRegion.__or__ (self, QRegion r)

QRegion QRegion.__sub__ (self, QRegion r)

QRegion QRegion.__xor__ (self, QRegion r)