QRegion Class

Documentación de las funciones miembro

QRegion::QRegion()

Construye una región vacía.

Véase también isEmpty().

QRegion::QRegion(const QBitmap &bm)

Construye una región a partir del mapa de bits bm.

La región resultante consiste en los píxeles del mapa de bits bm que son Qt::color1, como si cada píxel fuera un rectángulo de 1 por 1.

Este constructor puede crear regiones complejas que ralentizarán el pintado cuando se utilice. Tenga en cuenta que dibujar pixmaps enmascarados puede hacerse mucho más rápido usando QPixmap::setMask().

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

Construye una región poligonal a partir de la matriz de puntos a con la regla de relleno especificada por fillRule.

Si fillRule es Qt::WindingFill, la región poligonal se define utilizando el algoritmo de enrollado; si es Qt::OddEvenFill, se utiliza el algoritmo de relleno par-impar.

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

Construye una región rectangular o elíptica.

Si t es Rectangle, la región es el rectángulo relleno (x, y, w, h). Si t es Ellipse, la región es la elipse rellena con centro en (x + w / 2, y + h / 2) y tamaño (w,h).

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

Crea una región basada en el rectángulo r con tipo de región t.

Si el rectángulo no es válido se creará una región nula.

Véase también QRegion::RegionType.

QRegion::QRegion(const QRegion &r)

Construye una nueva región que es igual a la región r.

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

Mover-construye una nueva región a partir de la región other. Después de la llamada, other es null.

Véase también isNull().

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

Devuelve un const_iterator que apunta al principio del rango de rectángulos no solapados que componen la región.

La unión de todos los rectángulos es igual a la región original.

Véase también rbegin(), cbegin() y end().

[noexcept] QRect QRegion::boundingRect() const

Devuelve el rectángulo que delimita esta región. Una región vacía devuelve un rectángulo que es QRect::isNull().

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

Igual que begin().

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

Igual que end().

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

Devuelve true si la región contiene el punto p; en caso contrario devuelve false.

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

Devuelve true si la región se solapa con el rectángulo r; en caso contrario devuelve false.

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

Igual que rbegin().

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

Igual que rend().

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

Devuelve un const_iterator que apunta a uno pasado el final de los rectángulos no superpuestos que componen la región.

La unión de todos los rectángulos es igual a la región original.

Véase también rend(), cend() y begin().

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

Devuelve un QRegion que es equivalente al hrgn dado.

Esta función se introdujo en Qt 6.0.

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

Devuelve una región que es la intersección de esta región y la rect dada.

Véase también subtracted(), united() y xored().

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

Devuelve una región que es la intersección de esta región y r.

La figura muestra la intersección de dos regiones elípticas.

Véase también subtracted(), united() y xored().

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

Devuelve true si esta región se cruza con rect, en caso contrario devuelve false.

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

Devuelve true si esta región se cruza con region, en caso contrario devuelve false.

bool QRegion::isEmpty() const

Devuelve true si la región está vacía; en caso contrario, devuelve false. Una región vacía es una región que no contiene puntos.

Ejemplo:

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

Devuelve true si la región está vacía; en caso contrario, devuelve false. Una región vacía es una región que no contiene ningún punto. Esta función es la misma que isEmpty

Véase también isEmpty().

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

Devuelve un const_reverse_iterator que apunta al principio del rango de rectángulos no solapados que componen la región.

La unión de todos los rectángulos es igual a la región original.

Véase también begin(), crbegin() y rend().

[noexcept] int QRegion::rectCount() const

Devuelve el número de rectángulos que componen esta región. Igual que end() - begin().

[noexcept, since 6.8] QSpan<const QRect> QRegion::rects() const

Devuelve un intervalo de rectángulos no superpuestos que componen la región. El intervalo será válido hasta la siguiente llamada a un método mutante (no-const) en esta región.

La unión de todos los rectángulos es igual a la región original.

Esta función se introdujo en Qt 6.8.

Véase también setRects().

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

Devuelve un const_reverse_iterator que apunta a uno pasado el final del rango de rectángulos no solapados que componen la región.

La unión de todos los rectángulos es igual a la región original.

Véase también end(), crend() y rbegin().

[since 6.8] void QRegion::setRects(QSpan<const QRect> rects)

Establece la región utilizando la matriz de rectángulos especificada por rects. Los rectángulos deben estar óptimamente ordenados Y-X y seguir estas restricciones:

• Los rectángulos no deben intersecarse.
• Todos los rectángulos con una coordenada superior determinada deben tener la misma altura.
• No puede haber dos rectángulos contiguos horizontalmente (en ese caso, deben combinarse en un único rectángulo más ancho).
• Los rectángulos deben ordenarse en orden ascendente, con Y como clave de ordenación mayor y X como clave de ordenación menor.

Esta función se introdujo en Qt 6.8.

Véase también rects().

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

Devuelve una región que es r restada de esta región.

La figura muestra el resultado cuando la elipse de la derecha se resta de la elipse de la izquierda (left - right).

Véase también intersected(), united() y xored().

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

Intercambia esta región con other. Esta operación es muy rápida y nunca falla.

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

Devuelve un HRGN equivalente a la región dada.

Esta función se introdujo en Qt 6.0.

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

Traslada (mueve) la región dx a lo largo del eje X y dy a lo largo del eje Y.

void QRegion::translate(const QPoint &point)

Traslada la región point.x() a lo largo del eje x y point.y() a lo largo del eje y, en relación con la posición actual. Los valores positivos desplazan la región hacia la derecha y hacia abajo.

Traslada la región a la dirección point.

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

Devuelve una copia de la región trasladada dx a lo largo del eje x y dy a lo largo del eje y, en relación con la posición actual. Los valores positivos desplazan la región hacia la derecha y hacia abajo.

Véase también translate().

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

Devuelve una copia del rectángulo trasladada p.x() a lo largo del eje x y p.y() a lo largo del eje y, en relación con la posición actual. Los valores positivos desplazan el rectángulo hacia la derecha y hacia abajo.

Véase también translate().

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

Devuelve una región que es la unión de esta región y la dada rect.

Véase también intersected(), subtracted() y xored().

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

Devuelve una región que es la unión de esta región y r.

La figura muestra la unión de dos regiones elípticas.

Véase también intersected(), subtracted() y xored().

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

Devuelve una región que es el or exclusivo (XOR) de esta región y r.

La figura muestra el or exclusivo de dos regiones elípticas.

Véase también intersected(), united() y subtracted().

QRegion::operator QVariant() const

Devuelve la región como QVariant

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

Devuelve true si esta región es diferente de la región other; en caso contrario devuelve false.

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

Aplica la función intersected() a esta región y a r. r1&r2 es equivalente a r1.intersected(r2).

Véase también intersected().

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

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

Aplica la función intersected() a esta región y a r y asigna el resultado a esta región. r1&=r2 es equivalente a r1 = r1.intersected(r2).

Véase también intersected().

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

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

Aplica la función united() a esta región y a r. r1+r2 es equivalente a r1.united(r2).

Véase también united() y operator|().

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

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

Devuelve una región que es la unión de esta región con la especificada rect.

Véase también united().

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

Aplica la función united() a esta región y a r y asigna el resultado a esta región. r1+=r2 es equivalente a r1 = r1.united(r2).

Véase también intersected().

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

Aplica la función subtracted() a esta región y a r. r1-r2 es equivalente a r1.subtracted(r2).

Véase también subtracted().

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

Aplica la función subtracted() a esta región y a r y asigna el resultado a esta región. r1-=r2 es equivalente a r1 = r1.subtracted(r2).

Véase también subtracted().

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

Mover-asigna other a esta instancia QRegion.

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

Asigna r a esta región y devuelve una referencia a la región.

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

Devuelve true si la región es igual a r; en caso contrario devuelve false.

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

Aplica la función xored() a esta región y a r. r1^r2 es equivalente a r1.xored(r2).

Véase también xored().

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

Aplica la función xored() a esta región y a r y asigna el resultado a esta región. r1^=r2 es equivalente a r1 = r1.xored(r2).

Véase también xored().

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

Aplica la función united() a esta región y a r. r1|r2 es equivalente a r1.united(r2).

Véase también united() y operator+().

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

Aplica la función united() a esta región y a r y asigna el resultado a esta región. r1|=r2 es equivalente a r1 = r1.united(r2).

Véase también united().