---
name: "qspaceritem"
section: "3qt"
platform: "linux"
package: "qt3-doc"
version: "3:3.3.8b-7"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/qspaceritem"
---

# qspaceritem(3qt)

Blank space in a layout

## NAME

QSpacerItem - Blank space in a layout

## SYNOPSIS

`#include <qlayout.h>`

Inherits QLayoutItem.

### Public Members

**QSpacerItem ( int w, int h, QSizePolicy::SizeType hData = QSizePolicy::Minimum, QSizePolicy::SizeType vData = QSizePolicy::Minimum )**\
 **void changeSize ( int w, int h, QSizePolicy::SizeType hData = QSizePolicy::Minimum, QSizePolicy::SizeType vData = QSizePolicy::Minimum )**\
 **virtual QSize sizeHint () const**\
 **virtual QSize minimumSize () const**\
 **virtual QSize maximumSize () const**\
 **virtual QSizePolicy::ExpandData expanding () const**\
 **virtual bool isEmpty () const**\
 **virtual void setGeometry ( const QRect & r )**\

## DESCRIPTION

The QSpacerItem class provides blank space in a layout.

This class is used by custom layouts.

See also QLayout, QLayout::spacerItem(), Widget Appearance and Style, and Layout Management.

## MEMBER FUNCTION DOCUMENTATION

## QSpacerItem::QSpacerItem ( int w, int h, QSizePolicy::SizeType hData = QSizePolicy::Minimum, QSizePolicy::SizeType vData = QSizePolicy::Minimum )

Constructs a spacer item with preferred width *w*, preferred height *h*, horizontal size policy *hData* and vertical size policy *vData*.

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::SizeType hData = QSizePolicy::Minimum, QSizePolicy::SizeType vData = QSizePolicy::Minimum )

Changes this spacer item to have preferred width *w*, preferred height *h*, horizontal size policy *hData* and vertical size policy *vData*.

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

## QSizePolicy::ExpandData QSpacerItem::expanding () const` [virtual]`

Returns the direction in which this spacer item will expand.

See also QSizePolicy::ExpandData.

Reimplemented from QLayoutItem.

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

Returns TRUE because a spacer item never contains widgets.

Reimplemented from QLayoutItem.

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

Returns the maximum size of this spacer item.

Reimplemented from QLayoutItem.

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

Returns the minimum size of this spacer item.

Reimplemented from QLayoutItem.

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

Stores the spacer item's rect *r* so that it can be returned by geometry().

Reimplemented from QLayoutItem.

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

Returns the preferred size of this spacer item.

Reimplemented from QLayoutItem.

## SEE ALSO

**http://doc.trolltech.com/qspaceritem.html** **http://www.trolltech.com/faq/tech.html**

## COPYRIGHT

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the license file included in the distribution for a complete license statement.

## AUTHOR

Generated automatically from the source code.

## BUGS

If you find a bug in Qt, please report it as described in **http://doc.trolltech.com/bughowto.html**. Good bug reports help us to help you. Thank you.

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to **qt-bugs@trolltech.com**. Please include the name of the manual page (qspaceritem.3qt) and the Qt version (3.3.8).