![]() |
| ||
Classes - Annotated - Tree - Functions - Home - Structure |
The QBoxLayout class lines up child widgets horizontally or vertically. More...
#include <qlayout.h>
Inherits QLayout.
Inherited by QHBoxLayout and QVBoxLayout.
The QBoxLayout class lines up child widgets horizontally or vertically.
QBoxLayout takes the space it gets (from its parent layout or from the mainWidget()), divides it up into a row of boxes, and makes each managed widget fill one box.
If the QBoxLayout is Horizontal the boxes are beside each other, with suitable sizes. Each widget (or other box) will get at least its minimum sizes and at most its maximum size. Any excess space is shared according to the stretch factors (more about that below).
If the QBoxLayout is Vertical, the boxes are above and below each other, again with suitable sizes.
The easiest way to create a QBoxLayout is to use one of the convenience classes QHBoxLayout (for Horizontal boxes) or QVBoxLayout (for Vertical boxes). You can also use the QBoxLayout constructor directly, specifying its direction as LeftToRight, Down, RightToLeft or Up.
If the QBoxLayout is not the top-level layout (i.e., it is not managing all of the widget's area and children), you must add it to its parent layout before you can do anything with it. The normal way to add a layout is by calling parentLayout->addLayout().
Once you have done that, you can add boxes to the QBoxLayout using one of four functions:
Use insertWidget(), insertSpacing(), insertStretch() or insertLayout() to insert a box at a specified position in the layout.
QBoxLayout also includes two margin widths:
The outer border width defaults to 0; the intra-widget width defaults to the same as the border width for a top-level layout, or otherwise to the same as the parent layout. Both can be set using arguments to the constructor.
You will almost always want to use the convenience classes for QBoxLayout - QVBoxLayout and QHBoxLayout - because of their simpler constructors.
See also the Layout overview documentation.
This type is used to determine the direction of a box layout. The possible values are the following:
border is the number of pixels between the edge of the widget and the managed children. space is the default number of pixels between neighboring children. If space is -1 the value of border is used.
name is the internal object name
See also direction().
You have to insert this box into another layout.
Reimplemented from QLayout.
See also insertLayout(), setAutoAdd(), addWidget() and addSpacing().
Examples: fonts/simple-qfont-demo/viewer.cpp, listbox/listbox.cpp, tictac/tictac.cpp and validator/vw.cpp.
See also insertSpacing() and addStretch().
Example: listbox/listbox.cpp.
See also addSpacing().
Examples: layout/layout.cpp, listbox/listbox.cpp, t11/main.cpp, t13/gamebrd.cpp, t14/gamebrd.cpp and validator/vw.cpp.
The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factor grow more.
If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.
Alignment is specified by alignment which is a bitwise OR of Qt::AlignmentFlags values. The default alignment is 0, which means that the widget fills the entire cell.
Note: The alignment parameter is interpreted more aggressively than in previous versions of Qt. A non-default alignment now indicates that the widget should not grow to fill the available space, but should be sized according to sizeHint().
See also insertWidget(), setAutoAdd(), addLayout() and addSpacing().
Examples: layout/layout.cpp, lineedits/lineedits.cpp, listbox/listbox.cpp, t13/gamebrd.cpp, t13/lcdrange.cpp and t14/gamebrd.cpp.
Returns the (serial) direction of the box. addWidget() and addSpacing() work in this direction; the stretch stretches in this direction.
The directions are LeftToRight, RightToLeft, TopToBottom, and BottomToTop. For the last two the shorter aliases Down and Up are also available.
See also addWidget() and addSpacing().
Reimplemented from QLayout.
Returns the index of w, or -1 if w is not found.
Reimplemented from QLayoutItem.
Reimplemented from QLayoutItem.
Warning: does not call QLayout::insertChildLayout() if item is a QLayout.
See also addItem() and findWidget().
See also setAutoAdd(), insertWidget() and insertSpacing().
QBoxLayout gives default border and spacing. This function adds additional space.
See also insertStretch().
See also insertSpacing().
The stretch factor applies only in the direction of the QBoxLayout, and is relative to the other boxes and widgets in this QBoxLayout. Widgets and boxes with higher stretch factor grow more.
If the stretch factor is 0 and nothing else in the QBoxLayout has a stretch factor greater than zero, the space is distributed according to the QWidget:sizePolicy() of each widget that's involved.
Alignment is specified by alignment, which is a bitwise OR of Qt::AlignmentFlags values. The default alignment is 0, which means that the widget fills the entire cell.
Note: The alignment parameter is interpreted more aggressively than in previous versions of Qt. A non-default alignment now indicates that the widget should not grow to fill the available space, but should be sized according to sizeHint().
See also setAutoAdd(), insertLayout() and insertSpacing().
Reimplemented from QLayout.
Reimplemented from QLayout.
Reimplemented from QLayout.
Reimplemented from QLayout.
Returns FALSE if w is not found.
Returns FALSE if l is not found.
Reimplemented from QLayoutItem.
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.
Copyright © 2001 Trolltech | Trademarks | Qt version 3.0.0-beta1-beta1
|