\inmodule QtCore More...

#include <qsize.h>

Collaboration diagram for QSize:

Public Member Functions
constexpr	QSize () noexcept
	Constructs a size with an invalid width and height (i.e., isValid() returns `false`).

constexpr	QSize (int w, int h) noexcept
	Constructs a size with the given width and height.

constexpr bool	isNull () const noexcept
	Returns `true` if both the width and height is 0; otherwise returns false.

constexpr bool	isEmpty () const noexcept
	Returns `true` if either of the width and height is less than or equal to 0; otherwise returns `false`.

constexpr bool	isValid () const noexcept
	Returns `true` if both the width and height is equal to or greater than 0; otherwise returns `false`.

constexpr int	width () const noexcept
	Returns the width.

constexpr int	height () const noexcept
	Returns the height.

constexpr void	setWidth (int w) noexcept
	Sets the width to the given width.

constexpr void	setHeight (int h) noexcept
	Sets the height to the given height.

void	transpose () noexcept
	Swaps the width and height values.

constexpr QSize	transposed () const noexcept

void	scale (int w, int h, Qt::AspectRatioMode mode) noexcept
	Scales the size to a rectangle with the given width and height, according to the specified mode:

void	scale (const QSize &s, Qt::AspectRatioMode mode) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Scales the size to a rectangle with the given size, according to the specified mode.

QSize	scaled (int w, int h, Qt::AspectRatioMode mode) const noexcept

QSize	scaled (const QSize &s, Qt::AspectRatioMode mode) const noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

constexpr QSize	expandedTo (const QSize &) const noexcept
	Returns a size holding the maximum width and height of this size and the given otherSize.

constexpr QSize	boundedTo (const QSize &) const noexcept
	Returns a size holding the minimum width and height of this size and the given otherSize.

constexpr QSize	grownBy (QMargins m) const noexcept

constexpr QSize	shrunkBy (QMargins m) const noexcept

constexpr int &	rwidth () noexcept
	Returns a reference to the width.

constexpr int &	rheight () noexcept
	Returns a reference to the height.

constexpr QSize &	operator+= (const QSize &) noexcept
	Adds the given size to this size, and returns a reference to this size.

constexpr QSize &	operator-= (const QSize &) noexcept
	Subtracts the given size from this size, and returns a reference to this size.

constexpr QSize &	operator*= (qreal c) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Multiplies both the width and height by the given factor, and returns a reference to the size.

QSize &	operator/= (qreal c)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Divides both the width and height by the given divisor, and returns a reference to the size.

constexpr QSizeF	toSizeF () const noexcept

Friends
constexpr bool	operator== (const QSize &s1, const QSize &s2) noexcept
	Returns `true` if s1 and s2 are equal; otherwise returns `false`.

constexpr bool	operator!= (const QSize &s1, const QSize &s2) noexcept
	Returns `true` if s1 and s2 are different; otherwise returns `false`.

constexpr QSize	operator+ (const QSize &s1, const QSize &s2) noexcept
	Returns the sum of s1 and s2; each component is added separately.

constexpr QSize	operator- (const QSize &s1, const QSize &s2) noexcept
	Returns s2 subtracted from s1; each component is subtracted separately.

constexpr QSize	operator* (const QSize &s, qreal c) noexcept
	Multiplies the given size by the given factor, and returns the result rounded to the nearest integer.

constexpr QSize	operator* (qreal c, const QSize &s) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Multiplies the given size by the given factor, and returns the result rounded to the nearest integer.

QSize	operator/ (const QSize &s, qreal c)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Divides the given size by the given divisor, and returns the result rounded to the nearest integer.

constexpr size_t	qHash (const QSize &, size_t) noexcept

template<std::size_t I, typename S , std::enable_if_t<(I< 2), bool > = true, std::enable_if_t< std::is_same_v< q20::remove_cvref_t< S >, QSize >, bool > = true>
constexpr decltype(auto)	get (S &&s) noexcept

Related Symbols
(Note that these are not member symbols.)
QDataStream &	operator<< (QDataStream &stream, const QSize &size)
	Writes the given size to the given stream, and returns a reference to the stream.

QDataStream &	operator>> (QDataStream &stream, QSize &size)
	Reads a size from the given stream into the given size, and returns a reference to the stream.

Detailed Description

\inmodule QtCore

The QSize class defines the size of a two-dimensional object using integer point precision.

A size is specified by a width() and a height(). It can be set in the constructor and changed using the setWidth(), setHeight(), or scale() functions, or using arithmetic operators. A size can also be manipulated directly by retrieving references to the width and height using the rwidth() and rheight() functions. Finally, the width and height can be swapped using the transpose() function.

The isValid() function determines if a size is valid (a valid size has both width and height greater than or equal to zero). The isEmpty() function returns true if either of the width and height is less than, or equal to, zero, while the isNull() function returns true only if both the width and the height is zero.

Use the expandedTo() function to retrieve a size which holds the maximum height and width of this size and a given size. Similarly, the boundedTo() function returns a size which holds the minimum height and width of this size and a given size.

QSize objects can be streamed as well as compared.

See also: QSizeF, QPoint, QRect

Definition at line 24 of file qsize.h.

Constructor & Destructor Documentation

◆ QSize() [1/2]

constexpr QSize::QSize ( )

inlineconstexprnoexcept

Constructs a size with an invalid width and height (i.e., isValid() returns false).

See also: isValid()

Definition at line 116 of file qsize.h.

Referenced by transposed().

Here is the caller graph for this function:

◆ QSize() [2/2]

constexpr QSize::QSize	(	int	width,
		int	height
	)

inlineconstexprnoexcept

Constructs a size with the given width and height.

See also: setWidth(), setHeight()

Definition at line 118 of file qsize.h.

Member Function Documentation

◆ boundedTo()

constexpr QSize QSize::boundedTo ( const QSize & otherSize ) const

inlineconstexprnoexcept

Returns a size holding the minimum width and height of this size and the given otherSize.

See also: expandedTo(), scale()

Definition at line 196 of file qsize.h.

References qMin().

Referenced by QMdiAreaPrivate::appendChild(), QFormLayoutPrivate::arrangeWidgets(), QLayout::closestAcceptableSize(), QPlatformWindow::constrainWindowSize(), QItemDelegate::doLayout(), QCommonStyle::drawControl(), fixToolBarOrientation(), QDockAreaLayout::getGrid(), QTabWidget::initStyleOption(), QWidgetResizeHandler::mouseMoveEvent(), QWidgetItem::setGeometry(), QWindowPrivate::setMinOrMaxSize(), QBoxLayoutPrivate::setupGeom(), QComboBox::showPopup(), QWaylandXdgToplevel::sizeForResize(), QtPrivate::QWellArray::sizeHint(), QWidgetItem::sizeHint(), QScrollArea::sizeHint(), QOpenGLTextureUploader::textureImage(), QOpenGL2PaintEngineExPrivate::updateBrushTexture(), QScrollAreaPrivate::updateScrollBars(), and QQC2::QCommonStylePrivate::viewItemLayout().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ expandedTo()

constexpr QSize QSize::expandedTo ( const QSize & otherSize ) const

inlineconstexprnoexcept

Returns a size holding the maximum width and height of this size and the given otherSize.

See also: boundedTo(), scale()

Definition at line 191 of file qsize.h.

References qMax().

Referenced by QMdiAreaPrivate::appendChild(), QMenuBarPrivate::calcActionRects(), QLayout::closestAcceptableSize(), QPlatformWindow::constrainWindowSize(), QProgressDialogPrivate::ensureSizeIsAtLeastSizeHint(), QDockAreaLayout::getGrid(), QGroupBox::minimumSizeHint(), QWidgetResizeHandler::mouseMoveEvent(), qNormalizeRadii(), qSmartMaxSize(), QToolBarAreaLayoutItem::realSizeHint(), QMdiAreaPrivate::rearrange(), QSGMapboxGLTextureNode::resize(), QMdiAreaPrivate::resizeToMinimumTileSize(), QWasmWindow::setGeometry(), QWidgetItem::setGeometry(), QMainWindowLayout::setGeometry(), QWindowPrivate::setMinOrMaxSize(), QMdiSubWindowPrivate::setNewGeometry(), QMdiSubWindowPrivate::setNormalMode(), QBoxLayoutPrivate::setupGeom(), QMdiSubWindowPrivate::setWindowFlags(), QMdiArea::showEvent(), QComboBox::showPopup(), QAndroidStyle::AndroidLayerDrawable::size(), QWaylandXdgToplevel::sizeForResize(), QAndroidStyle::AndroidSeekBarControl::sizeFromContents(), QQC2_NAMESPACE::QMacStyle::sizeFromContents(), QMacStyle::sizeFromContents(), QQC2::QWindowsXPStyle::sizeFromContents(), QWidgetItem::sizeHint(), QMenuPrivate::updateActionRects(), and QScrollAreaPrivate::updateScrollBars().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ grownBy()

QSize QSize::grownBy ( QMargins m ) const

inlineconstexprnoexcept

Definition at line 49 of file qsize.h.

Referenced by QDockAreaLayoutItem::maximumSize(), QDockAreaLayoutItem::minimumSize(), and QDockAreaLayoutItem::sizeHint().

Here is the caller graph for this function:

◆ height()

constexpr int QSize::height ( ) const

inlineconstexprnoexcept

Returns the height.

See also: width(), setHeight()

Definition at line 132 of file qsize.h.

◆ isEmpty()

constexpr bool QSize::isEmpty ( ) const

inlineconstexprnoexcept

Returns true if either of the width and height is less than or equal to 0; otherwise returns false.

See also: isNull(), isValid()

Definition at line 123 of file qsize.h.

Referenced by QtWaylandClient::QWaylandWlShellSurface::applyConfigure(), QAndroidCameraSession::applyResolution(), QPixmapIconEngine::availableSizes(), QQuickContext2DImageTexture::beginPainting(), QOpenGLFramebufferObject::blitFramebuffer(), QMenuBarPrivate::calcActionRects(), QQuickTableViewPrivate::calculateTopLeft(), QD3D11RenderBuffer::create(), QGles2RenderBuffer::create(), QMetalRenderBuffer::create(), QNullTexture::create(), QVkRenderBuffer::create(), QD3D11SwapChain::createOrResize(), D3DPresentEngine::createVideoSamples(), QGraphicsScenePrivate::drawItemHelper(), QRhiD3D11::enqueueResourceUpdates(), QRhiGles2::enqueueResourceUpdates(), QRhiVulkan::enqueueResourceUpdates(), QRhiD3D11::enqueueSubresUpload(), QRhiGles2::enqueueSubresUpload(), QRhiMetal::enqueueSubresUpload(), QSGGuiThreadRenderLoop::exposureChanged(), QSGThreadedRenderLoop::exposureChanged(), QOffscreenBackingStore::flush(), QXcbBackingStore::flush(), QXcbWindow::handleConfigureNotifyEvent(), QWindowsWindow::handleNonClientHitTest(), QQnxRasterWindow::hasBuffers(), QTextureFileData::isValid(), QWaylandOutputMode::isValid(), QuickSharedImageLoader::loadFile(), QQuickImageProviderWithOptions::loadSize(), QPdfEnginePrivate::newPage(), QHaikuRasterBackingStore::paintDevice(), QtWaylandClient::QWaylandScreen::physicalSize(), QSvgIconEngine::pixmap(), QD3D11Texture::prepareCreate(), QGles2Texture::prepareCreate(), QMetalTexture::prepareCreate(), QVkTexture::prepareCreate(), QRhiVulkan::prepareUploadSubres(), QCocoaWindow::propagateSizeHints(), qImageFromVideoFrame(), QSvgIOHandler::read(), QPdfIOHandler::read(), read_image_scaled(), read_jpeg_image(), QRhiVulkan::recreateSwapChain(), QQuickDesignerSupport::renderImageForItem(), QSGGuiThreadRenderLoop::renderWindow(), QQuickImagePreviewProvider::requestImage(), QXcbBackingStore::rhiFlush(), QEglFSX11Integration::screenSize(), QQnxWindow::setBufferSize(), QQnxPlatformCamera::setCameraFormat(), QQnxCamera::setCustomFocusPoint(), QGstreamerImageCapture::setImageSettings(), QSSGRhiEffectSystem::setup(), setup_qt(), QRhiNull::simulateTextureCopy(), QRhiNull::simulateTextureUpload(), QSvgTinyDocument::size(), QAndroidStyle::AndroidControl::sizeFromContents(), QQC2_NAMESPACE::QMacStyle::sizeFromContents(), QQC2::QCommonStyle::sizeFromContents(), QQC2::QWindowsStyle::sizeFromContents(), QMacStyle::sizeFromContents(), QQC2::QWindowsXPStyle::sizeFromContents(), QWindowsVistaStyle::sizeFromContents(), QQuickView::sizeHint(), QQuickWidget::sizeHint(), QMacStyle::styleHint(), QQC2_NAMESPACE::QMacStyle::styleHint(), QSGRenderThread::syncAndRender(), QQuickTableViewPrivate::syncSyncView(), QOpenGLTextureUploader::textureImage(), QMenuPrivate::updateActionRects(), QQuickShaderEffectSource::updatePaintNode(), QGeoMapMapboxGLPrivate::updateSceneGraph(), and QtWaylandClient::QWaylandEglWindow::updateSurface().

◆ isNull()

constexpr bool QSize::isNull ( ) const

inlineconstexprnoexcept

Returns true if both the width and height is 0; otherwise returns false.

See also: isValid(), isEmpty()

Definition at line 120 of file qsize.h.

Referenced by QAbstractFileIconEngine::actualSize(), QPixmapIconEngine::actualSize(), QDockAreaLayoutInfo::apply(), QPixmapIconEngine::bestMatch(), QDockAreaLayout::getGrid(), QDockAreaLayoutInfo::maximumSize(), QDockAreaLayoutInfo::minimumSize(), PixmapEntry::pixmap(), QSvgIconEngine::pixmap(), QCocoaWindow::propagateSizeHints(), qt_find_best_resolution_match(), qt_unique_device_formats(), QPdfDocument::render(), QListView::resizeEvent(), QPixmapIconEngine::scaledPixmap(), QSGOpenVGLayer::setLive(), QSGSoftwareLayer::setLive(), QSGRhiLayer::setLive(), QMdiSubWindowPrivate::setNormalMode(), QAndroidStyle::AndroidDrawable::setPaddingLeftToSizeWidth(), QSGRhiLayer::setSize(), QSGOpenVGLayer::setSize(), QSGSoftwareLayer::setSize(), QGraphicsProxyWidgetPrivate::setWidget_helper(), and QTabBar::tabSizeHint().

Here is the caller graph for this function:

◆ isValid()

constexpr bool QSize::isValid ( ) const

inlineconstexprnoexcept

Returns true if both the width and height is equal to or greater than 0; otherwise returns false.

See also: isNull(), isEmpty()

Definition at line 126 of file qsize.h.

Referenced by QPageSizePrivate::QPageSizePrivate(), QPageSizePrivate::QPageSizePrivate(), QPageSizePrivate::QPageSizePrivate(), QtWaylandClient::QWaylandShmBackingStore::QWaylandShmBackingStore(), QtWaylandClient::QWaylandQtSurface::applyConfigure(), QAndroidCameraSession::applyResolution(), QFormLayoutPrivate::arrangeWidgets(), QPixmapIconEngine::bestMatch(), D3DPresentEngine::createVideoSamples(), QFileDialogPrivate::createWidgets(), QIconModeViewBase::dataChanged(), QGraphicsScenePrivate::drawItemHelper(), QDockAreaLayout::getGrid(), QScreen::grabWindow(), QListModeViewBase::indexToListViewItem(), QFileDialogPrivate::init(), QCocoaWindow::isFixedSize(), QPageSizePrivate::isValid(), QVideoFrameFormat::isValid(), QListViewPrivate::itemSize(), QuickSharedImageLoader::key(), QuickSharedImageLoader::loadFile(), QMainWindowLayout::minimumSize(), QMdiSubWindow::minimumSizeHint(), QSplitter::minimumSizeHint(), QFFmpegImageCapture::newVideoFrame(), QMoviePrivate::next(), QCocoaWindow::propagateSizeHints(), qt_find_best_resolution_match(), qt_unique_device_formats(), QImageReader::read(), QSvgIOHandler::read(), QPdfIOHandler::read(), read_jpeg_image(), readImage(), QPngHandlerPrivate::readPngImage(), QComboBoxPrivate::recomputeSizeHint(), QTextEditPrivate::relayoutDocument(), QSGOpenVGInternalImageNode::render(), QMdiAreaPrivate::resizeToMinimumTileSize(), QQnxWindow::setBufferSize(), QMainWindow::setIconSize(), QToolBar::setIconSize(), QMdiSubWindowPrivate::setMaximizeMode(), QAndroidMediaPlayer::setMedia(), QMainWindowLayout::sizeHint(), QWidgetRepaintManager::sync(), AndroidCameraPrivate::updatePreviewSize(), QGraphicsProxyWidgetPrivate::updateProxyGeometryFromWidget(), QTreeViewPrivate::updateScrollBars(), QQuickViewPrivate::updateSize(), QQuickWidgetPrivate::updateSize(), QGstreamerVideoDevices::videoDevices(), QListView::viewportSizeHint(), QWaylandViewporterPrivate::Viewport::wp_viewport_set_destination(), QWaylandXdgToplevelPrivate::xdg_toplevel_set_max_size(), and QWaylandXdgToplevelPrivate::xdg_toplevel_set_min_size().

◆ operator*=()

constexpr QSize & QSize::operator*= ( qreal factor )

inlineconstexprnoexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.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.

See also: scale()

Definition at line 173 of file qsize.h.

References qRound().

Here is the call graph for this function:

◆ operator+=()

constexpr QSize & QSize::operator+= ( const QSize & size )

inlineconstexprnoexcept

Adds the given 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)

Definition at line 159 of file qsize.h.

◆ operator-=()

constexpr QSize & QSize::operator-= ( const QSize & size )

inlineconstexprnoexcept

Subtracts the given 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)

Definition at line 166 of file qsize.h.

◆ operator/=()

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.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.

See also: QSize::scale()

Definition at line 183 of file qsize.h.

References Q_ASSERT, qFuzzyIsNull(), and qRound().

Here is the call graph for this function:

◆ rheight()

constexpr int & QSize::rheight ( )

inlineconstexprnoexcept

Returns a reference to the height.

Using a reference makes it possible to manipulate the height directly. For example:

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

See also: rwidth(), setHeight()

Definition at line 156 of file qsize.h.

Referenced by QFormLayoutPrivate::calcSizeHints(), QKmsDevice::createScreenForConnector(), QQC2::QWindowsXPStyle::drawControl(), QWindowsVistaStyle::drawControl(), QWindowsGeometryHint::frameSizeConstraints(), QIIOFHelper::imageProperty(), QKmsScreenConfig::loadConfig(), QLabel::minimumSizeHint(), operator>>(), QQC2_NAMESPACE::QMacStyle::sizeFromContents(), QAndroidStyle::sizeFromContents(), QMacStyle::sizeFromContents(), QQC2::QWindowsXPStyle::sizeFromContents(), QWindowsVistaStyle::sizeFromContents(), QMenuBar::sizeHint(), QQuickShaderEffectSource::updatePaintNode(), QMdiAreaPrivate::updateScrollBars(), QTipLabel::updateSize(), and QQuick3DTexture::updateSpatialNode().

Here is the caller graph for this function:

◆ rwidth()

constexpr int & QSize::rwidth ( )

inlineconstexprnoexcept

Returns a reference to the width.

Using a reference makes it possible to manipulate the width directly. For example:

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

See also: rheight(), setWidth()

Definition at line 153 of file qsize.h.

Referenced by QFormLayoutPrivate::calcSizeHints(), QKmsDevice::createScreenForConnector(), QItemDelegate::doLayout(), QWindowsGeometryHint::frameSizeConstraints(), QIIOFHelper::imageProperty(), QKmsScreenConfig::loadConfig(), QLabel::minimumSizeHint(), operator>>(), QComboBoxPrivate::recomputeSizeHint(), QQC2_NAMESPACE::QMacStyle::sizeFromContents(), QAndroidStyle::sizeFromContents(), QMacStyle::sizeFromContents(), QQC2::QWindowsXPStyle::sizeFromContents(), QWindowsVistaStyle::sizeFromContents(), QQuickShaderEffectSource::updatePaintNode(), QMdiAreaPrivate::updateScrollBars(), QScrollAreaPrivate::updateScrollBars(), QQuick3DTexture::updateSpatialNode(), and QQC2::QCommonStylePrivate::viewItemLayout().

Here is the caller graph for this function:

◆ scale() [1/2]

void QSize::scale	(	const QSize &	s,
		Qt::AspectRatioMode	mode
	)

inlinenoexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Scales the size to a rectangle with the given size, according to the specified mode.

Definition at line 147 of file qsize.h.

References scaled().

Here is the call graph for this function:

◆ scale() [2/2]

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

inlinenoexcept

Scales the size to a rectangle with the given width and height, according to the specified mode:

\list

If mode is Qt::IgnoreAspectRatio, the size is set to (width, height).
If mode is Qt::KeepAspectRatio, the current size is scaled to a rectangle as large as possible inside (width, height), preserving the aspect ratio.
If mode is Qt::KeepAspectRatioByExpanding, the current size is scaled to a rectangle as small as possible outside (width, height), preserving the aspect ratio. \endlist

Example:

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)

See also: setWidth(), setHeight(), scaled()

Definition at line 144 of file qsize.h.

Referenced by QAbstractFileIconEngine::actualSize(), QPixmapIconEngine::actualSize(), PixmapEntry::pixmap(), QSvgIconEngine::pixmap(), QPixmapIconEngine::scaledPixmap(), and EvrVideoWindowControl::setDisplayRect().

Here is the caller graph for this function:

◆ scaled() [1/2]

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

noexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 5.0

Return a size scaled to a rectangle with the given size s, according to the specified mode.

Definition at line 189 of file qsize.cpp.

References Qt::IgnoreAspectRatio, and Qt::KeepAspectRatio.

◆ scaled() [2/2]

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

inlinenoexcept

Since: 5.0

Return a size scaled to a rectangle with the given width and height, according to the specified mode.

See also: scale()

Definition at line 150 of file qsize.h.

References scaled().

Referenced by QPagePreview::paintEvent(), and QVideoWindowPrivate::render().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setHeight()

constexpr void QSize::setHeight ( int height )

inlineconstexprnoexcept

Sets the height to the given height.

See also: rheight(), height(), setWidth()

Definition at line 138 of file qsize.h.

Here is the caller graph for this function:

◆ setWidth()

constexpr void QSize::setWidth ( int width )

inlineconstexprnoexcept

Sets the width to the given width.

See also: rwidth(), width(), setHeight()

Definition at line 135 of file qsize.h.

Here is the caller graph for this function:

◆ shrunkBy()

QSize QSize::shrunkBy ( QMargins m ) const

inlineconstexprnoexcept

Definition at line 51 of file qsize.h.

Referenced by QDockWidgetLayout::sizeFromContent().

Here is the caller graph for this function:

◆ toSizeF()

constexpr QSizeF QSize::toSizeF ( ) const

inlineconstexprnoexcept

Since: 6.4

Returns this size as a size with floating point accuracy.

See also: QSizeF::toSize()

Definition at line 395 of file qsize.h.

◆ transpose()

void QSize::transpose ( )

noexcept

Swaps the width and height values.

See also: setWidth(), setHeight(), transposed()

Definition at line 130 of file qsize.cpp.

References qSwap().

Referenced by QAndroidCameraSession::applyResolution(), QQuickStyleItemScrollBar::calculateGeometry(), QQC2::QWindowsXPStyle::drawComplexControl(), qImageFromVideoFrame(), QVideoWindowPrivate::render(), QQuickVideoOutput::setOrientation(), QQC2::QWindowsXPStyle::sizeFromContents(), and QQuickVideoOutput::sourceRect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ transposed()

constexpr QSize QSize::transposed ( ) const

inlineconstexprnoexcept

Since: 5.0

Returns a QSize with width and height swapped.

See also: transpose()

Definition at line 141 of file qsize.h.

References QSize().

Referenced by QQnxScreen::QQnxScreen(), QAndroidCameraSession::applyResolution(), QPageLayoutPrivate::fullRectPixels(), QPageLayoutPrivate::fullRectPoints(), QQC2_NAMESPACE::QMacStyle::sizeFromContents(), QMacStyle::sizeFromContents(), QQC2_NAMESPACE::QMacStyle::subElementRect(), QQC2::QCommonStyle::subElementRect(), QMacStyle::subElementRect(), and QCommonStyle::subElementRect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ width()

constexpr int QSize::width ( ) const

inlineconstexprnoexcept

Returns the width.

See also: height(), setWidth()

Definition at line 129 of file qsize.h.

Friends And Related Symbol Documentation

◆ get

template<std::size_t I, typename S , std::enable_if_t<(I< 2), bool > = true, std::enable_if_t< std::is_same_v< q20::remove_cvref_t< S >, QSize >, bool > = true>

constexpr decltype(auto) get ( S && s )

friend

Definition at line 92 of file qsize.h.

◆ operator!=

bool QSize::operator!=	(	const QSize &	s1,
		const QSize &	s2
	)

friend

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

Definition at line 64 of file qsize.h.

◆ operator* [1/2]

QSize QSize::operator*	(	const QSize &	size,
		qreal	factor
	)

friend

Multiplies the given size by the given factor, and returns the result rounded to the nearest integer.

See also: QSize::scale()

Definition at line 70 of file qsize.h.

◆ operator* [2/2]

QSize QSize::operator*	(	qreal	c,
		const QSize &	s
	)

friend

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Multiplies the given size by the given factor, and returns the result rounded to the nearest integer.

Definition at line 72 of file qsize.h.

◆ operator+

QSize QSize::operator+	(	const QSize &	s1,
		const QSize &	s2
	)

friend

Returns the sum of s1 and s2; each component is added separately.

Definition at line 66 of file qsize.h.

◆ operator-

QSize QSize::operator-	(	const QSize &	s1,
		const QSize &	s2
	)

friend

Returns s2 subtracted from s1; each component is subtracted separately.

Definition at line 68 of file qsize.h.

◆ operator/

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

friend

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Divides the given size by the given divisor, and returns the result rounded to the nearest integer.

See also: QSize::scale()

Definition at line 74 of file qsize.h.

◆ operator<<()

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

See also: {Serializing Qt Data Types}

Definition at line 393 of file qsize.cpp.

References height(), and width().

Here is the call graph for this function:

◆ operator==

bool QSize::operator==	(	const QSize &	s1,
		const QSize &	s2
	)

friend

Returns true if s1 and s2 are equal; otherwise returns false.

Definition at line 62 of file qsize.h.

◆ operator>>()

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

See also: {Serializing Qt Data Types}

Definition at line 412 of file qsize.cpp.

References rheight(), and rwidth().

Here is the call graph for this function:

◆ qHash

constexpr size_t qHash	(	const QSize &	s,
		size_t	seed = `0`
	)

friend

Definition at line 180 of file qsize.h.

The documentation for this class was generated from the following files:

qtbase/src/corelib/tools/qsize.h
qtbase/src/corelib/tools/qsize.cpp

Public Member Functions

Friends

Related Symbols

Detailed Description

Constructor & Destructor Documentation

◆ QSize() [1/2]

◆ QSize() [2/2]

Member Function Documentation

◆ boundedTo()

◆ expandedTo()

◆ grownBy()

◆ height()

◆ isEmpty()

◆ isNull()

◆ isValid()

◆ operator*=()

◆ operator+=()

◆ operator-=()

◆ operator/=()

◆ rheight()

◆ rwidth()

◆ scale() [1/2]

◆ scale() [2/2]

◆ scaled() [1/2]

◆ scaled() [2/2]

◆ setHeight()

◆ setWidth()

◆ shrunkBy()

◆ toSizeF()

◆ transpose()

◆ transposed()

◆ width()

Friends And Related Symbol Documentation

◆ get

◆ operator!=

◆ operator* [1/2]

◆ operator* [2/2]

◆ operator+

◆ operator-

◆ operator/

◆ operator<<()

◆ operator==

◆ operator>>()

◆ qHash