QRectF Class

Documentación de las funciones miembro

[constexpr noexcept] QRectF::QRectF()

Construye un rectángulo nulo.

Véase también isNull().

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

Construye un rectángulo QRectF a partir de la dirección QRect rectangle .

Véase también toRect() y QRect::toRectF().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

Construye un rectángulo con las esquinas dadas topLeft y bottomRight.

Véase también setTopLeft() y setBottomRight().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

Construye un rectángulo con la esquina topLeft dada y la size dada.

Véase también setTopLeft() y setSize().

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

Construye un rectángulo con (x, y) como esquina superior izquierda y los width y height dados. 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 finitos.

Véase también adjusted() y setRect().

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

Devuelve un nuevo rectángulo con dx1, dy1, dx2 y dy2 añadidos respectivamente a las coordenadas existentes de este rectángulo. Todos los parámetros deben ser 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 point dado está 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 está dentro de este rectángulo; en caso contrario devuelve false.

[noexcept] bool QRectF::contains(qreal x, qreal y) const

Devuelve true si el punto (x, y) está dentro o en el borde del rectángulo; en caso contrario devuelve false.

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

Crea un QRectF a partir de CGRect rect.

Véase también toCGRect().

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

Convierte el 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 a *x1 y *y1, y la posición de la esquina inferior derecha a *x2 y *y2.

Véase 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éase 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 y el dado rectangle. Observe que r.intersected(s) es equivalente a r & s.

Véase también intersects(), united() y operator&=().

[noexcept] bool QRectF::intersects(const QRectF &rectangle) const

Devuelve true si este rectángulo interseca con el dado rectangle (es decir, hay un área no vacía de superposición entre ellos), de lo contrario devuelve false.

El rectángulo de intersección puede recuperarse utilizando 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()).

Utilice la función normalized() para obtener un rectángulo con las esquinas intercambiadas.

Véase también isNull(), isValid() y normalized().

[constexpr noexcept] bool QRectF::isNull() const

Devuelve true si el rectángulo es nulo, en caso contrario devuelve false.

Un rectángulo nulo tiene tanto la anchura como la altura establecidas 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. Tenga 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] qreal QRectF::left() const

Devuelve la coordenada x del borde izquierdo del rectángulo. Equivale a x().

Véase también setLeft(), topLeft() y bottomLeft().

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

Devuelve un rectángulo crecido por el margins.

Véase también operator+=(), marginsRemoved() y operator-=().

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

Elimina el margins del rectángulo, encogiéndolo.

Véase también marginsAdded(), operator+=() y operator-=().

[constexpr noexcept] void QRectF::moveBottom(qreal y)

Mueve el rectángulo verticalmente, dejando el borde inferior del rectángulo en la coordenada finita y dada. El tamaño del rectángulo no cambia.

Véase 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 dirección position. El tamaño del rectángulo no cambia.

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 dirección position. El tamaño del rectángulo no cambia.

Véase también setBottomRight(), moveBottom() y moveRight().

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

Mueve el rectángulo, dejando el punto central en la dirección position. El tamaño del rectángulo no cambia.

Véase también center().

[constexpr noexcept] void QRectF::moveLeft(qreal x)

Mueve el rectángulo horizontalmente, dejando el borde izquierdo del rectángulo en la coordenada finita x dada. El tamaño del rectángulo no cambia.

Véase también left(), setLeft() y moveRight().

[constexpr noexcept] void QRectF::moveRight(qreal x)

Mueve el rectángulo horizontalmente, dejando el borde derecho del rectángulo en la coordenada finita x dada. El tamaño del rectángulo no cambia.

Véase 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 dada (x, y). El tamaño del rectángulo no cambia. Ambos parámetros deben ser finitos.

Véase también translate() y moveTopLeft().

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

Mueve el rectángulo, dejando la esquina superior izquierda en la dirección position.

[constexpr noexcept] void QRectF::moveTop(qreal y)

Mueve el rectángulo verticalmente, dejando la línea superior del rectángulo en la coordenada finita y dada. El tamaño del rectángulo no cambia.

Véase 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 dirección 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 dirección position. El tamaño del rectángulo no cambia.

Véase también setTopRight(), moveTop() y moveRight().

[noexcept] QRectF QRectF::normalized() const

Devuelve un rectángulo normalizado; es decir, un rectángulo que tiene una anchura y una altura no negativas.

Si width() < 0 la función intercambia las esquinas izquierda y derecha, e intercambia las esquinas superior e inferior si height() < 0.

Véase 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 dada. Puede cambiar la altura, pero nunca cambiará 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 dirección position. Puede cambiar el tamaño, pero nunca cambiará la esquina superior derecha del rectángulo.

Véase también bottomLeft() y moveBottomLeft().

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

Establece la esquina inferior derecha del rectángulo en la dirección 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 coordenadas de su esquina inferior derecha en (x2, y2). Todos los parámetros deben ser finitos.

Véase también getCoords() y setRect().

[constexpr noexcept] void QRectF::setHeight(qreal height)

Establece la altura del rectángulo al valor finito dado height. Se modifica el borde inferior, pero no el superior.

Véase también height() y setSize().

[constexpr noexcept] void QRectF::setLeft(qreal x)

Establece el borde izquierdo del rectángulo en la coordenada finita x dada. Puede cambiar el ancho, pero nunca cambiará el borde derecho del rectángulo.

Equivale 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 width y height. Todos los parámetros deben ser finitos.

Véase también getRect() y setCoords().

[constexpr noexcept] void QRectF::setRight(qreal x)

Establece el borde derecho del rectángulo en la coordenada finita x dada. Puede cambiar 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 al finito dado size. La esquina superior izquierda no se mueve.

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 dada. Puede cambiar la altura, pero nunca cambiará el borde inferior del rectángulo.

Equivale 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 la dirección position. Puede cambiar el tamaño, pero nunca cambiará la esquina inferior derecha del rectángulo.

Véase también topLeft() y moveTopLeft().

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

Establece la esquina superior derecha del rectángulo en la dirección position. Puede cambiar el tamaño, pero nunca cambiará 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 al 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 dada. Puede cambiar el ancho, pero nunca cambiará el borde derecho del rectángulo.

Equivale 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 dada. Puede cambiar la altura, pero nunca cambiará el borde inferior del rectángulo.

Equivale 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 QRect basado en los valores de este rectángulo que es el rectángulo entero más pequeño posible que contiene completamente este rectángulo.

Véase también toRect().

[noexcept] CGRect QRectF::toCGRect() const

Crea un CGRect a partir de 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 QRect basado en los valores de este rectángulo. Tenga en cuenta que las coordenadas del rectángulo devuelto se redondean al entero más próximo.

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. Equivale 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)

Mueve el rectángulo 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 el rectángulo hacia la derecha y hacia abajo. Ambos parámetros deben ser finitos.

Véase también moveTopLeft(), moveTo() y translated().

[constexpr noexcept] void QRectF::translate(const QPointF &offset)

Mueve el rectángulo 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.

[constexpr noexcept] QRectF QRectF::translated(qreal dx, qreal dy) const

Devuelve una copia del rectángulo que se traslada 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 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 trasladado 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.

[constexpr noexcept] QRectF QRectF::transposed() const

Devuelve una copia del rectángulo con su anchura y altura intercambiadas:

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 que delimita este rectángulo y la dirección 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. Equivale 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. Equivale 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 la dirección 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)

Interseca este rectángulo con el dado rectangle.

Véase también intersected() y operator&().

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

Añade el margins al rectángulo, haciéndolo crecer.

Véase también marginsAdded(), marginsRemoved() y operator-=().

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

Devuelve un rectángulo encogido por margins.

Véase también marginsRemoved(), operator+=() y marginsAdded().

[noexcept] QRectF QRectF::operator|(const QRectF &rectangle) const

Devuelve el rectángulo que delimita este rectángulo y la dirección rectangle.

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

[noexcept] QRectF &QRectF::operator|=(const QRectF &rectangle)

Une este rectángulo con el dado rectangle.

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