QRectF Class
La clase QRectF define un rectángulo finito en el plano utilizando precisión de coma flotante. Más información...
| Encabezado: | #include <QRectF> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QRectF forma parte de las clases de pintura.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QRectF
| Categoría | Tipos comparables |
|---|---|
| igualdad | QRectF |
| igualdad | QRect. |
Funciones públicas
| QRectF() | |
| QRectF(const QRect &rectangle) | |
| QRectF(const QPointF &topLeft, const QPointF &bottomRight) | |
| QRectF(const QPointF &topLeft, const QSizeF &size) | |
| QRectF(qreal x, qreal y, qreal width, qreal height) | |
| void | adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2) |
| QRectF | adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const |
| qreal | bottom() const |
| QPointF | bottomLeft() const |
| QPointF | bottomRight() const |
| QPointF | center() const |
| bool | contains(const QPointF &point) const |
| bool | contains(const QRectF &rectangle) const |
| bool | contains(qreal x, qreal y) const |
| void | getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const |
| void | getRect(qreal *x, qreal *y, qreal *width, qreal *height) const |
| qreal | height() const |
| QRectF | intersected(const QRectF &rectangle) const |
| bool | intersects(const QRectF &rectangle) const |
| bool | isEmpty() const |
| bool | isNull() const |
| bool | isValid() const |
| qreal | left() const |
| QRectF | marginsAdded(const QMarginsF &margins) const |
| QRectF | marginsRemoved(const QMarginsF &margins) const |
| void | moveBottom(qreal y) |
| void | moveBottomLeft(const QPointF &position) |
| void | moveBottomRight(const QPointF &position) |
| void | moveCenter(const QPointF &position) |
| void | moveLeft(qreal x) |
| void | moveRight(qreal x) |
| void | moveTo(qreal x, qreal y) |
| void | moveTo(const QPointF &position) |
| void | moveTop(qreal y) |
| void | moveTopLeft(const QPointF &position) |
| void | moveTopRight(const QPointF &position) |
| QRectF | normalized() const |
| qreal | right() const |
| void | setBottom(qreal y) |
| void | setBottomLeft(const QPointF &position) |
| void | setBottomRight(const QPointF &position) |
| void | setCoords(qreal x1, qreal y1, qreal x2, qreal y2) |
| void | setHeight(qreal height) |
| void | setLeft(qreal x) |
| void | setRect(qreal x, qreal y, qreal width, qreal height) |
| void | setRight(qreal x) |
| void | setSize(const QSizeF &size) |
| void | setTop(qreal y) |
| void | setTopLeft(const QPointF &position) |
| void | setTopRight(const QPointF &position) |
| void | setWidth(qreal width) |
| void | setX(qreal x) |
| void | setY(qreal y) |
| QSizeF | size() const |
| QRect | toAlignedRect() const |
| CGRect | toCGRect() const |
(since 6.5) emscripten::val | toDOMRect() const |
| QRect | toRect() const |
| qreal | top() const |
| QPointF | topLeft() const |
| QPointF | topRight() const |
| void | translate(qreal dx, qreal dy) |
| void | translate(const QPointF &offset) |
| QRectF | translated(qreal dx, qreal dy) const |
| QRectF | translated(const QPointF &offset) const |
| QRectF | transposed() const |
| QRectF | united(const QRectF &rectangle) const |
| qreal | width() const |
| qreal | x() const |
| qreal | y() const |
| QRectF | operator&(const QRectF &rectangle) const |
| QRectF & | operator&=(const QRectF &rectangle) |
| QRectF & | operator+=(const QMarginsF &margins) |
| QRectF & | operator-=(const QMarginsF &margins) |
| QRectF | operator|(const QRectF &rectangle) const |
| QRectF & | operator|=(const QRectF &rectangle) |
Miembros públicos estáticos
| QRectF | fromCGRect(CGRect rect) |
(since 6.5) QRectF | fromDOMRect(emscripten::val domRect) |
Elementos no miembros relacionados
(since 6.8) bool | qFuzzyCompare(const QRectF &lhs, const QRectF &rhs) |
(since 6.8) bool | qFuzzyIsNull(const QRectF &rect) |
| bool | operator!=(const QRectF &lhs, const QRectF &rhs) |
| QRectF | operator+(const QRectF &lhs, const QMarginsF &rhs) |
| QRectF | operator+(const QMarginsF &lhs, const QRectF &rhs) |
| QRectF | operator-(const QRectF &lhs, const QMarginsF &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QRectF &rectangle) |
| bool | operator==(const QRectF &lhs, const QRectF &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QRectF &rectangle) |
Descripción detallada
Un rectángulo se expresa normalmente mediante una esquina superior izquierda y un tamaño. El tamaño (anchura y altura) de un QRectF es siempre equivalente al rectángulo matemático que sirve de base para su representación.
Un QRectF puede crearse a partir de un conjunto de coordenadas de izquierda, parte superior, anchura y altura, o a partir de un ` QPointF ` y un ` QSizeF`. El siguiente código crea dos rectángulos idénticos.
También existe un tercer constructor que crea un QRectF a partir de un ` QRect`, y una función correspondiente ` toRect()` que devuelve un objeto ` QRect ` basado en los valores de este rectángulo (ten en cuenta que las coordenadas del rectángulo devuelto se redondean al entero más cercano).
La clase QRectF proporciona un conjunto de funciones que devuelven las distintas coordenadas del rectángulo y permiten manipularlas. QRectF también proporciona funciones para desplazar el rectángulo en relación con 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 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 QSizeF. Las dimensiones también se pueden obtener por separado mediante las funciones width() y height(). Para manipular las dimensiones, utilice las funciones setSize(), setWidth() o setHeight(). Como alternativa, 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 (en caso contrario, devuelve `false`). La clase `QRectF` 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 envuelve al rectángulo dado y a este:
La función isEmpty() devuelve true si la anchura o la altura del rectángulo es menor o igual a 0. Ten en cuenta que un rectángulo vacío no es válido: la función isValid() devuelve true si tanto la anchura como la altura son mayores que 0. Por otro lado, un rectángulo nulo (isNull() == true) tiene tanto la anchura como la altura establecidas en 0.
Tenga en cuenta que, debido a la forma en que se definen QRect y QRectF, un QRectF vacío se define esencialmente de la misma manera que QRect.
Por último, los objetos QRectF pueden transmitirse y compararse.
Representación
Al utilizar un pintor de tipo « anti-aliased », la línea delimitadora de un QRectF 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 QRectF 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 QRectF ofrece un conjunto de funciones que devuelven las distintas coordenadas del rectángulo y permiten manipularlas. QRectF también proporciona funciones para desplazar el rectángulo en relación con las distintas coordenadas.
Por ejemplo: las funciones « bottom()», « setBottom()» y « moveBottom()»: « bottom()» devuelve la coordenada y del borde inferior del rectángulo, « setBottom » () establece el borde inferior del rectángulo en la coordenada y dada (puede cambiar la altura, pero nunca modificará el borde superior del rectángulo) y moveBottom() desplaza todo el rectángulo verticalmente, manteniendo el borde inferior del rectángulo en la coordenada y dada y sin alterar su tamaño.

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 el ancho o la altura son negativos, utilice la función normalized() para obtener un rectángulo en el que las esquinas estén intercambiadas.
Además, QRectF 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.
Véase también QRect y QRegion.
Documentación de las funciones de miembro
[constexpr noexcept] QRectF::QRectF()
Crea un rectángulo nulo.
Véase también isNull().
[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)
Crea un rectángulo QRectF a partir de los valores proporcionados por QRect rectangle .
Nota: Esta función, al igual que ` QRect::toRectF()`, conserva el ` size()` de ` rectangle`, no su esquina ` bottomRight()`.
Véanse también toRect() y QRect::toRectF().
[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)
Crea un rectángulo con las esquinas dadas en topLeft y bottomRight.
Véanse también setTopLeft() y setBottomRight().
[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)
Crea un rectángulo con la esquina especificada en topLeft y el valor especificado en size.
Véanse también setTopLeft() y setSize().
[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)
Crea un rectángulo con (x, y) como esquina superior izquierda y los valores dados width y height. Todos los parámetros deben ser finitos.
Véase también setRect().
[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)
Añade dx1, dy1, dx2 y dy2, respectivamente, a las coordenadas existentes del rectángulo. Todos los parámetros deben ser valores finitos.
Véanse también adjusted() y setRect().
[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal 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. Todos los parámetros deben ser valores finitos.
Véase también adjust().
[constexpr noexcept] qreal QRectF::bottom() const
Devuelve la coordenada y del borde inferior del rectángulo.
Véase también setBottom(), bottomLeft() y bottomRight().
[constexpr noexcept] QPointF QRectF::bottomLeft() const
Devuelve la posición de la esquina inferior izquierda del rectángulo.
Véase también setBottomLeft(), bottom() y left().
[constexpr noexcept] QPointF QRectF::bottomRight() const
Devuelve la posición de la esquina inferior derecha del rectángulo.
Véase también setBottomRight(), bottom() y right().
[constexpr noexcept] QPointF QRectF::center() const
Devuelve el punto central del rectángulo.
Véase también ` moveCenter()`.
[noexcept] bool QRectF::contains(const QPointF &point) const
Devuelve ` true ` si el punto dado ` point ` se encuentra dentro o en el borde del rectángulo; en caso contrario, devuelve ` false`.
Véase también intersects().
[noexcept] bool QRectF::contains(const QRectF &rectangle) const
Devuelve ` true ` si el ` rectangle ` dado se encuentra dentro de este rectángulo; en caso contrario, devuelve ` false`.
Esta es una función sobrecargada.
[noexcept] bool QRectF::contains(qreal x, qreal y) const
Devuelve ` true ` si el punto (x, y) se encuentra dentro o en el borde del rectángulo; en caso contrario, devuelve ` false`.
Esta es una función sobrecargada.
[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)
Crea un ` QRectF ` a partir de un `CGRect` rect.
Véase también toCGRect().
[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)
Convierte el objeto DOMRect (https://www.w3.org/TR/geometry-1/) domRect en QRectF. El comportamiento es indefinido si el parámetro proporcionado no es un DOMRect.
Esta función se introdujo en Qt 6.5.
Véase también toDOMRect().
[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *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 QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *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] qreal QRectF::height() const
Devuelve la altura del rectángulo.
Véase también setHeight(), width() y size().
[noexcept] QRectF QRectF::intersected(const QRectF &rectangle) const
Devuelve la intersección de este rectángulo con 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 QRectF::intersects(const QRectF &rectangle) const
Devuelve ` true ` si este rectángulo se cruza con el dado ` rectangle ` (es decir, si hay un área de solapamiento no vacía entre ambos); de lo 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 QRectF::isEmpty() const
Devuelve ` true ` si el rectángulo está vacío; en caso contrario, devuelve ` false`.
Un rectángulo vacío tiene width() <= 0 o height() <= 0. 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 QRectF::isNull() const
Devuelve « true » si el rectángulo es un rectángulo nulo; en caso contrario, devuelve « false ».
Un rectángulo nulo tiene tanto el ancho como la altura establecidos en 0. Un rectángulo nulo también está vacío y, por lo tanto, no es válido.
Véase también isEmpty() y isValid().
[constexpr noexcept] bool QRectF::isValid() const
Devuelve ` true ` si el rectángulo es válido; en caso contrario, devuelve ` false`.
Un rectángulo válido tiene width() > 0 y height() > 0. 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éanse también isNull(), isEmpty() y normalized().
[constexpr noexcept] qreal QRectF::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] QRectF QRectF::marginsAdded(const QMarginsF &margins) const
Devuelve un rectángulo ampliado según la función « margins ».
Véanse también operator+=(), marginsRemoved() y operator-=().
[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const
Elimina el « margins » del rectángulo, reduciendo su tamaño.
Véase también « marginsAdded()», « operator+=()» y « operator-=()».
[constexpr noexcept] void QRectF::moveBottom(qreal y)
Desplaza el rectángulo verticalmente, dejando el borde inferior del rectángulo en la coordenada finita y especificada. El tamaño del rectángulo no varía.
Véanse también bottom(), setBottom() y moveTop().
[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)
Mueve el rectángulo, dejando la esquina inferior izquierda en la posición indicada en position. El tamaño del rectángulo no varía.
Véase también setBottomLeft(), moveBottom() y moveLeft().
[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &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(), moveBottom() y moveRight().
[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)
Mueve el rectángulo, manteniendo el punto central en la coordenada dada position. El tamaño del rectángulo no varía.
Véase también center().
[constexpr noexcept] void QRectF::moveLeft(qreal x)
Desplaza el rectángulo horizontalmente, dejando el borde izquierdo del rectángulo en la coordenada finita x especificada. El tamaño del rectángulo no varía.
Véanse también left(), setLeft() y moveRight().
[constexpr noexcept] void QRectF::moveRight(qreal x)
Desplaza el rectángulo horizontalmente, dejando el borde derecho del rectángulo en la coordenada finita x especificada. El tamaño del rectángulo no varía.
Véanse también right(), setRight() y moveLeft().
[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)
Mueve el rectángulo, dejando la esquina superior izquierda en la posición indicada (x, y). El tamaño del rectángulo no varía. Ambos parámetros deben ser valores finitos.
Véanse también translate() y moveTopLeft().
[constexpr noexcept] void QRectF::moveTo(const QPointF &position)
Desplaza el rectángulo, manteniendo la esquina superior izquierda en la posición indicada: position.
Esta es una función sobrecargada.
[constexpr noexcept] void QRectF::moveTop(qreal y)
Mueve el rectángulo verticalmente, dejando el borde superior del rectángulo en la coordenada finita y especificada. El tamaño del rectángulo no varía.
Véanse también top(), setTop() y moveBottom().
[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &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éase también setTopLeft(), moveTop() y moveLeft().
[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)
Mueve el rectángulo dejando la esquina superior derecha en la posición especificada en position. El tamaño del rectángulo no varía.
Véanse también setTopRight(), moveTop() y moveRight().
[noexcept] QRectF QRectF::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.
Véanse también isValid() y isEmpty().
[constexpr noexcept] qreal QRectF::right() const
Devuelve la coordenada x del borde derecho del rectángulo.
Véase también setRight(), topRight() y bottomRight().
[constexpr noexcept] void QRectF::setBottom(qreal y)
Establece el borde inferior del rectángulo en la coordenada finita 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 QRectF::setBottomLeft(const QPointF &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 QRectF::setBottomRight(const QPointF &position)
Establece la esquina inferior derecha del rectángulo en el punto dado position. Puede cambiar el tamaño, pero nunca cambiará la esquina superior izquierda del rectángulo.
Véase también bottomRight() y moveBottomRight().
[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal 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). Todos los parámetros deben ser valores finitos.
Véanse también getCoords() y setRect().
[constexpr noexcept] void QRectF::setHeight(qreal height)
Establece la altura del rectángulo en el valor finito dado height. Se modifica el borde inferior, pero no el superior.
Véanse también height() y setSize().
[constexpr noexcept] void QRectF::setLeft(qreal x)
Establece el borde izquierdo del rectángulo en la coordenada finita 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 QRectF::setRect(qreal x, qreal y, qreal width, qreal 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. Todos los parámetros deben ser valores finitos.
Véanse también getRect() y setCoords().
[constexpr noexcept] void QRectF::setRight(qreal x)
Establece el borde derecho del rectángulo en la coordenada finita 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 QRectF::setSize(const QSizeF &size)
Establece el tamaño del rectángulo en el valor finito dado size. La esquina superior izquierda no se desplaza.
Véase también size(), setWidth() y setHeight().
[constexpr noexcept] void QRectF::setTop(qreal y)
Establece el borde superior del rectángulo en la coordenada finita y especificada. 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 QRectF::setTopLeft(const QPointF &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éanse también topLeft() y moveTopLeft().
[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)
Establece la esquina superior derecha del rectángulo en el valor dado 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 QRectF::setWidth(qreal width)
Establece la anchura del rectángulo en el valor finito dado width. Se modifica el borde derecho, pero no el izquierdo.
Véase también width() y setSize().
[constexpr noexcept] void QRectF::setX(qreal x)
Establece el borde izquierdo del rectángulo en la coordenada finita x especificada. Puede modificar el ancho, pero nunca modificará el borde derecho del rectángulo.
Equivalente a ` setLeft()`.
Véase también x(), setY() y setTopLeft().
[constexpr noexcept] void QRectF::setY(qreal y)
Establece el borde superior del rectángulo en la coordenada finita y especificada. Puede modificar la altura, pero nunca modificará el borde inferior del rectángulo.
Equivalente a ` setTop()`.
Véase también y(), setX() y setTopLeft().
[constexpr noexcept] QSizeF QRectF::size() const
Devuelve el tamaño del rectángulo.
Véase también setSize(), width() y height().
[noexcept] QRect QRectF::toAlignedRect() const
Devuelve un objeto ` QRect ` basado en los valores de este rectángulo, que es el rectángulo entero más pequeño posible que contiene por completo a este rectángulo.
Véase también ` toRect()`.
[noexcept] CGRect QRectF::toCGRect() const
Crea un CGRect a partir de un ` QRectF`.
Véase también fromCGRect().
[since 6.5] emscripten::val QRectF::toDOMRect() const
Convierte este objeto en un DOMRect (https://www.w3.org/TR/geometry-1/).
Esta función se introdujo en Qt 6.5.
Véase también fromDOMRect().
[constexpr noexcept] QRect QRectF::toRect() const
Devuelve un objeto ` QRect ` basado en los valores de este rectángulo. Ten en cuenta que las coordenadas del rectángulo devuelto se redondean al entero más cercano.
Véase también QRectF(), toAlignedRect() y QRect::toRectF().
[constexpr noexcept] qreal QRectF::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] QPointF QRectF::topLeft() const
Devuelve la posición de la esquina superior izquierda del rectángulo.
Véase también setTopLeft(), top() y left().
[constexpr noexcept] QPointF QRectF::topRight() const
Devuelve la posición de la esquina superior derecha del rectángulo.
Véase también setTopRight(), top() y right().
[constexpr noexcept] void QRectF::translate(qreal dx, qreal 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. Ambos parámetros deben ser finitos.
Véanse también moveTopLeft(), moveTo() y translated().
[constexpr noexcept] void QRectF::translate(const QPointF &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] QRectF QRectF::translated(qreal dx, qreal 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. Ambos parámetros deben ser finitos.
Véase también translate().
[constexpr noexcept] QRectF QRectF::translated(const QPointF &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, con respecto a la posición actual.
Esta es una función sobrecargada.
[constexpr noexcept] QRectF QRectF::transposed() const
Devuelve una copia del rectángulo en la que se han intercambiado el ancho y el alto:
QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}Véase también QSizeF::transposed().
[noexcept] QRectF QRectF::united(const QRectF &rectangle) const
Devuelve el rectángulo delimitador formado por este rectángulo y el dado en rectangle.

Véase también intersected().
[constexpr noexcept] qreal QRectF::width() const
Devuelve la anchura del rectángulo.
Véase también setWidth(), height() y size().
[constexpr noexcept] qreal QRectF::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] qreal QRectF::y() const
Devuelve la coordenada y del borde superior del rectángulo. Equivalente a top().
Véase también setY(), x() y topLeft().
[noexcept] QRectF QRectF::operator&(const QRectF &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] QRectF &QRectF::operator&=(const QRectF &rectangle)
Este rectángulo se cruza con el dado en rectangle.
Véase también intersected() y operator&().
[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)
Añade el elemento « margins » al rectángulo, ampliándolo.
Véase también marginsAdded(), marginsRemoved() y operator-=().
[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)
Devuelve un rectángulo reducido según la función « margins ».
Véase también marginsRemoved(), operator+=() y marginsAdded().
[noexcept] QRectF QRectF::operator|(const QRectF &rectangle) const
Devuelve el rectángulo delimitador formado por este rectángulo y el rectangle dado.
Véase también ` united()` y ` operator|=()`.
[noexcept] QRectF &QRectF::operator|=(const QRectF &rectangle)
Une este rectángulo con el dado en rectangle.
Elementos relacionados que no son miembros
[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QRectF &lhs, const QRectF &rhs)
Devuelve ` true ` si el rectángulo ` lhs ` es aproximadamente igual al rectángulo ` rhs`; en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QRectF &rect)
Devuelve ` true ` si tanto la anchura como la altura del rectángulo ` rect ` son aproximadamente iguales a cero; en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept] bool operator!=(const QRectF &lhs, const QRectF &rhs)
Devuelve « true » si los rectángulos lhs y rhs son lo suficientemente diferentes; en caso contrario, devuelve « false ».
Advertencia: esta función no comprueba la desigualdad estricta; en su lugar, utiliza una comparación aproximada para comparar las coordenadas de los rectángulos.
[constexpr noexcept] QRectF operator+(const QRectF &lhs, const QMarginsF &rhs)
Devuelve el rectángulo ` lhs ` ampliado con los márgenes ` rhs `.
[constexpr noexcept] QRectF operator+(const QMarginsF &lhs, const QRectF &rhs)
Devuelve el rectángulo ` lhs ` ampliado con los márgenes ` rhs `.
Esta es una función sobrecargada.
[constexpr noexcept] QRectF operator-(const QRectF &lhs, const QMarginsF &rhs)
Devuelve el rectángulo « lhs » reducido en los márgenes « rhs ».
QDataStream &operator<<(QDataStream &stream, const QRectF &rectangle)
Escribe el objeto ` rectangle ` en el objeto ` stream` y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
[constexpr noexcept] bool operator==(const QRectF &lhs, const QRectF &rhs)
Devuelve « true » si los rectángulos lhs y rhs son aproximadamente iguales; en caso contrario, devuelve « false ».
Advertencia: Esta función no comprueba la igualdad estricta; en su lugar, utiliza una comparación aproximada para comparar las coordenadas de los rectángulos.
Véase también qFuzzyCompare.
QDataStream &operator>>(QDataStream &stream, QRectF &rectangle)
Lee un objeto ` rectangle ` desde el ` stream` 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.



