QSizeF Class

成员函数文档

[constexpr noexcept] QSizeF::QSizeF()

构建了一个无效的大小。

另请参阅 isValid()。

[constexpr noexcept] QSizeF::QSizeF(const QSize &size)

根据给定的size ，构建一个具有浮点精度的数值类型。

另请参阅 toSize() 和QSize::toSizeF()。

[constexpr noexcept] QSizeF::QSizeF(qreal width, qreal height)

根据给定的有限width 和height 构造一个大小。

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

返回一个包含此大小以及给定otherSize 的最小宽度和高度的大小。

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

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

返回一个包含此大小以及给定otherSize 的最大宽度和高度的尺寸。

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

[static noexcept] QSizeF QSizeF::fromCGSize(CGSize size)

根据size 创建QSizeF 。

另请参阅 toCGSize()。

[constexpr noexcept] QSizeF QSizeF::grownBy(QMarginsF margins) const

返回将当前大小按margins 进行扩展后得到的大小。

另请参阅 shrunkBy()。

[constexpr noexcept] qreal QSizeF::height() const

返回高度。

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

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

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

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

[noexcept] bool QSizeF::isNull() const

如果宽度和高度均为 0.0（不考虑正负号），则返回true ；否则返回false 。

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

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

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

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

[constexpr noexcept] qreal &QSizeF::rheight()

返回对高度的引用。

使用引用可以直接对高度进行操作。例如：

QSizeF size(100, 10.2);
size.rheight() += 5.5;

// size becomes (100,15.7)

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

[constexpr noexcept] qreal &QSizeF::rwidth()

返回对宽度的引用。

使用引用可以直接对宽度进行操作。例如：

QSizeF size(100.3, 10);
size.rwidth() += 20.5;

// size becomes (120.8,10)

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

[noexcept] void QSizeF::scale(qreal width, qreal height, Qt::AspectRatioMode mode)

根据指定的mode ，将尺寸缩放为一个矩形，其width 和height 分别为给定值。

• 如果mode 等于Qt::IgnoreAspectRatio ，则将尺寸设置为(width,height)。
• 如果mode 为Qt::KeepAspectRatio ，则将当前大小缩放为在(width,height)范围内尽可能大的矩形，同时保持宽高比。
• 如果mode 为Qt::KeepAspectRatioByExpanding ，则将当前尺寸缩放为尽可能小且位于 (width,height) 范围外的矩形，同时保持宽高比。

示例：

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)

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

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

根据指定的mode ，将图像缩放为具有给定size 的矩形。

[noexcept] QSizeF QSizeF::scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const

根据指定的mode ，返回一个按给定的width 和height 缩放为矩形大小的图像。

另请参阅 scale()。

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

返回一个按给定尺寸s 缩放的矩形，缩放比例由指定的mode 决定。

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

将高度设置为给定的有限值height 。

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

[constexpr noexcept] void QSizeF::setWidth(qreal width)

将宽度设置为给定的有限值width 。

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

[constexpr noexcept] QSizeF QSizeF::shrunkBy(QMarginsF margins) const

返回将该大小缩小margins 后得到的大小。

另请参阅 grownBy()。

[noexcept] CGSize QSizeF::toCGSize() const

根据QSizeF 创建一个CGSize。

另请参阅 fromCGSize()。

[constexpr noexcept] QSize QSizeF::toSize() const

返回该大小的基于整数的副本。

请注意，返回的 `size` 中的坐标将四舍五入到最接近的整数。

另请参阅 QSizeF() 和QSize::toSizeF()。

[noexcept] void QSizeF::transpose()

交换宽度和高度的值。

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

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

返回宽度和高度值互换后的尺寸。

另请参阅 transpose()。

[constexpr noexcept] qreal QSizeF::width() const

返回宽度。

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

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

将宽度和高度都乘以给定的有限值factor ，并返回该大小的引用。

另请参阅 scale()。

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

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

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

// s becomes (2,11)

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

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

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

// s becomes (4,3)

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

将宽度和高度均除以给定的divisor ，并返回该尺寸的引用。divisor 的值不得为零或NaN。

另请参阅 scale()。