QSize Class

成员函数文档

[constexpr noexcept] QSize QSize::grownBy(QMargins margins) const

返回此大小增长margins 后的大小。

另请参阅 shrunkBy() 。

[constexpr noexcept] QSize QSize::shrunkBy(QMargins margins) const

返回将此大小缩小margins 后的大小。

另请参阅 grownBy() 。

[constexpr noexcept] QSize::QSize()

构造一个宽度和高度无效的 size（即isValid() 返回false ）。

另请参阅 isValid() 。

[constexpr noexcept] QSize::QSize(int width, int height)

用给定的width 和height 构建大小。

另请参阅 setWidth() 和setHeight() 。

[constexpr noexcept] QSize QSize::boundedTo(const QSize &otherSize) const

返回一个尺寸，其中包含此尺寸和给定otherSize 的最小宽度和高度。

另请参阅 expandedTo() 和scale()。

[constexpr noexcept] QSize QSize::expandedTo(const QSize &otherSize) const

返回一个尺寸，其中包含此尺寸和给定otherSize 的最大宽度和高度。

另请参阅 boundedTo() 和scale()。

[constexpr noexcept] int QSize::height() const

返回高度。

另请参阅 width() 和setHeight()。

[constexpr noexcept] bool QSize::isEmpty() const

如果宽度和高度小于或等于 0，则返回true ；否则返回false 。

另请参见 isNull() 和isValid()。

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

如果宽度和高度均为 0，则返回true ；否则返回 false。

另请参阅 isValid() 和isEmpty()。

[constexpr noexcept] bool QSize::isValid() const

如果宽度和高度都等于或大于 0，则返回true ；否则返回false 。

另请参见 isNull() 和isEmpty()。

[constexpr noexcept] int &QSize::rheight()

返回高度的引用。

使用引用可以直接操作高度。例如

QSize size(100, 10);
size.rheight() += 5;

// size becomes (100,15)

另请参见 rwidth() 和setHeight()。

[constexpr noexcept] int &QSize::rwidth()

返回宽度的引用。

使用引用可以直接操作宽度。例如

QSize size(100, 10);
size.rwidth() += 20;

// size becomes (120,10)

另请参见 rheight() 和setWidth()。

[noexcept] void QSize::scale(int width, int height, Qt::AspectRatioMode mode)

根据给定的width 和height ，按照指定的mode ，将大小缩放为一个矩形：

• 如果mode 是Qt::IgnoreAspectRatio ，则大小设置为 (width,height)。
• 如果mode 是Qt::KeepAspectRatio ，当前大小将按比例缩放到 (width,height) 内尽可能大的矩形中，并保留长宽比。
• 如果mode 是Qt::KeepAspectRatioByExpanding ，则当前大小将被缩放到 (width,height) 外尽可能小的矩形内，并保持长宽比。

举例说明：

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)

另请参阅 setWidth(),setHeight() 和scaled().

[noexcept] void QSize::scale(const QSize &size, Qt::AspectRatioMode mode)

这是一个重载函数。

根据指定的mode ，以给定的size 为矩形缩放尺寸。

[noexcept] QSize QSize::scaled(int width, int height, Qt::AspectRatioMode mode) const

根据给定的width 和height ，按照指定的mode 返回按比例缩放的矩形尺寸。

另请参阅 scale() 。

[noexcept] QSize QSize::scaled(const QSize &s, Qt::AspectRatioMode mode) const

这是一个重载函数。

根据指定的mode ，返回按比例缩放为矩形的尺寸s 。

[constexpr noexcept] void QSize::setHeight(int height)

将高度设置为给定的height 。

另请参阅 rheight()、height() 和setWidth()。

[constexpr noexcept] void QSize::setWidth(int width)

将宽度设置为给定的width 。

另请参阅 rwidth()、width() 和setHeight()。

[noexcept] CGSize QSize::toCGSize() const

从QSize 创建 CGSize。

另请参见 QSizeF::fromCGSize().

[constexpr noexcept, since 6.4] QSizeF QSize::toSizeF() const

以浮点精度返回此大小。

此函数在 Qt 6.4 中引入。

另请参阅 QSizeF::toSize()。

[noexcept] void QSize::transpose()

交换宽度和高度值。

另请参见 setWidth()、setHeight() 和transposed()。

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

返回交换了宽度和高度的QSize 。

另请参见 transpose()。

[constexpr noexcept] int QSize::width() const

返回宽度。

另请参阅 height() 和setWidth()。

[constexpr noexcept] QSize &QSize::operator*=(qreal factor)

这是一个重载函数。

将宽度和高度与给定的factor 相乘，并返回对大小的引用。

请注意，结果将四舍五入为最接近的整数。

另请参见 scale()。

[constexpr noexcept] QSize &QSize::operator+=(const QSize &size)

将给定的size 添加到此大小，并返回此大小的引用。例如

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

// s becomes (2,11)

[constexpr noexcept] QSize &QSize::operator-=(const QSize &size)

从此大小减去给定的size ，并返回此大小的引用。例如

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

// s becomes (4,3)

QSize &QSize::operator/=(qreal divisor)

这是一个重载函数。

用给定的divisor 除以宽度和高度，并返回一个尺寸引用。

请注意，结果将四舍五入为最接近的整数。

另请参阅 QSize::scale()。