Qt Reference Documentation

# Qt 3 Support Members for QLayout

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

- QLayout class reference

## Public Functions

| QLayout ( QWidget * parent, int margin, int spacing = -1, const char * name = 0 )
| QLayout ( QLayout * parentLayout, int spacing = -1, const char * name = 0 )
| QLayout ( int spacing, const char * name = 0 )
void | add ( QWidget * widget )
bool | autoAdd () const
int | defaultBorder () const
void | freeze ( int w = 0, int h = 0 )
bool | isTopLevel () const
QLayoutIterator | iterator ()
QWidget * | mainWidget () const
void | remove ( QWidget * widget )
SizeConstraint | resizeMode () const
void | setAutoAdd ( bool a )
void | setResizeMode ( SizeConstraint constraint )

- 8 public functions inherited from QObject

## Protected Functions

void | deleteAllItems ()

- 1 protected function inherited from QObject

## Member Function Documentation

### QLayout::QLayout ( QWidget * parent, int margin, int spacing = -1, const char * name = 0 )

Constructs a new top-level QLayout called name, with parent widget parent. parent may not be 0.

The margin is the number of pixels between the edge of the widget and the managed children. The spacing sets the value of spacing(), which gives the spacing between the managed widgets. If spacing is -1 (the default), spacing is set to the value of margin.

There can be only one top-level layout for a widget. It is returned by QWidget::layout()

See also QWidget::setLayout().

### QLayout::QLayout ( QLayout * parentLayout, int spacing = -1, const char * name = 0 )

Constructs a new child QLayout called name, and places it inside parentLayout by using the default placement defined by addItem().

If spacing is -1, this QLayout inherits parentLayout's spacing(), otherwise the value of spacing is used.

### QLayout::QLayout ( int spacing, const char * name = 0 )

Constructs a new child QLayout called name. If spacing is -1, this QLayout inherits its parent's spacing(); otherwise the value of spacing is used.

This layout has to be inserted into another layout before geometry management will work.

### void QLayout::add ( QWidget * widget )

Use addWidget(widget) instead.

### bool QLayout::autoAdd () const

Automatically adding widgets is deprecated. Use addWidget() or addLayout() instead.

See also setAutoAdd().

### int QLayout::defaultBorder () const

Use spacing() instead.

### void QLayout::deleteAllItems ()`[protected]`

Removes and deletes all items in this layout.

### void QLayout::freeze ( int w = 0, int h = 0 )

Sets this layout's parent widget to a fixed size with width w and height h, stopping the user from resizing it, and also prevents the layout from resizing it, even if the layout's size hint should change. Does nothing if this is not a top-level layout (i.e., if parent()->isWidgetType()).

As a special case, if both w and h are 0, then the layout's current sizeHint() is used.

Use `setResizeMode(Fixed)` to stop the widget from being resized by the user, while still allowing the layout to resize it when the sizeHint() changes.

Use `setResizeMode(FreeResize)` to allow the user to resize the widget, while preventing the layout from resizing it.

### bool QLayout::isTopLevel () const

Returns true if this layout is a top-level layout, i.e. not a child of another layout; otherwise returns false.

### QLayoutIterator QLayout::iterator ()

Use a QLayoutIterator() constructor instead.

### QWidget * QLayout::mainWidget () const

Use parentWidget() instead.

### void QLayout::remove ( QWidget * widget )

Use removeWidget(widget) instead.

### SizeConstraint QLayout::resizeMode () const

Use sizeConstraint() instead.

See also setResizeMode().

### void QLayout::setAutoAdd ( bool a )

Automatically adding widgets is deprecated. Use addWidget() or addLayout() instead.

See also autoAdd().

### void QLayout::setResizeMode ( SizeConstraint constraint )

Use setSizeConstraint(constraint) instead.

See also resizeMode().