QSize 類

QSize 類使用整數點精度定義 2D 對象的大小。 更多...

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

• 所有成員列錶，包括繼承成員
• QSize 屬於 描繪類 .

公共函數

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

詳細描述

大小的指定是通過 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 ，當前大小在內側被比例縮放為盡可能大的矩形按 ( width , height )，保留寬高比。
• 若 mode is 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 )

把尺寸比例縮放到矩形采用給定 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

以具有浮點精度的大小形式，返迴此大小。

該函數在 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 to this 尺寸，並返迴此大小的引用。例如：

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 尺寸，並返迴此大小的引用。例如：

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

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

寬度和高度兩者除以給定 divisor ，並返迴大小的引用。

注意，結果被四捨五入到最近整數。

另請參閱 QSize::scale ().

相關非成員

[constexpr noexcept] bool operator!= (const QSize & lhs , const QSize & rhs )

返迴 true if lhs and rhs 不同；否則返迴 false .

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

乘以給定 size 通過給定 factor ，並返迴被捨入到最近整數的結果。

另請參閱 QSize::scale ().

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

乘以給定 size 通過給定 factor ，並返迴被捨入到最近整數的結果。

這是重載函數。

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

返迴和對於 s1 and s2 ；各分量分彆相加。

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

返迴 s2 減去 s1 ；分彆減去各分量。

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

除以給定 size 通過給定 divisor ，並返迴被捨入到最近整數的結果。

另請參閱 QSize::scale ().

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

寫入給定 size 到給定 stream ，並返迴流引用。

另請參閱 序列化 Qt 數據類型 .

[constexpr noexcept] bool operator== (const QSize & lhs , const QSize & rhs )

返迴 true if lhs and rhs 相等；否則返迴 false .

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

讀取大小從給定 stream 進給定 size ，並返迴流引用。

另請參閱 序列化 Qt 數據類型 .

內容

1. 公共函數

2. 相關非成員

3. 詳細描述