QSize Class
La clase QSize define el tamaño de un objeto bidimensional utilizando precisión de punto entero. Más información...
| Encabezado: | #include <QSize> |
| 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
- QSize forma parte de las clases de pintura.
Funciones públicas
| QSize() | |
| QSize(int width, int height) | |
| QSize | boundedTo(const QSize &otherSize) const |
| QSize | expandedTo(const QSize &otherSize) const |
| QSize | grownBy(QMargins margins) const |
| int | height() const |
| bool | isEmpty() const |
| bool | isNull() const |
| bool | isValid() const |
| int & | rheight() |
| int & | rwidth() |
| void | scale(int width, int height, Qt::AspectRatioMode mode) |
| void | scale(const QSize &size, Qt::AspectRatioMode mode) |
| QSize | scaled(int width, int height, Qt::AspectRatioMode mode) const |
| QSize | scaled(const QSize &s, Qt::AspectRatioMode mode) const |
| void | setHeight(int height) |
| void | setWidth(int width) |
| QSize | shrunkBy(QMargins margins) const |
| CGSize | toCGSize() const |
(since 6.4) QSizeF | toSizeF() const |
| void | transpose() |
| QSize | transposed() const |
| int | width() const |
| QSize & | operator*=(qreal factor) |
| QSize & | operator+=(const QSize &size) |
| QSize & | operator-=(const QSize &size) |
| QSize & | operator/=(qreal divisor) |
Elementos no miembros relacionados
| bool | operator!=(const QSize &lhs, const QSize &rhs) |
| QSize | operator*(const QSize &size, qreal factor) |
| QSize | operator*(qreal factor, const QSize &size) |
| QSize | operator+(const QSize &s1, const QSize &s2) |
| QSize | operator-(const QSize &s1, const QSize &s2) |
| QSize | operator/(const QSize &size, qreal divisor) |
| QDataStream & | operator<<(QDataStream &stream, const QSize &size) |
| bool | operator==(const QSize &lhs, const QSize &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QSize &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, el ancho y la altura pueden intercambiarse utilizando la función ` transpose()`.
La función ` isValid()` determina si un tamaño es válido (un tamaño válido tiene tanto la anchura como la altura mayores o iguales a cero). La función ` isEmpty()` devuelve ` true ` si la anchura o la altura son menores o iguales a cero, mientras que la función ` isNull()` devuelve ` true ` solo si tanto la anchura 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.
Los objetos `QSize` pueden transmitirse y compararse.
Véase también QSizeF, QPoint y QRect.
Documentación de las funciones de miembro
[constexpr noexcept] QSize::QSize()
Crea un objeto «size» con un ancho y una altura no válidos (es decir, isValid() devuelve false).
Véase también isValid().
[constexpr noexcept] QSize::QSize(int width, int height)
Crea un objeto de tamaño con los valores indicados en width y height.
Véanse también setWidth() y setHeight().
[constexpr noexcept] QSize QSize::boundedTo(const QSize &otherSize) const
Devuelve un objeto «size» que contiene la anchura y la altura mínimas de este objeto «size» y del objeto « otherSize » proporcionado.
Véanse también expandedTo() y scale().
[constexpr noexcept] QSize QSize::expandedTo(const QSize &otherSize) const
Devuelve un objeto «size» que contiene la anchura y la altura máximas de este objeto «size» y del objeto « otherSize » proporcionado.
Véase también ` boundedTo()` y ` scale()`.
[constexpr noexcept] QSize QSize::grownBy(QMargins margins) const
Devuelve el tamaño resultante al aumentar este tamaño en margins.
Véase también ` shrunkBy()`.
[constexpr noexcept] int QSize::height() const
Devuelve la altura.
Véase también width() y setHeight().
[constexpr noexcept] bool QSize::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().
[constexpr noexcept] bool QSize::isNull() const
Devuelve « true » si tanto el ancho como la altura son 0; en caso contrario, devuelve «false».
Véase también isValid() y isEmpty().
[constexpr noexcept] bool QSize::isValid() const
Devuelve « true » si tanto el ancho como la altura son iguales o mayores que 0; en caso contrario, devuelve « false ».
Véase también isNull() y isEmpty().
[constexpr noexcept] int &QSize::rheight()
Devuelve una referencia a la altura.
El uso de una referencia permite manipular la altura directamente. Por ejemplo:
QSize size(100, 10);
size.rheight() += 5;
// size becomes (100,15)Véase también rwidth() y setHeight().
[constexpr noexcept] int &QSize::rwidth()
Devuelve una referencia al ancho.
El uso de una referencia permite manipular el ancho directamente. Por ejemplo:
QSize size(100, 10);
size.rwidth() += 20;
// size becomes (120,10)Véase también rheight() y setWidth().
[noexcept] void QSize::scale(int width, int 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 lo más grande 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:
QSize t1(10, 12);
t1.scale(60, 60, Qt::IgnoreAspectRatio);
// t1 is (60, 60)
QSize t2(10, 12);
t2.scale(60, 60, Qt::KeepAspectRatio);
// t2 is (50, 60)
QSize t3(10, 12);
t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
// t3 is (60, 72)Véase también setWidth(), setHeight() y scaled().
[noexcept] void QSize::scale(const QSize &size, Qt::AspectRatioMode mode)
Ajusta el tamaño a un rectángulo con las coordenadas dadas size, según el ángulo especificado mode.
Se trata de una función sobrecargada.
[noexcept] QSize QSize::scaled(int width, int height, Qt::AspectRatioMode mode) const
Devuelve un tamaño ajustado a un rectángulo con los valores dados en « width » y « height », de acuerdo con el valor especificado en « mode ».
Véase también scale().
[noexcept] QSize QSize::scaled(const QSize &s, Qt::AspectRatioMode mode) const
Devuelve un rectángulo con las dimensiones indicadas s, ajustado según el valor especificado en mode.
Esta es una función sobrecargada.
[constexpr noexcept] void QSize::setHeight(int height)
Establece la altura en el valor indicado: height.
Véase también rheight(), height() y setWidth().
[constexpr noexcept] void QSize::setWidth(int width)
Establece el ancho en el valor indicado en width.
Véase también rwidth(), width() y setHeight().
[constexpr noexcept] QSize QSize::shrunkBy(QMargins margins) const
Devuelve el tamaño resultante de reducir este tamaño en margins.
Véase también grownBy().
[noexcept] CGSize QSize::toCGSize() const
Crea un objeto `CGSize` a partir de un objeto ` QSize`.
Véase también QSizeF::fromCGSize().
[constexpr noexcept, since 6.4] QSizeF QSize::toSizeF() const
Devuelve este tamaño como un valor de tamaño con precisión de punto flotante.
Esta función se introdujo en Qt 6.4.
Véase también QSizeF::toSize().
[noexcept] void QSize::transpose()
Intercambia los valores de anchura y altura.
Véase también setWidth(), setHeight() y transposed().
[constexpr noexcept] QSize QSize::transposed() const
Devuelve un objeto ` QSize ` con el ancho y la altura intercambiados.
Véase también transpose().
[constexpr noexcept] int QSize::width() const
Devuelve el ancho.
Véase también height() y setWidth().
[constexpr noexcept] QSize &QSize::operator*=(qreal factor)
Multiplica tanto la anchura como la altura por el valor dado factor y devuelve una referencia al tamaño.
Ten en cuenta que el resultado se redondea al entero más cercano.
Véase también ` scale()`.
[constexpr noexcept] QSize &QSize::operator+=(const QSize &size)
Suma el valor de « size » especificado a este tamaño y devuelve una referencia a este tamaño. Por ejemplo:
[constexpr noexcept] QSize &QSize::operator-=(const QSize &size)
Resta el valor dado ` size ` de este tamaño y devuelve una referencia a este tamaño. Por ejemplo:
QSize &QSize::operator/=(qreal divisor)
Divide tanto la anchura como la altura por el valor dado divisor y devuelve una referencia al tamaño.
Ten en cuenta que el resultado se redondea al entero más cercano.
Véase también QSize::scale().
Elementos no miembros relacionados
[constexpr noexcept] bool operator!=(const QSize &lhs, const QSize &rhs)
Devuelve « true » si « lhs » y « rhs » son diferentes; en caso contrario, devuelve « false ».
[constexpr noexcept] QSize operator*(const QSize &size, qreal factor)
Multiplica el valor dado size por el valor dado factor y devuelve el resultado redondeado al entero más cercano.
Véase también QSize::scale().
[constexpr noexcept] QSize operator*(qreal factor, const QSize &size)
Multiplica el valor dado size por el valor dado factor y devuelve el resultado redondeado al entero más cercano.
Esta es una función sobrecargada.
[constexpr noexcept] QSize operator+(const QSize &s1, const QSize &s2)
Devuelve la suma de s1 y s2; cada componente se suma por separado.
[constexpr noexcept] QSize operator-(const QSize &s1, const QSize &s2)
Devuelve s2 restado de s1; cada componente se resta por separado.
QSize operator/(const QSize &size, qreal divisor)
Divide el valor dado size por el valor dado divisor y devuelve el resultado redondeado al entero más cercano.
Véase también QSize::scale().
QDataStream &operator<<(QDataStream &stream, const QSize &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 QSize &lhs, const QSize &rhs)
Devuelve ` true ` si ` lhs ` y ` rhs ` son iguales; en caso contrario, devuelve ` false`.
QDataStream &operator>>(QDataStream &stream, QSize &size)
Lee un tamaño desde el archivo « stream » especificado en el archivo « size » 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.