En esta página

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

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)
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:

QSize s( 3, 7);
QSize r(-1, 4);
s += r;

// s becomes (2,11)

[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 s( 3, 7);
QSize r(-1, 4);
s -= r;

// s becomes (4,3)

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.