Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QSpacerItem Class Reference

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

     #include <QSpacerItem>

Inherits: QLayoutItem.

- List of all members, including inherited members

## Public Functions

| QSpacerItem ( int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum )
void | changeSize ( int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum )

## Reimplemented Public Functions

virtual Qt::Orientations | expandingDirections () const
virtual QRect | geometry () const
virtual bool | isEmpty () const
virtual QSize | maximumSize () const
virtual QSize | minimumSize () const
virtual void | setGeometry ( const QRect & r )
virtual QSize | sizeHint () const
virtual QSpacerItem * | spacerItem ()

- 17 public functions inherited from QLayoutItem

## Detailed Description

The QSpacerItem class provides blank space in a layout.

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, and QLayoutItem::spacerItem().

## Member Function Documentation

### QSpacerItem::QSpacerItem ( int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum )

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.

### void QSpacerItem::changeSize ( int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum )

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 QSpacerItem::invalidate().

### Qt::Orientations QSpacerItem::expandingDirections () const`[virtual]`

Reimplemented from QLayoutItem::expandingDirections().

### QRect QSpacerItem::geometry () const`[virtual]`

Reimplemented from QLayoutItem::geometry().

See also setGeometry().

### bool QSpacerItem::isEmpty () const`[virtual]`

Reimplemented from QLayoutItem::isEmpty().

Returns true.

### QSize QSpacerItem::maximumSize () const`[virtual]`

Reimplemented from QLayoutItem::maximumSize().

### QSize QSpacerItem::minimumSize () const`[virtual]`

Reimplemented from QLayoutItem::minimumSize().

### void QSpacerItem::setGeometry ( const QRect & r )`[virtual]`

Reimplemented from QLayoutItem::setGeometry().

See also geometry().

### QSize QSpacerItem::sizeHint () const`[virtual]`

Reimplemented from QLayoutItem::sizeHint().

### QSpacerItem * QSpacerItem::spacerItem ()`[virtual]`

Reimplemented from QLayoutItem::spacerItem().

Returns a pointer to this object.