就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. Qt 6.7.2
  3. Qt Core
  4. C++ 类
  5. QSize

QSize 类

QSize 类使用整数点精度定义 2D 对象的大小。 更多...

头： #include <QSize>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

公共函数

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
(从 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 & s1 , const QSize & s2 )
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 & s1 , const QSize & s2 )
QDataStream & operator>> (QDataStream & stream , QSize & size )

详细描述

大小的指定是通过 width () 和 height ()。可以在构造函数中设置它和改变使用 setWidth (), setHeight ()，或 scale () 函数，或使用算术运算符。也可以直接操纵尺寸通过检索宽度和高度的引用使用 rwidth () 和 rheight () 函数。最后，可以交换宽度和高度使用 transpose () 函数。

The isValid () 函数确定尺寸是否有效 (有效尺寸拥有的宽度和高度两者大于或等于 0)。 isEmpty () 函数返回 true 若宽度和高度任一小于或等于 0，而 isNull () 函数返回 true 仅当宽度和高度两者为 0 时。

使用 expandedTo () 函数以检索尺寸保持的最大高度和宽度为 this 尺寸和给定尺寸。同样， boundedTo () 函数返回大小保持最小高度和宽度 this 尺寸和给定尺寸。

QSize 对象可以被流化及比较。

另请参阅 QSizeF , QPoint ，和 QRect .

成员函数文档编制

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

返回尺寸产生自此尺寸的增长按 margins .

另请参阅 shrunkBy ().

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

返回尺寸产生从此尺寸的收缩按 margins .

另请参阅 grownBy ().

[constexpr noexcept] QSize:: QSize ()

采用无效宽度和高度构造尺寸 (即 isValid () 返回 false ).

另请参阅 isValid ().

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

构造尺寸，采用给定 width and 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

返回 true 若宽度和高度两者任一 <= 0；否则返回 false .

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

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

返回 true 若宽度和高度两者为 0；否则返回 false。

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

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

返回 true 若宽度和高度两者 >= 0；否则返回 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 and height ，根据指定 mode :

  • 若 mode is Qt::IgnoreAspectRatio ，尺寸被设为 ( width , height ).
  • 若 mode is Qt::KeepAspectRatio , the current size is scaled to a rectangle as large as possible inside ( width , height ), preserving the aspect ratio.
  • 若 mode is Qt::KeepAspectRatioByExpanding , the current size is scaled to a rectangle as small as possible outside ( width , height ), preserving the aspect ratio.

范例： 

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 )

这是重载函数。

把尺寸比例缩放到矩形采用给定 size ，根据指定 mode .

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

返回的尺寸比例缩放到矩形采用给定 width and height ，根据指定 mode .

另请参阅 scale ().

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

这是重载函数。

返回的尺寸比例缩放到矩形采用给定尺寸 s ，根据指定 mode .

[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

创建 CGSize 从 QSize .

另请参阅 QSizeF::fromCGSize ().

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

Returns this size as a size with floating point accuracy.

该函数在 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 )

这是重载函数。

Multiplies both the width and height by the given factor , and returns a reference to the size.

Note that the result is rounded to the nearest integer.

另请参阅 scale ().

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

添加给定 size to this size, and returns a reference to this size. For example: 

QSize s( 3, 7);
QSize r(-1, 4);
s += r;
// s becomes (2,11)

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

减去给定 size from this size, and returns a reference to this size. For example: 

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

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

这是重载函数。

Divides both the width and height by the given divisor , and returns a reference to the size.

Note that the result is rounded to the nearest integer.

另请参阅 QSize::scale ().

相关非成员

[constexpr noexcept] bool operator!= (const QSize & s1 , const QSize & s2 )

返回 true if s1 and s2 are different; otherwise returns false .

[constexpr noexcept] QSize operator* (const QSize & size , qreal factor )

乘以给定 size 通过给定 factor , and returns the result rounded to the nearest integer.

另请参阅 QSize::scale ().

[constexpr noexcept] QSize operator* ( qreal factor , const QSize & size )

这是重载函数。

乘以给定 size 通过给定 factor , and returns the result rounded to the nearest integer.

[constexpr noexcept] QSize operator+ (const QSize & s1 , const QSize & s2 )

Returns the sum of s1 and s2 ；分别相加各分量。

[constexpr noexcept] QSize operator- (const QSize & s1 , const QSize & s2 )

返回 s2 减去 s1 ；分别减去各分量。

QSize operator/ (const QSize & size , qreal divisor )

这是重载函数。

除以给定 size 通过给定 divisor , and returns the result rounded to the nearest integer.

另请参阅 QSize::scale ().

QDataStream & operator<< ( QDataStream & stream , const QSize & size )

写入给定 size 到给定 stream ，并返回流引用。

另请参阅 序列化 Qt 数据类型 .

[constexpr noexcept] bool operator== (const QSize & s1 , const QSize & s2 )

返回 true if s1 and s2 相等；否则返回 false .

QDataStream & operator>> ( QDataStream & stream , QSize & size )

读取大小从给定 stream 进给定 size ，并返回流引用。

另请参阅 序列化 Qt 数据类型 .

内容