PySide6.QtWidgets.QSpacerItem

class QSpacerItem

The QSpacerItem class provides blank space in a layout. More…

Synopsis

Methods

• def __init__()

• def changeSize()

• def sizePolicy()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

Normally, you don’t need to use this class directly. Qt’s built-in layout managers provide the following functions for manipulating empty space in layouts:

Class	Functions
QHBoxLayout	addSpacing() , addStretch() , insertSpacing() , insertStretch()
QGridLayout	setRowMinimumHeight() , setRowStretch() , setColumnMinimumWidth() , setColumnStretch()

See also

QLayout QWidgetItem spacerItem()

__init__(w, h[, hData=QSizePolicy.Minimum[, vData=QSizePolicy.Minimum]])

Parameters:

• w – int

• h – int

• hData – Policy

• vData – Policy

Constructs a spacer item with preferred width w, preferred height h, horizontal size policy hPolicy and vertical size policy vPolicy.

The default values provide a gap that is able to stretch if nothing else wants the space.

changeSize(w, h[, hData=QSizePolicy.Minimum[, vData=QSizePolicy.Minimum]])

Parameters:

• w – int

• h – int

• hData – Policy

• vData – Policy

Changes this spacer item to have preferred width w, preferred height h, horizontal size policy hPolicy and vertical size policy vPolicy.

The default values provide a gap that is able to stretch if nothing else wants the space.

Note that if changeSize() is called after the spacer item has been added to a layout, it is necessary to invalidate the layout in order for the spacer item’s new size to take effect.

See also

invalidate()

sizePolicy()

Return type:

QSizePolicy

Returns the size policy of this item.