QSplitter Class Reference

#include <qsplitter.h>

Inheritance diagram for QSplitter:

[legend]Collaboration diagram for QSplitter:

[legend]List of all members.

---

Detailed Description

The QSplitter class implements a splitter widget.

A splitter lets the user control the size of child widgets by dragging the boundary between the children. Any number of widgets may be controlled by a single splitter. The typical use of a QSplitter is to create several widgets and add them using insertWidget() or addWidget().

The following example will show a QListView, QTreeView, and QTextEdit side by side, with two splitter handles:

snippets/splitter/splitter.cpp QSplitter splitter->addWidget(textedit);

If a widget is already inside a QSplitter when insertWidget() or addWidget() is called, it will move to the new position. This can be used to reorder widgets in the splitter later. You can use indexOf(), widget(), and count() to get access to the widgets inside the splitter.

A default QSplitter lays out its children horizontally (side by side); you can use setOrientation(Qt::Vertical) to lay its children out vertically.

By default, all widgets can be as large or as small as the user wishes, between the minimumSizeHint() (or minimumSize()) and maximumSize() of the widgets.

QSplitter resizes its children dynamically by default. If you would rather have QSplitter resize the children only at the end of a resize operation, call setOpaqueResize(false).

The initial distribution of size between the widgets is determined by the initial size of each widget. You can also use setSizes() to set the sizes of all the widgets. The function sizes() returns the sizes set by the user. Alternatively, you can save and restore the sizes of the widgets from a QByteArray using saveState() and restoreState() respectively.

When you hide() a child its space will be distributed among the other children. It will be reinstated when you show() it again.

See also:

QSplitterHandle, QHBoxLayout, QVBoxLayout, QTabWidget

Definition at line 42 of file qsplitter.h.

Signals
void	splitterMoved (int pos, int index)
Public Member Functions
	QSplitter (QWidget *parent=0)
	QSplitter (Qt::Orientation, QWidget *parent=0)
	~QSplitter ()
void	addWidget (QWidget *widget)
void	insertWidget (int index, QWidget *widget)
void	setOrientation (Qt::Orientation)
Qt::Orientation	orientation () const
void	setChildrenCollapsible (bool)
bool	childrenCollapsible () const
void	setCollapsible (int index, bool)
bool	isCollapsible (int index) const
void	setOpaqueResize (bool opaque=true)
bool	opaqueResize () const
void	refresh ()
QSize	sizeHint () const
QSize	minimumSizeHint () const
QList< int >	sizes () const
void	setSizes (const QList< int > &list)
QByteArray	saveState () const
bool	restoreState (const QByteArray &state)
int	handleWidth () const
void	setHandleWidth (int)
int	indexOf (QWidget *w) const
QWidget *	widget (int index) const
int	count () const
void	getRange (int index, int *, int *) const
QSplitterHandle *	handle (int index) const
void	setStretchFactor (int index, int stretch)
Protected Member Functions
virtual QSplitterHandle *	createHandle ()
void	childEvent (QChildEvent *)
bool	event (QEvent *)
void	resizeEvent (QResizeEvent *)
void	changeEvent (QEvent *)
void	moveSplitter (int pos, int index)
void	setRubberBand (int position)
int	closestLegalPosition (int, int)
Friends
class	QSplitterHandle
Related Functions
(Note that these are not member functions.)
QTextStream &	operator<< (QTextStream &ts, const QSplitter &splitter)
QTextStream &	operator>> (QTextStream &ts, QSplitter &splitter)

---

Constructor & Destructor Documentation

QSplitter::QSplitter

(

QWidget *

parent = 0

)

[explicit]

Constructs a horizontal splitter with the parent arguments is passed on to the QFrame constructor.

See also:

setOrientation()

Definition at line 913 of file qsplitter.cpp.

References d, and Qt::Horizontal.

    : QFrame(*new QSplitterPrivate, parent)
{
    Q_D(QSplitter);
    d->orient = Qt::Horizontal;
    d->init();
}

QSplitter::QSplitter	(	Qt::Orientation	orientation,
		QWidget *	parent = 0
	)			[explicit]

Constructs a splitter with the given orientation and parent.

See also:

setOrientation()

Definition at line 927 of file qsplitter.cpp.

References d.

    : QFrame(*new QSplitterPrivate, parent)
{
    Q_D(QSplitter);
    d->orient = orientation;
    d->init();
}

QSplitter::~QSplitter

(

)

Destroys the splitter. All children are deleted.

Definition at line 940 of file qsplitter.cpp.

References d.

{
    Q_D(QSplitter);
    while (!d->list.isEmpty())
        delete d->list.takeFirst();
}

---

Member Function Documentation

void QSplitter::addWidget

(

QWidget *

widget

)

Adds the given widget to the splitter's layout after all the other items.

If widget is already in the splitter, it will be moved to the new position.

See also:

insertWidget() widget() indexOf()

Definition at line 1073 of file qsplitter.cpp.

References d, insertWidget(), and widget().

Referenced by qdesigner_internal::ActionEditor::ActionEditor(), childEvent(), qdesigner_internal::HorizontalLayout::doLayout(), qdesigner_internal::VerticalLayout::doLayout(), Main::Main(), main(), MainWindow::MainWindow(), and MainWindow::setupViews().

{
    Q_D(QSplitter);
    insertWidget(d->list.count(), widget);
}

Here is the call graph for this function:

void QSplitter::insertWidget	(	int	index,
		QWidget *	widget
	)

Inserts the widget specified into the splitter's layout at the given index.

If widget is already in the splitter, it will be moved to the new position.

if index is an invalid index, then the widget will be inserted at the end.

See also:

addWidget() indexOf() widget()

Definition at line 1089 of file qsplitter.cpp.

References b, d, QWidget::isHidden(), QWidget::isVisible(), QWidget::parentWidget(), QWidget::setParent(), QWidget::show(), QWidget::testAttribute(), Qt::WA_WState_ExplicitShowHide, and widget().

Referenced by addWidget().

{
    Q_D(QSplitter);
    QBoolBlocker b(d->blockChildAdd);
    bool needShow = isVisible() &&
                    !(widget->isHidden() && widget->testAttribute(Qt::WA_WState_ExplicitShowHide));
    if (widget->parentWidget() != this)
        widget->setParent(this);
    if (needShow)
        widget->show();
    d->insertWidget(index, widget);
    d->recalc(isVisible());
}

Here is the call graph for this function:

void QSplitter::setOrientation

(

Qt::Orientation

)

Definition at line 968 of file qsplitter.cpp.

References d, i, QWidget::isVisible(), s, QWidget::setAttribute(), QWidget::setSizePolicy(), QWidget::sizePolicy(), QWidget::testAttribute(), QSizePolicy::transpose(), and Qt::WA_WState_OwnSizePolicy.

Referenced by MainWindow::MainWindow(), and restoreState().

{
    Q_D(QSplitter);
    if (d->orient == orientation)
        return;

    if (!testAttribute(Qt::WA_WState_OwnSizePolicy)) {
        QSizePolicy sp = sizePolicy();
        sp.transpose();
        setSizePolicy(sp);
        setAttribute(Qt::WA_WState_OwnSizePolicy, false);
    }

    d->orient = orientation;

    for (int i = 0; i < d->list.size(); ++i) {
        QSplitterLayoutStruct *s = d->list.at(i);
        s->handle->setOrientation(orientation);
    }
    d->recalc(isVisible());
}

Here is the call graph for this function:

Qt::Orientation QSplitter::orientation

(

)

const

Definition at line 990 of file qsplitter.cpp.

References d.

Referenced by minimumSizeHint(), saveState(), and sizeHint().

{
    Q_D(const QSplitter);
    return d->orient;
}

void QSplitter::setChildrenCollapsible

(

bool

)

Definition at line 1007 of file qsplitter.cpp.

References d.

Referenced by restoreState().

{
    Q_D(QSplitter);
    d->childrenCollapsible = collapse;
}

bool QSplitter::childrenCollapsible

(

)

const

Definition at line 1013 of file qsplitter.cpp.

References d.

Referenced by saveState().

{
    Q_D(const QSplitter);
    return d->childrenCollapsible;
}

void QSplitter::setCollapsible	(	int	index,
		bool	collapse
	)

Sets whether the child widget at index index is collapsible to collapse.

By default, children are collapsible, meaning that the user can resize them down to size 0, even if they have a non-zero minimumSize() or minimumSizeHint(). This behavior can be changed on a per-widget basis by calling this function, or globally for all the widgets in the splitter by setting the childrenCollapsible property.

See also:

childrenCollapsible

Definition at line 1032 of file qsplitter.cpp.

References d, and qWarning().

{
    Q_D(QSplitter);

    if (index < 0 || index >= d->list.size()) {
        qWarning("QSplitter::setCollapsible: Index %d out of range", index);
        return;
    }
    d->list.at(index)->collapsible = collapse ? 1 : 0;
}

Here is the call graph for this function:

bool QSplitter::isCollapsible

(

int

index

)

const

Returns true if the widget at index is collapsible, otherwise returns false

Definition at line 1046 of file qsplitter.cpp.

References d, and qWarning().

{
    Q_D(const QSplitter);
    if (index < 0 || index >= d->list.size()) {
        qWarning("QSplitter::isCollapsible: Index %d out of range", index);
        return false;
    }
    return d->list.at(index)->collapsible;
}

Here is the call graph for this function:

void QSplitter::setOpaqueResize

(

bool

opaque = true

)

Definition at line 1396 of file qsplitter.cpp.

References d.

Referenced by restoreState().

{
    Q_D(QSplitter);
    d->opaque = on;
}

bool QSplitter::opaqueResize

(

)

const

Definition at line 1389 of file qsplitter.cpp.

References d.

Referenced by saveState().

{
    Q_D(const QSplitter);
    return d->opaque;
}

void QSplitter::refresh

(

)

Updates the splitter's state. You should not need to call this function.

Definition at line 951 of file qsplitter.cpp.

References d.

{
    Q_D(QSplitter);
    d->recalc(true);
}

QSize QSplitter::sizeHint

(

)

const [virtual]

Reimplemented from QFrame.

Definition at line 1472 of file qsplitter.cpp.

References QList< T >::at(), QObject::children(), d, QWidget::ensurePolished(), Qt::Horizontal, i, l, orientation(), qMax(), qobject_cast< QWidget * >(), s, QList< T >::size(), t, and w.

{
    Q_D(const QSplitter);
    ensurePolished();
    int l = 0;
    int t = 0;
    QObjectList childList = children();
    for (int i = 0; i < childList.size(); ++i) {
        if (QWidget *w = qobject_cast<QWidget *>(childList.at(i))) {
            if (w->isHidden())
                continue;
            QSize s = w->sizeHint();
            if (s.isValid()) {
                l += d->pick(s);
                t = qMax(t, d->trans(s));
            }
        }
    }
    return orientation() == Qt::Horizontal ? QSize(l, t) : QSize(t, l);
}

Here is the call graph for this function:

QSize QSplitter::minimumSizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 1498 of file qsplitter.cpp.

References QList< T >::at(), QObject::children(), d, QWidget::ensurePolished(), Qt::Horizontal, i, l, orientation(), qMax(), qobject_cast< QWidget * >(), qSmartMinSize(), s, QList< T >::size(), t, and w.

{
    Q_D(const QSplitter);
    ensurePolished();
    int l = 0;
    int t = 0;
    QObjectList childList = children();
    for (int i = 0; i < childList.size(); ++i) {
        if (QWidget *w = qobject_cast<QWidget *>(childList.at(i))) {
            if (w->isHidden())
                continue;
            QSize s = qSmartMinSize(w);
            if (s.isValid()) {
                l += d->pick(s);
                t = qMax(t, d->trans(s));
            }
        }
    }
    return orientation() == Qt::Horizontal ? QSize(l, t) : QSize(t, l);
}

Here is the call graph for this function:

QList< int > QSplitter::sizes

(

)

const

Returns a list of the size parameters of all the widgets in this splitter.

If the splitter's orientation is horizontal, the list is a list of widget widths; if the orientation is vertical, the list is a list of widget heights.

Giving the values to another splitter's setSizes() function will produce a splitter with the same layout as this one.

The easiest way to iterate over the list is to use the Java-style iterators.

snippets/splitter/splitter.cpp QListIterator<int> processSize(it.next());

See also:

setSizes()

Definition at line 1540 of file qsplitter.cpp.

References QList< T >::append(), d, QWidget::ensurePolished(), i, and s.

Referenced by saveState().

{
    Q_D(const QSplitter);
    ensurePolished();

    QList<int> list;
    for (int i = 0; i < d->list.size(); ++i) {
        QSplitterLayoutStruct *s = d->list.at(i);
        list.append(d->pick(s->rect.size()));
    }
    return list;
}

Here is the call graph for this function:

void QSplitter::setSizes

(

const QList< int > &

list

)

Sets the size parameters to the values given in the list. If the splitter is horizontal, the values set the widths of each widget going from left to right. If the splitter is vertical, the values set the heights of each widget going from top to bottom. Extra values in the list are ignored.

If list contains too few values, the result is undefined but the program will still be well-behaved.

The values in list should be the height or width (depending on orientation()) that the widgets should be resized to.

See also:

sizes()

Definition at line 1569 of file qsplitter.cpp.

References d, i, j, qMax(), qSmartMinSize(), s, and QList< T >::value().

Referenced by restoreState().

{
    Q_D(QSplitter);
    int j = 0;

    for (int i = 0; i < d->list.size(); ++i) {
        QSplitterLayoutStruct *s = d->list.at(i);

        s->collapsed = false;
        s->sizer = qMax(list.value(j++), 0);
        int smartMinSize = d->pick(qSmartMinSize(s->widget));

        // Make sure that we reset the collapsed state.
        if (s->sizer == 0) {
            if (d->collapsible(s) && smartMinSize > 0) {
                s->collapsed = true;
            } else {
                s->sizer = smartMinSize;
            }
        } else {
            if (s->sizer < smartMinSize)
                s->sizer = smartMinSize;
        }
    }
    d->doResize();
}

Here is the call graph for this function:

QByteArray QSplitter::saveState

(

)

const

Saves the state of the splitter's layout.

Typically this is used in conjunction with QSettings to remember the size for a future session. A version number is stored as part of the data. Here is an example:

snippets/splitter/splitter.cpp SAVE QSettings saveState()

See also:

restoreState()

Definition at line 1645 of file qsplitter.cpp.

References childrenCollapsible(), data, handleWidth(), opaqueResize(), orientation(), sizes(), QTest::stream, version, and QIODevice::WriteOnly.

Referenced by operator<<().

{
    int version = 0;
    QByteArray data;
    QDataStream stream(&data, QIODevice::WriteOnly);

    stream << qint32(SplitterMagic);
    stream << qint32(version);
    stream << sizes();
    stream << childrenCollapsible();
    stream << qint32(handleWidth());
    stream << opaqueResize();
    stream << qint32(orientation());
    return data;
}

Here is the call graph for this function:

bool QSplitter::restoreState

(

const QByteArray &

state

)

Restores the splitter's layout to the state specified. Returns true if the state is restored; otherwise returns false.

Typically this is used in conjunction with QSettings to restore the size from a past session. Here is an example:

Restore the splitters's state:

snippets/splitter/splitter.cpp RESTORE QSettings restoreState(

A failure to restore the splitter's layout may result from either invalid or out-of-date data in the supplied byte array.

See also:

saveState()

Definition at line 1680 of file qsplitter.cpp.

References b, d, i, marker, QIODevice::ReadOnly, setChildrenCollapsible(), setHandleWidth(), setOpaqueResize(), setOrientation(), setSizes(), QTest::stream, and version.

Referenced by operator>>().

{
    Q_D(QSplitter);
    int version = 0;
    QByteArray sd = state;
    QDataStream stream(&sd, QIODevice::ReadOnly);
    QList<int> list;
    bool b;
    qint32 i;
    qint32 marker;
    qint32 v;

    stream >> marker;
    stream >> v;
    if (marker != SplitterMagic || v != version)
        return false;

    stream >> list;
    setSizes(list);

    stream >> b;
    setChildrenCollapsible(b);

    stream >> i;
    setHandleWidth(i);

    stream >> b;
    setOpaqueResize(b);

    stream >> i;
    setOrientation(Qt::Orientation(i));
    d->doResize();

    return true;
}

Here is the call graph for this function:

int QSplitter::handleWidth

(

)

const

Definition at line 1601 of file qsplitter.cpp.

References d, QStyle::pixelMetric(), QStyle::PM_SplitterWidth, and QWidget::style().

Referenced by saveState(), and setRubberBand().

{
    Q_D(const QSplitter);
    if (d->handleWidth > 0) {
        return d->handleWidth;
    } else {
        return style()->pixelMetric(QStyle::PM_SplitterWidth, 0, this);
    }
}

Here is the call graph for this function:

void QSplitter::setHandleWidth

(

int

)

Definition at line 1611 of file qsplitter.cpp.

References d.

Referenced by restoreState().

{
    Q_D(QSplitter);
    d->handleWidth = width;
    d->updateHandles();
}

int QSplitter::indexOf

(

QWidget *

widget

)

const

Returns the index in the splitter's layout of the specified widget. This also works for handles.

Handles are numbered from 0. There are as many handles as there are child widgets, but the handle at position 0 is always hidden.

See also:

count(), widget()

Definition at line 1115 of file qsplitter.cpp.

References d, i, s, and w.

{
    Q_D(const QSplitter);
    for (int i = 0; i < d->list.size(); ++i) {
        QSplitterLayoutStruct *s = d->list.at(i);
        if (s->widget == w || s->handle == w)
            return i;
    }
    return -1;
}

QWidget * QSplitter::widget

(

int

index

)

const

Returns the widget at the given index in the splitter's layout.

See also:

count(), handle(), indexOf(), insertWidget()

Definition at line 1163 of file qsplitter.cpp.

References d.

Referenced by addWidget(), insertWidget(), and setStretchFactor().

{
    Q_D(const QSplitter);
    if (index < 0 || index >= d->list.size())
        return 0;
    return d->list.at(index)->widget;
}

int QSplitter::count

(

)

const

Returns the number of widgets contained in the splitter's layout.

See also:

widget(), handle()

Definition at line 1176 of file qsplitter.cpp.

References d.

Referenced by moveSplitter().

{
    Q_D(const QSplitter);
    return d->list.count();
}

void QSplitter::getRange	(	int	index,
		int *	min,
		int *	max
	)			const

Returns the valid range of the splitter with index index in {min} and *{max} if min and max are not 0.

Definition at line 1357 of file qsplitter.cpp.

References d.

{
    Q_D(const QSplitter);
    d->getRange(index, min, 0, 0, max);
}

QSplitterHandle * QSplitter::handle

(

int

index

)

const

Returns the handle to the left (or above) for the item in the splitter's layout at the given index. The handle at index 0 is always hidden.

For right-to-left languages such as Arabic and Hebrew, the layout of horizontal splitters is reversed. The handle will be to the right of the widget at index.

See also:

count(), widget(), indexOf(), createHandle(), setHandleWidth()

Definition at line 1150 of file qsplitter.cpp.

References d.

{
    Q_D(const QSplitter);
    if (index < 0 || index >= d->list.size())
        return 0;
    return d->list.at(index)->handle;
}

void QSplitter::setStretchFactor	(	int	index,
		int	stretch
	)

Updates the size policy of the widget at position index to have a stretch factor of stretch.

This function is provided for convenience. It is equivalent to

        QWidget *widget = splitter->widget(index);
        QSizePolicy policy = widget->sizePolicy();
        policy.setHorizontalStretch(stretch);
        policy.setVerticalStretch(stretch);
        widget->setSizePolicy(policy);

See also:

setSizes(), widget()

Definition at line 1732 of file qsplitter.cpp.

References d, QSizePolicy::setHorizontalStretch(), QWidget::setSizePolicy(), QSizePolicy::setVerticalStretch(), QWidget::sizePolicy(), and widget().

Referenced by MainWindow::setupViews().

{
    Q_D(QSplitter);
    if (index <= -1 || index >= d->list.count())
        return;

    QWidget *widget = d->list.at(index)->widget;
    QSizePolicy sp = widget->sizePolicy();
    sp.setHorizontalStretch(stretch);
    sp.setVerticalStretch(stretch);
    widget->setSizePolicy(sp);
}

Here is the call graph for this function:

QSplitter::splitterMoved	(	int	pos,
		int	index
	)			[signal]

This signal is emitted when the splitter handle at a particular index has been moved to position pos.

For right-to-left languages such as Arabic and Hebrew, the layout of horizontal splitters is reversed. pos is then the distance from the right edge of the widget.

See also:

moveSplitter()

Referenced by moveSplitter().

QSplitterHandle * QSplitter::createHandle

(

)

[protected, virtual]

Returns a new splitter handle as a child widget of this splitter. This function can be reimplemented in subclasses to provide support for custom handles.

See also:

handle(), indexOf()

Definition at line 1133 of file qsplitter.cpp.

References d, and QSplitterHandle.

{
    Q_D(QSplitter);
    return new QSplitterHandle(d->orient, this);
}

void QSplitter::childEvent

(

QChildEvent *

c

)

[protected, virtual]

Tells the splitter that the child widget described by c has been inserted or removed.

This method is also used to handle the situation where a widget is created with the splitter as a parent but not explicitly added with insertWidget() or addWidget(). This is for compatibility and not the recommended way of putting widgets into a splitter in new code. Please use insertWidget() or addWidget() in new code.

See also:

addWidget() insertWidget()

Reimplemented from QObject.

Definition at line 1197 of file qsplitter.cpp.

References addWidget(), c, QEvent::ChildRemoved, d, i, QWidget::isVisible(), s, and w.

{
    Q_D(QSplitter);
    if (!c->child()->isWidgetType())
        return;
    QWidget *w = static_cast<QWidget*>(c->child());

    if (c->added() && !d->blockChildAdd && !w->isWindow() && !d->findWidget(w)) {
        addWidget(w);
    } else  if (c->type() == QEvent::ChildRemoved) {
        for (int i = 0; i < d->list.size(); ++i) {
            QSplitterLayoutStruct *s = d->list.at(i);
            if (s->widget == w) {
                d->list.removeAt(i);
                delete s;
                d->recalc(isVisible());
                return;
            }
        }
    }
}

Here is the call graph for this function:

bool QSplitter::event

(

QEvent *

e

)

[protected, virtual]

Reimplemented from QFrame.

Definition at line 1254 of file qsplitter.cpp.

References d, QWidget::event(), QEvent::Hide, QEvent::HideToParent, QWidget::isVisible(), QEvent::LayoutRequest, QEvent::Show, QEvent::ShowToParent, and QEvent::type().

{
    Q_D(QSplitter);
    switch (e->type()) {
    case QEvent::Hide:
        // Reset firstShow to false here since things can be done to the splitter in between
        if (!d->firstShow)
            d->firstShow = true;
        break;
    case QEvent::Show:
        if (!d->firstShow)
            break;
        d->firstShow = false;
        // fall through
    case QEvent::HideToParent:
    case QEvent::ShowToParent:
    case QEvent::LayoutRequest:
#ifdef QT3_SUPPORT
    case QEvent::LayoutHint:
#endif
        d->recalc(isVisible());
        break;
    default:
        ;
    }
    return QWidget::event(e);
}

Here is the call graph for this function:

void QSplitter::resizeEvent

(

QResizeEvent *

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 1059 of file qsplitter.cpp.

References d.

{
    Q_D(QSplitter);
    d->doResize();
}

void QSplitter::changeEvent

(

QEvent *

ev

)

[protected, virtual]

Reimplemented from QFrame.

Definition at line 1621 of file qsplitter.cpp.

References QFrame::changeEvent(), d, QEvent::StyleChange, and QEvent::type().

{
    Q_D(QSplitter);
    if(ev->type() == QEvent::StyleChange)
        d->updateHandles();
    QFrame::changeEvent(ev);
}

Here is the call graph for this function:

void QSplitter::moveSplitter	(	int	pos,
		int	index
	)			[protected]

Moves the left or top edge of the splitter handle at index as close as possible to position pos, which is the distance from the left or top edge of the widget.

For right-to-left languages such as Arabic and Hebrew, the layout of horizontal splitters is reversed. pos is then the distance from the right edge of the widget.

See also:

splitterMoved(), closestLegalPosition(), getRange()

Definition at line 1306 of file qsplitter.cpp.

References count(), d, emit, qDebug(), s, splitterMoved(), and ws().

{
    Q_D(QSplitter);
    QSplitterLayoutStruct *s = d->list.at(index);
    int farMin;
    int min;
    int max;
    int farMax;

#ifdef QSPLITTER_DEBUG
    int debugp = pos;
#endif

    pos = d->adjustPos(pos, index, &farMin, &min, &max, &farMax);
    int oldP = d->pick(s->rect.topLeft());
#ifdef QSPLITTER_DEBUG
    qDebug() << "QSplitter::moveSplitter" << debugp << index << "adjusted" << pos << "oldP" << oldP;
#endif

    QVarLengthArray<int, 32> poss(d->list.count());
    QVarLengthArray<int, 32> ws(d->list.count());
    bool upLeft;

    d->doMove(false, pos, index, +1, (d->collapsible(s) && (pos > max)), poss.data(), ws.data());
    d->doMove(true, pos, index - 1, +1, (d->collapsible(index - 1) && (pos < min)), poss.data(), ws.data());
    upLeft = (pos < oldP);

    int wid, delta, count = d->list.count();
    if (upLeft) {
        wid = 0;
        delta = 1;
    } else {
        wid = count - 1;
        delta = -1;
    }
    for (; wid >= 0 && wid < count; wid += delta) {
        QSplitterLayoutStruct *sls = d->list.at( wid );
        if (!sls->widget->isHidden())
            d->setGeo(sls, poss[wid], ws[wid], true);
    }
    d->storeSizes();

    emit splitterMoved(pos, index);
}

Here is the call graph for this function:

void QSplitter::setRubberBand

(

int

pos

)

[protected]

Displays a rubber band at position pos. If pos is negative, the rubber band is removed.

Definition at line 1225 of file qsplitter.cpp.

References QWidget::contentsRect(), d, handleWidth(), QRect::height(), Qt::Horizontal, QRubberBand::Line, QRect::width(), QRect::x(), and QRect::y().

{
    Q_D(QSplitter);
    if (pos < 0) {
        if (d->rubberBand)
            d->rubberBand->hide();
        return;
    }
    QRect r = contentsRect();
    const int rBord = 3; // customizable?
    int hw = handleWidth();
    if (!d->rubberBand) {
        QBoolBlocker block(d->blockChildAdd);
        d->rubberBand = new QRubberBand(QRubberBand::Line, this);
    }
    if (d->orient == Qt::Horizontal)
        d->rubberBand->setGeometry(QRect(QPoint(pos + hw / 2 - rBord, r.y()),
                                         QSize(2 * rBord, r.height())));
    else
        d->rubberBand->setGeometry(QRect(QPoint(r.x(), pos + hw / 2 - rBord),
                                   QSize(r.width(), 2 * rBord)));
    if (!d->rubberBand->isVisible())
        d->rubberBand->show();
}

Here is the call graph for this function:

int QSplitter::closestLegalPosition	(	int	pos,
		int	index
	)			[protected]

Returns the closest legal position to pos of the widget with index index.

For right-to-left languages such as Arabic and Hebrew, the layout of horizontal splitters is reversed. Positions are then measured from the right edge of the widget.

See also:

getRange()

Definition at line 1375 of file qsplitter.cpp.

References d, i, n, u, and QWidget::x().

{
    Q_D(QSplitter);
    int x, i, n, u;
    return d->adjustPos(pos, index, &u, &n, &i, &x);
}

Here is the call graph for this function:

---

Friends And Related Function Documentation

friend class QSplitterHandle [friend]

Definition at line 127 of file qsplitter.h.

Referenced by createHandle().

QTextStream & operator<<	(	QTextStream &	ts,
		const QSplitter &	splitter
	)			[related]

Use ts << {splitter}.saveState() instead.

Definition at line 1755 of file qsplitter.cpp.

References QTextStream::endl(), and saveState().

{
    ts << splitter.saveState() << endl;
    return ts;
}

Here is the call graph for this function:

QTextStream & operator>>	(	QTextStream &	ts,
		QSplitter &	splitter
	)			[related]

Use ts >> {splitter}.restoreState() instead.

Definition at line 1768 of file qsplitter.cpp.

References QTextStream::readLine(), QString::replace(), restoreState(), QString::simplified(), QString::toAscii(), and QString::toUpper().

{
    QString line = ts.readLine();
    line = line.simplified();
    line.replace(QLatin1Char(' '), QString());
    line = line.toUpper();

    splitter.restoreState(line.toAscii());
    return ts;
}

Here is the call graph for this function:

---

The documentation for this class was generated from the following files:

• src/gui/widgets/qsplitter.h
• src/gui/widgets/qsplitter.cpp

---