Qt Reference Documentation

Contents

QSpacerItem Class Reference

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

 #include <QSpacerItem>

Inherits: QLayoutItem.

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

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:

ClassFunctions
QHBoxLayoutaddSpacing(), addStretch(), insertSpacing(), insertStretch()
QGridLayoutsetRowMinimumHeight(), 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.