QSizeF Class
La clase QSizeF define el tamaño de un objeto bidimensional utilizando precisión de coma flotante. Más información...
| Encabezado: | #include <QSizeF> |
| 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
- QSizeF forma parte de las clases de pintura.
Funciones públicas
| QSizeF() | |
| QSizeF(const QSize &size) | |
| QSizeF(qreal width, qreal height) | |
| QSizeF | boundedTo(const QSizeF &otherSize) const |
| QSizeF | expandedTo(const QSizeF &otherSize) const |
| QSizeF | grownBy(QMarginsF margins) const |
| qreal | height() const |
| bool | isEmpty() const |
| bool | isNull() const |
| bool | isValid() const |
| qreal & | rheight() |
| qreal & | rwidth() |
| void | scale(qreal width, qreal height, Qt::AspectRatioMode mode) |
| void | scale(const QSizeF &size, Qt::AspectRatioMode mode) |
| QSizeF | scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const |
| QSizeF | scaled(const QSizeF &s, Qt::AspectRatioMode mode) const |
| void | setHeight(qreal height) |
| void | setWidth(qreal width) |
| QSizeF | shrunkBy(QMarginsF margins) const |
| CGSize | toCGSize() const |
| QSize | toSize() const |
| void | transpose() |
| QSizeF | transposed() const |
| qreal | width() const |
| QSizeF & | operator*=(qreal factor) |
| QSizeF & | operator+=(const QSizeF &size) |
| QSizeF & | operator-=(const QSizeF &size) |
| QSizeF & | operator/=(qreal divisor) |
Miembros públicos estáticos
| QSizeF | fromCGSize(CGSize size) |
Elementos no miembros relacionados
(since 6.8) bool | qFuzzyCompare(const QSizeF &lhs, const QSizeF &rhs) |
(since 6.8) bool | qFuzzyIsNull(const QSizeF &size) |
| bool | operator!=(const QSizeF &lhs, const QSizeF &rhs) |
| QSizeF | operator*(const QSizeF &size, qreal factor) |
| QSizeF | operator*(qreal factor, const QSizeF &size) |
| QSizeF | operator+(const QSizeF &s1, const QSizeF &s2) |
| QSizeF | operator-(const QSizeF &s1, const QSizeF &s2) |
| QSizeF | operator/(const QSizeF &size, qreal divisor) |
| QDataStream & | operator<<(QDataStream &stream, const QSizeF &size) |
| bool | operator==(const QSizeF &lhs, const QSizeF &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QSizeF &size) |
Descripción detallada
El tamaño se especifica mediante las funciones ` width()` y ` height()`. Se puede establecer en el constructor y modificarse mediante las funciones ` setWidth()`, ` setHeight()` o ` scale()`, o bien utilizando operadores aritméticos. El tamaño también se puede manipular directamente recuperando referencias al ancho y a la altura mediante las funciones ` rwidth()` y ` rheight()`. Por último, la anchura y la altura se pueden intercambiar mediante la función ` transpose()`.
La función ` isValid()` determina si un tamaño es válido. Un tamaño válido tiene tanto el ancho como la altura mayores o iguales a cero. La función ` isEmpty()` devuelve ` true ` si el ancho o la altura son menores (o iguales) a cero, mientras que la función ` isNull()` devuelve ` true ` solo si tanto el ancho como la altura son cero.
Utiliza la función expandedTo() para obtener un objeto `size` que contenga la altura y la anchura máximas de este objeto `size` y de un objeto `size` dado. Del mismo modo, la función boundedTo() devuelve un objeto `size` que contenga la altura y la anchura mínimas de este objeto `size` y de un objeto `size` dado.
La clase `QSizeF` también proporciona la función ` toSize()`, que devuelve una copia ` QSize ` de este tamaño, construida redondeando el ancho y la altura a los enteros más cercanos.
Los objetos QSizeF pueden transmitirse por un flujo de datos, así como compararse.
Véase también QSize, QPointF y QRectF.
Documentación de funciones miembro
[constexpr noexcept] QSizeF::QSizeF()
Crea un tamaño no válido.
Véase también isValid().
[constexpr noexcept] QSizeF::QSizeF(const QSize &size)
Crea un valor de tipo «size» con precisión de punto flotante a partir del valor « size » proporcionado.
Véase también toSize() y QSize::toSizeF().
[constexpr noexcept] QSizeF::QSizeF(qreal width, qreal height)
Crea un tamaño con los valores finitos dados width y height.
[constexpr noexcept] QSizeF QSizeF::boundedTo(const QSizeF &otherSize) const
Devuelve un objeto «size» que contiene la anchura y la altura mínimas de este objeto «size» y del objeto « otherSize » indicado.
Véase también expandedTo() y scale().
[constexpr noexcept] QSizeF QSizeF::expandedTo(const QSizeF &otherSize) const
Devuelve un objeto «size» que contiene la anchura y la altura máximas de este «size» y del « otherSize » proporcionado.
Véase también ` boundedTo()` y ` scale()`.
[static noexcept] QSizeF QSizeF::fromCGSize(CGSize size)
Crea un « QSizeF » a partir de size.
Véase también toCGSize().
[constexpr noexcept] QSizeF QSizeF::grownBy(QMarginsF margins) const
Devuelve el tamaño resultante al aumentar este tamaño en margins.
Véase también ` shrunkBy()`.
[constexpr noexcept] qreal QSizeF::height() const
Devuelve la altura.
Véase también width() y setHeight().
[constexpr noexcept] bool QSizeF::isEmpty() const
Devuelve « true » si el ancho o la altura son menores o iguales a 0; en caso contrario, devuelve « false ».
Véase también isNull() y isValid().
[noexcept] bool QSizeF::isNull() const
Devuelve ` true ` si tanto la anchura como la altura son 0,0 (sin tener en cuenta el signo); en caso contrario, devuelve ` false`.
Véase también isValid() y isEmpty().
[constexpr noexcept] bool QSizeF::isValid() const
Devuelve « true » si tanto la anchura como la altura son iguales o mayores que 0; en caso contrario, devuelve « false ».
Véanse también isNull() y isEmpty().
[constexpr noexcept] qreal &QSizeF::rheight()
Devuelve una referencia a la altura.
El uso de una referencia permite manipular la altura directamente. Por ejemplo:
QSizeF size(100, 10.2);
size.rheight() += 5.5;
// size becomes (100,15.7)Véase también rwidth() y setHeight().
[constexpr noexcept] qreal &QSizeF::rwidth()
Devuelve una referencia al ancho.
El uso de una referencia permite manipular el ancho directamente. Por ejemplo:
QSizeF size(100.3, 10);
size.rwidth() += 20.5;
// size becomes (120.8,10)Véase también rheight() y setWidth().
[noexcept] void QSizeF::scale(qreal width, qreal height, Qt::AspectRatioMode mode)
Ajusta el tamaño a un rectángulo con las propiedades « width » y « height » indicadas, de acuerdo con la propiedad « mode » especificada.
- Si mode es Qt::IgnoreAspectRatio, el tamaño se establece en (width, height).
- Si mode es Qt::KeepAspectRatio, el tamaño actual se escala a un rectángulo tan grande como sea posible dentro de (width, height), conservando la relación de aspecto.
- Si mode es Qt::KeepAspectRatioByExpanding, el tamaño actual se escala a un rectángulo lo más pequeño posible en el exterior (width, height), conservando la relación de aspecto.
Ejemplo:
QSizeF t1(10, 12);
t1.scale(60, 60, Qt::IgnoreAspectRatio);
// t1 is (60, 60)
QSizeF t2(10, 12);
t2.scale(60, 60, Qt::KeepAspectRatio);
// t2 is (50, 60)
QSizeF t3(10, 12);
t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
// t3 is (60, 72)Véase también setWidth(), setHeight() y scaled().
[noexcept] void QSizeF::scale(const QSizeF &size, Qt::AspectRatioMode mode)
Ajusta el tamaño a un rectángulo con las dimensiones dadas size, según el mode especificado.
Se trata de una función sobrecargada.
[noexcept] QSizeF QSizeF::scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const
Devuelve un tamaño ajustado a un rectángulo con los valores de « width » y « height » indicados, de acuerdo con el valor especificado en « mode ».
Véase también scale().
[noexcept] QSizeF QSizeF::scaled(const QSizeF &s, Qt::AspectRatioMode mode) const
Devuelve un tamaño ajustado a un rectángulo con las dimensiones indicadas s, de acuerdo con lo especificado en mode.
Se trata de una función sobrecargada.
[constexpr noexcept] void QSizeF::setHeight(qreal height)
Establece la altura en el valor finito especificado height.
Véase también height(), rheight() y setWidth().
[constexpr noexcept] void QSizeF::setWidth(qreal width)
Establece el ancho en el valor finito especificado width.
Véase también width(), rwidth() y setHeight().
[constexpr noexcept] QSizeF QSizeF::shrunkBy(QMarginsF margins) const
Devuelve el tamaño resultante de reducir este tamaño en margins.
Véase también grownBy().
[noexcept] CGSize QSizeF::toCGSize() const
Crea un objeto `CGSize` a partir de un objeto ` QSizeF`.
Véase también fromCGSize().
[constexpr noexcept] QSize QSizeF::toSize() const
Devuelve una copia basada en un entero de este tamaño.
Ten en cuenta que las coordenadas del tamaño devuelto se redondearán al entero más cercano.
Véase también QSizeF() y QSize::toSizeF().
[noexcept] void QSizeF::transpose()
Intercambia los valores de anchura y altura.
Véase también setWidth(), setHeight() y transposed().
[constexpr noexcept] QSizeF QSizeF::transposed() const
Devuelve el tamaño con los valores de anchura y altura intercambiados.
Véase también transpose().
[constexpr noexcept] qreal QSizeF::width() const
Devuelve el ancho.
Véase también height() y setWidth().
[constexpr noexcept] QSizeF &QSizeF::operator*=(qreal factor)
Multiplica tanto la anchura como la altura por el valor finito dado factor y devuelve una referencia al tamaño.
Véase también ` scale()`.
[constexpr noexcept] QSizeF &QSizeF::operator+=(const QSizeF &size)
Añade el ` size ` indicado a este tamaño y devuelve una referencia a este tamaño. Por ejemplo:
[constexpr noexcept] QSizeF &QSizeF::operator-=(const QSizeF &size)
Resta el valor dado ` size ` de este tamaño y devuelve una referencia a este tamaño. Por ejemplo:
QSizeF &QSizeF::operator/=(qreal divisor)
Divide tanto la anchura como la altura por el valor dado divisor y devuelve una referencia al tamaño. El valor divisor no debe ser ni cero ni NaN.
Véase también scale().
Elementos no miembros relacionados
[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QSizeF &lhs, const QSizeF &rhs)
Devuelve « true » si el tamaño « lhs » es aproximadamente igual al tamaño « rhs »; en caso contrario, devuelve « false ».
Los tamaños se consideran aproximadamente iguales si su anchura y altura son aproximadamente iguales.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QSizeF &size)
Devuelve « true » si tanto la anchura como la altura del tamaño « size » son aproximadamente iguales a cero.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept] bool operator!=(const QSizeF &lhs, const QSizeF &rhs)
Devuelve « true » si « 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 difusa para comparar los rangos de los tamaños.
[constexpr noexcept] QSizeF operator*(const QSizeF &size, qreal factor)
Multiplica el ` size ` dado por el ` factor ` finito dado y devuelve el resultado.
Esta es una función sobrecargada.
Véase también ` QSizeF::scale()`.
[constexpr noexcept] QSizeF operator*(qreal factor, const QSizeF &size)
Multiplica el « size » dado por el « factor » finito dado y devuelve el resultado.
Esta es una función sobrecargada.
[constexpr noexcept] QSizeF operator+(const QSizeF &s1, const QSizeF &s2)
Devuelve la suma de s1 y s2; cada componente se suma por separado.
[constexpr noexcept] QSizeF operator-(const QSizeF &s1, const QSizeF &s2)
Devuelve s2 restado de s1; cada componente se resta por separado.
QSizeF operator/(const QSizeF &size, qreal divisor)
Divide el valor dado « size » entre el valor dado « divisor » y devuelve el resultado. El valor « divisor » no debe ser ni cero ni NaN.
Véase también QSizeF::scale().
QDataStream &operator<<(QDataStream &stream, const QSizeF &size)
Escribe el objeto ` size ` 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 QSizeF &lhs, const QSizeF &rhs)
Devuelve « true » si « 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 los tamaños.
Véase también qFuzzyCompare.
QDataStream &operator>>(QDataStream &stream, QSizeF &size)
Lee un valor de tamaño desde el « stream » indicado en el « size » indicado 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.