QRect Class
La clase QRect define un rectángulo en el plano con precisión entera. Más información...
| Encabezado: | #include <QRect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- QRect forma parte de las clases de pintura.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QRect
| Categoría | Tipos comparables |
|---|---|
| igualdad | QRect |
| igualdad | QRectF. |
Funciones públicas
| QRect() | |
| QRect(const QPoint &topLeft, const QPoint &bottomRight) | |
| QRect(const QPoint &topLeft, const QSize &size) | |
| QRect(int x, int y, int width, int height) | |
| void | adjust(int dx1, int dy1, int dx2, int dy2) |
| QRect | adjusted(int dx1, int dy1, int dx2, int dy2) const |
| int | bottom() const |
| QPoint | bottomLeft() const |
| QPoint | bottomRight() const |
| QPoint | center() const |
| bool | contains(const QPoint &point, bool proper = false) const |
| bool | contains(const QRect &rectangle, bool proper = false) const |
| bool | contains(int x, int y) const |
| bool | contains(int x, int y, bool proper) const |
| void | getCoords(int *x1, int *y1, int *x2, int *y2) const |
| void | getRect(int *x, int *y, int *width, int *height) const |
| int | height() const |
| QRect | intersected(const QRect &rectangle) const |
| bool | intersects(const QRect &rectangle) const |
| bool | isEmpty() const |
| bool | isNull() const |
| bool | isValid() const |
| int | left() const |
| QRect | marginsAdded(const QMargins &margins) const |
| QRect | marginsRemoved(const QMargins &margins) const |
| void | moveBottom(int y) |
| void | moveBottomLeft(const QPoint &position) |
| void | moveBottomRight(const QPoint &position) |
| void | moveCenter(const QPoint &position) |
| void | moveLeft(int x) |
| void | moveRight(int x) |
| void | moveTo(const QPoint &position) |
| void | moveTo(int x, int y) |
| void | moveTop(int y) |
| void | moveTopLeft(const QPoint &position) |
| void | moveTopRight(const QPoint &position) |
| QRect | normalized() const |
| int | right() const |
| void | setBottom(int y) |
| void | setBottomLeft(const QPoint &position) |
| void | setBottomRight(const QPoint &position) |
| void | setCoords(int x1, int y1, int x2, int y2) |
| void | setHeight(int height) |
| void | setLeft(int x) |
| void | setRect(int x, int y, int width, int height) |
| void | setRight(int x) |
| void | setSize(const QSize &size) |
| void | setTop(int y) |
| void | setTopLeft(const QPoint &position) |
| void | setTopRight(const QPoint &position) |
| void | setWidth(int width) |
| void | setX(int x) |
| void | setY(int y) |
| QSize | size() const |
| CGRect | toCGRect() const |
(since 6.4) QRectF | toRectF() const |
| int | top() const |
| QPoint | topLeft() const |
| QPoint | topRight() const |
| void | translate(int dx, int dy) |
| void | translate(const QPoint &offset) |
| QRect | translated(int dx, int dy) const |
| QRect | translated(const QPoint &offset) const |
| QRect | transposed() const |
| QRect | united(const QRect &rectangle) const |
| int | width() const |
| int | x() const |
| int | y() const |
| QRect | operator&(const QRect &rectangle) const |
| QRect & | operator&=(const QRect &rectangle) |
| QRect & | operator+=(const QMargins &margins) |
| QRect & | operator-=(const QMargins &margins) |
| QRect | operator|(const QRect &rectangle) const |
| QRect & | operator|=(const QRect &rectangle) |
Miembros públicos estáticos
(since 6.0) QRect | span(const QPoint &p1, const QPoint &p2) |
Elementos no miembros relacionados
| bool | operator!=(const QRect &lhs, const QRect &rhs) |
| QRect | operator+(const QRect &rectangle, const QMargins &margins) |
| QRect | operator+(const QMargins &margins, const QRect &rectangle) |
| QRect | operator-(const QRect &lhs, const QMargins &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QRect &rectangle) |
| bool | operator==(const QRect &lhs, const QRect &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QRect &rectangle) |
Descripción detallada
Un rectángulo se expresa normalmente como una esquina superior izquierda y un tamaño. El tamaño (anchura y altura) de un QRect es siempre equivalente al rectángulo matemático que sirve de base para su representación.
Un QRect se puede construir con un conjunto de enteros que representan la posición izquierda, la posición superior, la anchura y la altura, o a partir de un ` QPoint ` y un ` QSize`. El siguiente código crea dos rectángulos idénticos.
Existe un tercer constructor que crea un QRect utilizando las coordenadas de la esquina superior izquierda y la esquina inferior derecha, pero recomendamos evitar su uso. El motivo es que, por razones históricas, los valores devueltos por las funciones bottom() y right() se desvían de la verdadera esquina inferior derecha del rectángulo.
La clase QRect proporciona un conjunto de funciones que devuelven las distintas coordenadas del rectángulo y permiten manipularlas. QRect también proporciona funciones para desplazar el rectángulo con respecto a las distintas coordenadas. Además, existe la función moveTo() que desplaza el rectángulo manteniendo su esquina superior izquierda en las coordenadas indicadas. Por otra parte, la función translate() desplaza el rectángulo una distancia determinada con respecto a su posición actual, y la función translated() devuelve una copia desplazada de este rectángulo.
La función size() devuelve las dimensiones del rectángulo como un objeto QSize. Las dimensiones también se pueden obtener por separado utilizando las funciones width() y height(). Para manipular las dimensiones, utilice las funciones setSize(), setWidth() o setHeight(). Alternativamente, el tamaño se puede modificar aplicando cualquiera de las funciones que establecen las coordenadas del rectángulo, por ejemplo, setBottom() o setRight().
La función ` contains()` indica si un punto dado se encuentra dentro del rectángulo o no, y la función ` intersects()` devuelve ` true ` si este rectángulo se cruza con un rectángulo dado. La clase `QRect` también proporciona la función ` intersected()`, que devuelve el rectángulo de intersección, y la función ` united()`, que devuelve el rectángulo que engloba al rectángulo dado y a este:
La función ` isEmpty()` devuelve ` true ` si ` left()` > ` right()` o ` top()` > ` bottom()`. Ten en cuenta que un rectángulo vacío no es válido: la función ` isValid()` devuelve ` true ` si ` left()` <= ` right() ` y ` top()` <= ` bottom()`. Por otro lado, un rectángulo nulo (`isNull()` == `true`) tiene tanto el ancho como la altura establecidos en 0.
Ten en cuenta que, debido a la forma en que se definen QRect y QRectF, un QRect vacío se define esencialmente de la misma manera que QRectF.
Por último, los objetos QRect pueden transmitirse y compararse.
Representación
Al utilizar un pintor « anti-aliased », la línea delimitadora de un QRect se representará simétricamente a ambos lados de la línea delimitadora del rectángulo matemático. Sin embargo, al utilizar un pintor con alias (el predeterminado), se aplican otras reglas.
Así, al renderizar con un trazo de un píxel de ancho, la línea delimitadora del QRect se renderizará a la derecha y por debajo de la línea delimitadora del rectángulo matemático.
Al renderizar con un trazo de dos píxeles de ancho, la línea delimitadora se dividirá por la mitad por el rectángulo matemático. Esto ocurrirá siempre que el trazo esté configurado con un número par de píxeles; mientras que, al renderizar con un trazo de número impar de píxeles, el píxel sobrante se renderizará a la derecha y por debajo del rectángulo matemático, igual que en el caso de un píxel.
![]() | ![]() |
| Representación lógica | Lápiz de un píxel de ancho |
![]() | ![]() |
| Lápiz de dos píxeles de ancho | Lápiz de tres píxeles de ancho |
Coordenadas
La clase QRect ofrece un conjunto de funciones que devuelven las distintas coordenadas del rectángulo y permiten manipularlas. QRect también proporciona funciones para desplazar el rectángulo en relación con las distintas coordenadas.
Por ejemplo, las funciones left(), setLeft() y moveLeft(): left() devuelve la coordenada x del borde izquierdo del rectángulo; setLeft() establece el borde izquierdo del rectángulo en la coordenada x indicada (puede modificar el ancho, pero nunca cambiará el borde derecho del rectángulo) y moveLeft() desplaza todo el rectángulo horizontalmente, manteniendo el borde izquierdo del rectángulo en la coordenada x indicada y sin modificar su tamaño.

Tenga en cuenta que, por razones históricas, los valores devueltos por las funciones bottom() y right() se desvían de la verdadera esquina inferior derecha del rectángulo: la función right() devuelve left () + width() - 1 y la función bottom() devuelve top() + height() - 1. Lo mismo ocurre con el punto devuelto por la función de conveniencia bottomRight(). Además, las coordenadas x e y de las funciones topRight() y bottomLeft(), respectivamente, presentan la misma desviación respecto a los bordes derecho e inferior reales.
Recomendamos utilizar ` x()` + ` width()` y ` y()` + ` height()` para encontrar la esquina inferior derecha real, y evitar ` right()` y ` bottom()`. Otra solución es utilizar ` QRectF`: la clase ` QRectF ` define un rectángulo en el plano utilizando precisión de punto flotante para las coordenadas, y las funciones ` QRectF::right()` y ` QRectF::bottom() ` devuelven las coordenadas derecha e inferior.
También es posible añadir desplazamientos a las coordenadas de este rectángulo mediante la función adjust(), así como obtener un nuevo rectángulo basado en los ajustes del original mediante la función adjusted(). Si la anchura o la altura son negativas, utilice la función normalized() para obtener un rectángulo en el que se intercambien las esquinas.
Además, QRect proporciona la función getCoords(), que extrae la posición de las esquinas superior izquierda e inferior derecha del rectángulo, y la función getRect(), que extrae la esquina superior izquierda, el ancho y la altura del rectángulo. Utiliza las funciones setCoords() y setRect() para manipular las coordenadas y las dimensiones del rectángulo de una sola vez.
Restricciones
QRect está limitado a los valores mínimo y máximo del tipo int. Las operaciones sobre un QRect que puedan dar lugar a valores fuera de este rango provocarán un comportamiento indefinido.
Véase también QRectF y QRegion.
Documentación de las funciones miembro
[constexpr noexcept] QRect::QRect()
Crea un rectángulo nulo.
Véase también isNull().
[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)
Crea un rectángulo con las esquinas dadas topLeft y bottomRight, ambas incluidas.
Si bottomRight está más arriba y a la izquierda de topLeft, el rectángulo definido no incluirá las esquinas.
Nota: Para garantizar que ambos puntos queden incluidos independientemente de su orden relativo, utiliza span().
Véase también setTopLeft(), setBottomRight() y span().
[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)
Crea un rectángulo con la esquina indicada en topLeft y el valor indicado en size.
Véanse también setTopLeft() y setSize().
[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)
Crea un rectángulo con (x, y) como esquina superior izquierda y los valores dados width y height.
Véase también setRect().
[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)
Añade dx1, dy1, dx2 y dy2, respectivamente, a las coordenadas existentes del rectángulo.
Véase también adjusted() y setRect().
[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const
Devuelve un nuevo rectángulo al que se le han sumado, respectivamente, dx1, dy1, dx2 y dy2 a las coordenadas existentes de este rectángulo.
Véase también adjust().
[constexpr noexcept] int QRect::bottom() const
Devuelve la coordenada y del borde inferior del rectángulo.
Ten en cuenta que, por motivos históricos, esta función devuelve top() + height() - 1; utiliza y() + height() para obtener la verdadera coordenada y.
Véanse también setBottom(), bottomLeft() y bottomRight().
[constexpr noexcept] QPoint QRect::bottomLeft() const
Devuelve la posición de la esquina inferior izquierda del rectángulo. Ten en cuenta que, por razones históricas, esta función devuelve QPoint(left(), top() + height() - 1).
Véanse también setBottomLeft(), bottom() y left().
[constexpr noexcept] QPoint QRect::bottomRight() const
Devuelve la posición de la esquina inferior derecha del rectángulo.
Ten en cuenta que, por motivos históricos, esta función devuelve QPoint(left() + width() -1, top() + height() - 1).
Véanse también setBottomRight(), bottom() y right().
[constexpr noexcept] QPoint QRect::center() const
Devuelve el punto central del rectángulo.
Véase también moveCenter().
[noexcept] bool QRect::contains(const QPoint &point, bool proper = false) const
Devuelve « true » si el « point » dado se encuentra dentro del rectángulo o en uno de sus bordes; en caso contrario, devuelve « false ». Si « proper » es verdadero, esta función solo devuelve « true » si el « point » dado se encuentra dentro del rectángulo (es decir, no en uno de sus bordes).
Véase también intersects().
[noexcept] bool QRect::contains(const QRect &rectangle, bool proper = false) const
Devuelve « true » si el « rectangle » dado se encuentra dentro de este rectángulo; en caso contrario, devuelve « false ». Si « proper » es verdadero, esta función solo devuelve « true » si el « rectangle » se encuentra íntegramente dentro de este rectángulo (sin tocar los bordes).
Esta es una función sobrecargada.
[noexcept] bool QRect::contains(int x, int y) const
Devuelve ` true ` si el punto (x, y) se encuentra dentro de este rectángulo; en caso contrario, devuelve ` false`.
Esta es una función sobrecargada.
[noexcept] bool QRect::contains(int x, int y, bool proper) const
Devuelve ` true ` si el punto `(x, y)` se encuentra dentro del rectángulo o en uno de sus bordes; en caso contrario, devuelve ` false`. Si ` proper ` es verdadero, esta función solo devuelve ` true ` si el punto se encuentra completamente dentro del rectángulo (no en uno de sus bordes).
Se trata de una función sobrecargada.
[constexpr] void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const
Extrae la posición de la esquina superior izquierda del rectángulo en *x1 y *y1, y la posición de la esquina inferior derecha en *x2 y *y2.
Véanse también setCoords() y getRect().
[constexpr] void QRect::getRect(int *x, int *y, int *width, int *height) const
Extrae la posición de la esquina superior izquierda del rectángulo a *x y *y, y sus dimensiones a *width y *height.
Véanse también setRect() y getCoords().
[constexpr noexcept] int QRect::height() const
Devuelve la altura del rectángulo.
Véase también setHeight(), width() y size().
[noexcept] QRect QRect::intersected(const QRect &rectangle) const
Devuelve la intersección de este rectángulo y el rectangle dado. Ten en cuenta que r.intersected(s) es equivalente a r & s.

Véanse también intersects(), united() y operator&=().
[noexcept] bool QRect::intersects(const QRect &rectangle) const
Devuelve ` true ` si este rectángulo se cruza con el dado ` rectangle ` (es decir, si hay al menos un píxel que se encuentra dentro de ambos rectángulos); en caso contrario, devuelve ` false`.
El rectángulo de intersección se puede obtener mediante la función intersected().
Véase también contains().
[constexpr noexcept] bool QRect::isEmpty() const
Devuelve ` true ` si el rectángulo está vacío; en caso contrario, devuelve ` false`.
Un rectángulo vacío tiene un valor de left() > right() o top() > bottom(). Un rectángulo vacío no es válido (es decir, isEmpty() == !isValid()).
Utiliza la función normalized() para obtener un rectángulo en el que se hayan intercambiado las esquinas.
Véase también isNull(), isValid() y normalized().
[constexpr noexcept] bool QRect::isNull() const
Devuelve ` true ` si el rectángulo es un rectángulo nulo; en caso contrario, devuelve ` false`.
Un rectángulo nulo tiene tanto la anchura como la altura establecidas en 0 (es decir, right() == left() - 1 y bottom() == top() - 1). Un rectángulo nulo también está vacío y, por lo tanto, no es válido.
Véanse también isEmpty() y isValid().
[constexpr noexcept] bool QRect::isValid() const
Devuelve ` true ` si el rectángulo es válido; en caso contrario, devuelve ` false`.
Un rectángulo válido cumple que left() <= right() y top() <= bottom(). Ten en cuenta que las operaciones no triviales, como las intersecciones, no están definidas para rectángulos no válidos. Un rectángulo válido no está vacío (es decir, isValid() == !isEmpty()).
Véase también isNull(), isEmpty() y normalized().
[constexpr noexcept] int QRect::left() const
Devuelve la coordenada x del borde izquierdo del rectángulo. Equivalente a x().
Véase también setLeft(), topLeft() y bottomLeft().
[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const
Devuelve un rectángulo ampliado según la función « margins ».
Véase también operator+=(), marginsRemoved() y operator-=().
[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const
Elimina el elemento « margins » del rectángulo, reduciendo su tamaño.
Véase también « marginsAdded()», « operator+=()» y « operator-=()».
[constexpr noexcept] void QRect::moveBottom(int y)
Desplaza el rectángulo verticalmente, dejando el borde inferior del rectángulo en la coordenada y especificada. El tamaño del rectángulo no varía.
Véanse también bottom(), setBottom() y moveTop().
[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)
Mueve el rectángulo, dejando la esquina inferior izquierda en la posición indicada en position. El tamaño del rectángulo no cambia.
Véase también setBottomLeft(), moveBottom() y moveLeft().
[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)
Mueve el rectángulo dejando la esquina inferior derecha en la posición indicada en position. El tamaño del rectángulo no varía.
Véanse también setBottomRight(), moveRight() y moveBottom().
[constexpr noexcept] void QRect::moveCenter(const QPoint &position)
Mueve el rectángulo, manteniendo el punto central en la posición indicada en position. El tamaño del rectángulo no varía.
Véase también center().
[constexpr noexcept] void QRect::moveLeft(int x)
Desplaza el rectángulo horizontalmente, dejando el borde izquierdo del rectángulo en la coordenada x indicada. El tamaño del rectángulo no varía.
Véanse también left(), setLeft() y moveRight().
[constexpr noexcept] void QRect::moveRight(int x)
Desplaza el rectángulo horizontalmente, dejando el borde derecho del rectángulo en la coordenada x especificada. El tamaño del rectángulo no varía.
Véanse también right(), setRight() y moveLeft().
[constexpr noexcept] void QRect::moveTo(const QPoint &position)
Mueve el rectángulo dejando la esquina superior izquierda en la posición indicada: position.
[constexpr noexcept] void QRect::moveTo(int x, int y)
Mueve el rectángulo, manteniendo la esquina superior izquierda en la posición indicada (x, y). El tamaño del rectángulo no cambia.
Véanse también translate() y moveTopLeft().
[constexpr noexcept] void QRect::moveTop(int y)
Mueve el rectángulo verticalmente, dejando el borde superior del rectángulo en la coordenada y indicada. El tamaño del rectángulo no varía.
Véase también top(), setTop() y moveBottom().
[constexpr noexcept] void QRect::moveTopLeft(const QPoint &position)
Mueve el rectángulo, dejando la esquina superior izquierda en la posición indicada en position. El tamaño del rectángulo no cambia.
Véanse también setTopLeft(), moveTop() y moveLeft().
[constexpr noexcept] void QRect::moveTopRight(const QPoint &position)
Mueve el rectángulo, dejando la esquina superior derecha en la posición indicada en position. El tamaño del rectángulo no cambia.
Véanse también setTopRight(), moveTop() y moveRight().
[noexcept] QRect QRect::normalized() const
Devuelve un rectángulo normalizado; es decir, un rectángulo cuya anchura y altura son no negativas.
Si width() < 0, la función intercambia las esquinas izquierda y derecha, y si height() < 0, intercambia las esquinas superior e inferior. Al mismo tiempo, las esquinas pasan de ser no inclusivas a inclusivas.
Véanse también isValid() y isEmpty().
[constexpr noexcept] int QRect::right() const
Devuelve la coordenada x del borde derecho del rectángulo.
Ten en cuenta que, por motivos históricos, esta función devuelve left() + width() - 1; utiliza x() + width() para obtener la verdadera coordenada x.
Véanse también setRight(), topRight() y bottomRight().
[constexpr noexcept] void QRect::setBottom(int y)
Establece el borde inferior del rectángulo en la coordenada y indicada. Puede modificar la altura, pero nunca modificará el borde superior del rectángulo.
Véase también bottom() y moveBottom().
[constexpr noexcept] void QRect::setBottomLeft(const QPoint &position)
Establece la esquina inferior izquierda del rectángulo en la posición indicada: position. Se puede modificar el tamaño, pero la esquina superior derecha del rectángulo nunca cambiará.
Véase también ` bottomLeft()` y ` moveBottomLeft()`.
[constexpr noexcept] void QRect::setBottomRight(const QPoint &position)
Establece la esquina inferior derecha del rectángulo en la posición indicada position. Puede cambiar el tamaño, pero nunca cambiará la esquina superior izquierda del rectángulo.
Véanse también bottomRight() y moveBottomRight().
[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)
Establece las coordenadas de la esquina superior izquierda del rectángulo en (x1, y1) y las de su esquina inferior derecha en (x2, y2).
Véanse también getCoords() y setRect().
[constexpr noexcept] void QRect::setHeight(int height)
Establece la altura del rectángulo en el valor indicado height. Se modifica el borde inferior, pero no el superior.
Véanse también height() y setSize().
[constexpr noexcept] void QRect::setLeft(int x)
Establece el borde izquierdo del rectángulo en la coordenada x especificada. Puede modificar el ancho, pero nunca modificará el borde derecho del rectángulo.
Equivalente a ` setX()`.
Véase también left() y moveLeft().
[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)
Establece las coordenadas de la esquina superior izquierda del rectángulo en (x, y) y su tamaño en los valores indicados width y height.
Véase también getRect() y setCoords().
[constexpr noexcept] void QRect::setRight(int x)
Establece el borde derecho del rectángulo en la coordenada x indicada. Puede modificar el ancho, pero nunca cambiará el borde izquierdo del rectángulo.
Véase también right() y moveRight().
[constexpr noexcept] void QRect::setSize(const QSize &size)
Establece el tamaño del rectángulo en el valor indicado en size. La esquina superior izquierda no se desplaza.
Véase también size(), setWidth() y setHeight().
[constexpr noexcept] void QRect::setTop(int y)
Establece el borde superior del rectángulo en la coordenada y indicada. Puede modificar la altura, pero nunca cambiará el borde inferior del rectángulo.
Equivalente a ` setY()`.
Véase también top() y moveTop().
[constexpr noexcept] void QRect::setTopLeft(const QPoint &position)
Establece la esquina superior izquierda del rectángulo en el valor dado position. Puede cambiar el tamaño, pero nunca modificará la esquina inferior derecha del rectángulo.
Véase también topLeft() y moveTopLeft().
[constexpr noexcept] void QRect::setTopRight(const QPoint &position)
Establece la esquina superior derecha del rectángulo en la posición indicada en position. Puede cambiar el tamaño, pero nunca modificará la esquina inferior izquierda del rectángulo.
Véase también topRight() y moveTopRight().
[constexpr noexcept] void QRect::setWidth(int width)
Establece la anchura del rectángulo en el valor indicado width. Se modifica el borde derecho, pero no el izquierdo.
Véase también width() y setSize().
[constexpr noexcept] void QRect::setX(int x)
Establece el borde izquierdo del rectángulo en la coordenada x especificada. Puede modificar el ancho, pero nunca cambiará el borde derecho del rectángulo.
Equivalente a ` setLeft()`.
Véase también x(), setY() y setTopLeft().
[constexpr noexcept] void QRect::setY(int y)
Establece el borde superior del rectángulo en la coordenada y indicada. Puede modificar la altura, pero nunca cambiará el borde inferior del rectángulo.
Equivalente a ` setTop()`.
Véanse también y(), setX() y setTopLeft().
[constexpr noexcept] QSize QRect::size() const
Devuelve el tamaño del rectángulo.
Véanse también setSize(), width() y height().
[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)
Devuelve un rectángulo que abarca los dos puntos p1 y p2, incluyendo ambos y todo lo que hay entre ellos.
Esta función se introdujo en Qt 6.0.
[noexcept] CGRect QRect::toCGRect() const
Crea un CGRect a partir de un QRect.
Véase también QRectF::fromCGRect().
[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const
Devuelve este rectángulo como un rectángulo con precisión de punto flotante.
Nota: Esta función, al igual que el constructor « QRectF » (QRect), conserva el « size » () del rectángulo, no su « bottomRight » ().
Esta función se introdujo en Qt 6.4.
Véase también QRectF::toRect().
[constexpr noexcept] int QRect::top() const
Devuelve la coordenada y del borde superior del rectángulo. Equivalente a y().
Véase también setTop(), topLeft() y topRight().
[constexpr noexcept] QPoint QRect::topLeft() const
Devuelve la posición de la esquina superior izquierda del rectángulo.
Véase también setTopLeft(), top() y left().
[constexpr noexcept] QPoint QRect::topRight() const
Devuelve la posición de la esquina superior derecha del rectángulo.
Ten en cuenta que, por motivos históricos, esta función devuelve QPoint(left() + width() - 1, top()).
Véanse también setTopRight(), top() y right().
[constexpr noexcept] void QRect::translate(int dx, int dy)
Desplaza el rectángulo dx a lo largo del eje x y dy a lo largo del eje y, con respecto a la posición actual. Los valores positivos desplazan el rectángulo hacia la derecha y hacia abajo.
Véanse también moveTopLeft(), moveTo() y translated().
[constexpr noexcept] void QRect::translate(const QPoint &offset)
Desplaza el rectángulo offset.x() a lo largo del eje x y offset.y() a lo largo del eje y, con respecto a la posición actual.
Se trata de una función sobrecargada.
[constexpr noexcept] QRect QRect::translated(int dx, int dy) const
Devuelve una copia del rectángulo desplazado dx a lo largo del eje x y dy a lo largo del eje y, con respecto a la posición actual. Los valores positivos desplazan el rectángulo hacia la derecha y hacia abajo.
Véase también translate().
[constexpr noexcept] QRect QRect::translated(const QPoint &offset) const
Devuelve una copia del rectángulo desplazado offset.x() a lo largo del eje x y offset.y() a lo largo del eje y, en relación con la posición actual.
Esta es una función sobrecargada.
[constexpr noexcept] QRect QRect::transposed() const
Devuelve una copia del rectángulo en la que se han intercambiado el ancho y la altura:
QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}Véase también ` QSize::transposed()`.
[noexcept] QRect QRect::united(const QRect &rectangle) const
Devuelve el rectángulo delimitador formado por este rectángulo y el dado en rectangle.

Véase también intersected().
[constexpr noexcept] int QRect::width() const
Devuelve la anchura del rectángulo.
Véase también setWidth(), height() y size().
[constexpr noexcept] int QRect::x() const
Devuelve la coordenada x del borde izquierdo del rectángulo. Equivalente a left().
Véase también setX(), y() y topLeft().
[constexpr noexcept] int QRect::y() const
Devuelve la coordenada y del borde superior del rectángulo. Equivalente a ` top()`.
Véase también setY(), x() y topLeft().
[noexcept] QRect QRect::operator&(const QRect &rectangle) const
Devuelve la intersección de este rectángulo y el rectángulo dado rectangle. Devuelve un rectángulo vacío si no hay intersección.
Véase también operator&=() y intersected().
[noexcept] QRect &QRect::operator&=(const QRect &rectangle)
Este rectángulo se cruza con el dado en rectangle.
Véanse también intersected() y operator&().
[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)
Añade el elemento ` margins ` al rectángulo, ampliándolo.
Véase también marginsAdded(), marginsRemoved() y operator-=().
[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)
Devuelve un rectángulo reducido según el « margins ».
Véase también marginsRemoved(), operator+=() y marginsAdded().
[noexcept] QRect QRect::operator|(const QRect &rectangle) const
Devuelve el rectángulo delimitador formado por este rectángulo y el rectangle proporcionado.
Véase también operator|=() y united().
[noexcept] QRect &QRect::operator|=(const QRect &rectangle)
Une este rectángulo con el dado en rectangle.
Elementos no miembros relacionados
[constexpr noexcept] bool operator!=(const QRect &lhs, const QRect &rhs)
Devuelve « true » si los rectángulos lhs y rhs son diferentes; en caso contrario, devuelve « false ».
[constexpr noexcept] QRect operator+(const QRect &rectangle, const QMargins &margins)
Devuelve el ` rectangle ` ampliado por el ` margins`.
[constexpr noexcept] QRect operator+(const QMargins &margins, const QRect &rectangle)
Devuelve el objeto ` rectangle ` ampliado por la función ` margins`.
Esta es una función sobrecargada.
[constexpr noexcept] QRect operator-(const QRect &lhs, const QMargins &rhs)
Devuelve el rectángulo « lhs » reducido en los márgenes « rhs ».
QDataStream &operator<<(QDataStream &stream, const QRect &rectangle)
Escribe el objeto ` rectangle ` especificado en el objeto ` stream` especificado y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
[constexpr noexcept] bool operator==(const QRect &lhs, const QRect &rhs)
Devuelve ` true ` si los rectángulos ` lhs ` y ` rhs ` son iguales; en caso contrario, devuelve ` false`.
QDataStream &operator>>(QDataStream &stream, QRect &rectangle)
Lee un rectángulo desde el archivo « stream » especificado en el archivo « rectangle » especificado, y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.



