QRegion类

成员函数文档

QRegion::QRegion()

构造一个空的区域。

参见isEmpty()。

QRegion::QRegion(int x, int y, int w, int h, QRegion::RegionType t = Rectangle)

构造一个矩形或椭圆区域。

如果t为Rectangle，区域是填充矩形（x，y，w，h）。如果t为Ellipse，区域是以（x + w / 2，y + h / 2）为中心、大小为(w ,h的填充椭圆。

QRegion::QRegion(const QRect &r, QRegion::RegionType t = Rectangle)

这是一个重载函数。

根据矩形r与区域类型t创建区域。

如果矩形无效，则创建一个空区域。

参见QRegion::RegionType。

QRegion::QRegion(const QPolygon &a, Qt::FillRule fillRule = Qt::OddEvenFill)

从点数组a根据填充分Qt::FillRule rules来构建多边形区域。

如果 fillRule 是 Qt::WindingFill，则多边形区域是通过 winding 算法定义的；如果它为 Qt::OddEvenFill，则使用奇偶填充算法。

QRegion::QRegion(const QBitmap &bm)

由位图 bm 构建区域。

所得到的区域由位图 bm 中 Qt::color1 的像素组成，就像每个像素都是一个 1×1 的矩形。

此构造函数可能会创建复杂区域，使用时会导致绘制变慢。请注意，使用 QPixmap::setMask() 进行遮罩像素绘图可以更快完成。

QRegion::QRegion(const QRegion &r)

构建一个新区域，该区域等于区域 r。

[noexcept] QRegion::QRegion(QRegion &&other)

从区域 other 移动构建一个新的区域。调用后，other 为空。

另请参阅：isNull。

[noexcept] QRegion::const_iterator QRegion::begin() const

返回一个指向区域组成的非重叠矩形范围开始位置的 const_iterator。

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

另请参阅：rbegin、cbegin 和 end。

[noexcept] QRect QRegion::boundingRect() const

返回该区域的边界矩形。空区域返回一个 QRect::isNull 的矩形。

[noexcept] QRegion::const_iterator QRegion::cbegin() const

与 begin 相同。

[noexcept] QRegion::const_iterator QRegion::cend() const

与 end 相同。

bool QRegion::contains(const QPoint &p) const

如果区域包含点 p，则返回 true；否则返回 false。

bool QRegion::contains(const QRect &r) const

这是一个重载函数。

如果区域与矩形 r 有重叠，则返回 true；否则返回 false。

[noexcept] QRegion::const_reverse_iterator QRegion::crbegin() const

与 rbegin 相同。

[noexcept] QRegion::const_reverse_iterator QRegion::crend() const

与 rend(). 相同。

[noexcept] QRegion::const_iterator QRegion::end() const

返回一个指向该区域非重叠矩形范围的末尾之后的点的 const_iterator。

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

另请参阅 rend()，cend() 和 begin()。

[static, since 6.0] QRegion QRegion::fromHRGN(HRGN hrgn)

返回与给定的 hrgn 等效的 QRegion。

此函数自 Qt 6.0 版本引入。

QRegion QRegion::intersected(const QRegion &r) const

返回与该区域和 r 交集的区域。

图示显示了两个椭圆区域的交集。

另请参阅 subtracted()，united() 和 xored()。

QRegion QRegion::intersected(const QRect &rect) const

返回与给定 rect 的区域和该区域的交集。

另请参阅 subtracted()，united() 和 xored()。

bool QRegion::intersects(const QRegion &region) const

如果该区域与 region 交叉，返回 true；否则返回 false。

bool QRegion::intersects(const QRect &rect) const

如果该区域与 rect 交叉，返回 true；否则返回 false。

bool QRegion::isEmpty() const

如果该区域为空，返回 true；否则返回 false。一个空的区域是一个不包含任何点的区域。

示例

QRegion r1(10, 10, 20, 20);
r1.isEmpty();               // false

QRegion r3;
r3.isEmpty();               // true

QRegion 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

bool QRegion::isNull() const

如果该区域为空，返回 true；否则返回 false。一个空的区域是一个不包含任何点的区域。此函数与 isEmpty 相同。

参见isEmpty()。

[noexcept] QRegion::const_reverse_iterator QRegion::rbegin() const

返回一个指向该区域非重叠矩形范围的起始点 const_reverse_iterator。

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

另请参阅 begin()，crbegin() 和 rend()。

[noexcept] int QRegion::rectCount() const

返回组成该区域矩形的数量。与 end() - begin() 相同。

[noexcept] QRegion::const_reverse_iterator QRegion::rend() const

返回一个指向构成区域的非重叠矩形的范围的末尾之后的const_reverse_iterator。

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

另请参阅 end()，crend()，和rbegin()。

void QRegion::setRects(const QRect *rects, int number)

使用由 rects 和 number 指定的矩形数组设置区域。矩形必须按 Y-X 顺序最好排序，并遵守以下限制

• 矩形不能相交。
• 所有具有给定顶边坐标的矩形必须具有相同的高度。
• 两个矩形不得水平相邻（在这种情况下应将它们合并为单个更宽的矩形）。
• 矩形必须按升序排序，以 Y 为主要排序键，以 X 为次要排序键。

QRegion QRegion::subtracted(const QRegion &r) const

返回一个从该区域减去r的区域。

图显示了从左侧的椭圆中减去右侧的椭圆的结果 (left - right)。

另请参阅 intersected()，united()，和xored()。

[noexcept] void QRegion::swap(QRegion &other)

交换区域other与当前区域。此操作非常快且永远不会失败。

[since 6.0] HRGN QRegion::toHRGN() const

返回一个与给定区域等效的HRGN。

此函数自 Qt 6.0 版本引入。

void QRegion::translate(int dx, int dy)

将区域沿 X 轴移动 dx，沿 Y 轴移动 dy。

void QRegion::translate(const QPoint &point)

这是一个重载函数。

将区域沿 x 轴移动point.x()，沿 y 轴移动point.y()，相对于当前位置。正值将区域向右和向下移动。

移动到给定的point。

QRegion QRegion::translated(int dx, int dy) const

返回一个相对于当前位置沿 x 轴移动 dx 和沿 y 轴移动 dy 时的区域副本。正值将区域向右和向下移动。

另请参阅 translate()。

QRegion QRegion::translated(const QPoint &p) const

这是一个重载函数。

返回对齐于当前位置按照 p.x() 沿x轴和 p.y() 沿y轴移动的区域的副本。

另请参阅 translate()。

QRegion QRegion::united(const QRegion &r) const

返回这个区域与 r 的并集。

该图显示了两个椭圆区域的总和。

另请参阅 intersected（相交）、subtracted（减去）和 xored（异或）。

QRegion QRegion::united(const QRect &rect) const

返回这个区域与指定的 rect 的并集。

另请参阅 intersected（相交）、subtracted（减去）和 xored（异或）。

QRegion QRegion::xored(const QRegion &r) const

返回一个区域，该区域为这个区域与 r 的异或（XOR）。

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

另请参阅 intersected（相交）、united（联合）和 subtracted（减去）。

QVariant QRegion::operator QVariant() const

返回该区域的 QVariant 类型的副本。

bool QRegion::operator!=(const QRegion &other) const

如果此区域与 other 区域不同则返回 true；否则返回 false。

QRegion QRegion::operator&(const QRegion &r) const

将此区域和 r 应用 intersected（相交）函数。r1 & r2 等价于 r1.intersected(r2)。

另请参阅 intersected。

QRegion QRegion::operator&(const QRect &r) const

这是一个重载函数。

将此区域和 r 应用 intersected（相交）函数并将结果赋值给此区域。r1 &= r2 等价于 r1 = r1.intersected(r2)。

另请参阅 intersected。

QRegion& QRegion::operator&=(const QRect& r)

这是一个重载函数。

QRegion QRegion::operator+(const QRegion& r) const

将 united() 函数应用于此区域和 r。 r1+r2 等价于 r1.united(r2)。

另请参阅united() 和 operator|。

QRegion QRegion::operator+(const QRect &r) const

这是一个重载函数。

QRegion &QRegion::operator+=(const QRegion &r)

将 united() 函数应用于此区域和 r，并将结果赋给此区域。 r1+=r2 等价于 r1 = r1.united(r2)。

另请参阅 intersected。

QRegion &QRegion::operator+=(const QRect &rect)

返回一个区域，此区域是此区域与指定的 rect 的并集。

另请参阅united。

QRegion QRegion::operator-(const QRegion &r) const

将 subtracted() 函数应用于此区域和 r。 r1-r2 等价于 r1.subtracted(r2)。

另请参阅subtracted。

QRegion &QRegion::operator-=(const QRegion &r)

将 subtracted() 函数应用于此区域和 r，并将结果赋给此区域。 r1-=r2 等价于 r1 = r1.subtracted(r2)。

另请参阅subtracted。

QRegion &QRegion::operator=(const QRegion &r)

将 r 赋值给此区域并返回对区域的引用。

[noexcept] QRegion &QRegion::operator=(QRegion &&other)

移动赋值 other 到此 QRegion 实例。

bool QRegion::operator==(const QRegion &r) const

如果区域等于 r，则返回 true；否则返回 false。

QRegion QRegion::operator^(const QRegion &r) const

将 xored() 函数应用于此区域和 r。 r1^r2 等价于 r1.xored(r2)。

另请参阅xored。

QRegion &QRegion::operator^=(const QRegion &r)

将 xored() 函数应用于此区域和 r，并将结果赋值给此区域。r1^=r2 等同于 r1 = r1.xored(r2)。

另请参阅xored。

QRegion QRegion::operator|(const QRegion &r) const

将 united() 函数应用于此区域和 r。r1|r2 等同于 r1.united(r2)。

另请参阅united() 和 operator+。

QRegion &QRegion::operator|=(const QRegion &r)

将 united() 函数应用于此区域和 r，并将结果赋值给此区域。r1|=r2 等同于 r1 = r1.united(r2)。

另请参阅united。