Splitter Class Reference

A special splitter that lacks many of the features of QSplitter, but has some other features we need: One can replace one widget by another, add widgets at an arbitrary position in the chain, and the user can resize the widgets by moving a SplitterBar (which is much easier to grab than a QSplitterHandle) around. More...

#include <splitter.h>

Inheritance diagram for Splitter:

[legend]Collaboration diagram for Splitter:

[legend]List of all members.


Signals
void	collapsed (Splitter *splitter)
Public Member Functions
	Splitter (QWidget parent=0, const char name=0)
	~Splitter ()
void	setOrientation (Orientation orient)
Orientation	orientation () const
bool	hasMultipleChildren () const
	Returns true if there is more than one child.
QWidget *	firstChild ()
	Returns the first child.
void	addChild (QWidget *w)
	Adds the widget w to the list of managed children.
void	splitChild (QWidget old, QWidget w)
	Splits the space covered by old into two halves and embeds the widget w into the second.
void	replaceChild (QWidget old, QWidget w)
	Puts the widget w into the space formerly covered by old.
void	moveSplitter (QWidget *w, int pos)
	Moves the splitter after widget w to the vertical offset pos.
Protected Member Functions
virtual QSize	minimumSizeHint () const
virtual void	childEvent (QChildEvent *e)
virtual void	resizeEvent (QResizeEvent *e)
Private Slots
void	collapse ()
Private Member Functions
void	doLayout ()
int	handleWidth () const
Private Attributes
QPtrList< QWidget >	childlist
QPtrList< SplitterHandle >	handlelist
QValueList< int >	sizes
Orientation	_or

Detailed Description

Because of these features, widgets are not automatically embedded by using the splitter as parent.

Definition at line 39 of file splitter.h.

Constructor & Destructor Documentation

Splitter::Splitter ( QWidget * parent = 0,

const char * name = 0

)

Definition at line 29 of file splitter.cpp.
References _or, and handlelist.

Splitter::~Splitter ( )

Definition at line 38 of file splitter.cpp.

Member Function Documentation

void Splitter::addChild ( QWidget * w )

Adds the widget w to the list of managed children.

Definition at line 89 of file splitter.cpp.
References childlist, doLayout(), handlelist, kdDebug(), orientation(), and splitChild().

void Splitter::childEvent ( QChildEvent * e ) [protected, virtual]

Definition at line 237 of file splitter.cpp.
References childlist, collapse(), doLayout(), handlelist, orientation(), and sizes.

void Splitter::collapse ( ) [private, slot]

Definition at line 262 of file splitter.cpp.
References collapsed().
Referenced by childEvent().

void Splitter::collapsed ( Splitter * splitter ) [signal]

Referenced by collapse().

void Splitter::doLayout ( ) [private]

Definition at line 182 of file splitter.cpp.
References childlist, handlelist, orientation(), and sizes.
Referenced by addChild(), childEvent(), moveSplitter(), replaceChild(), resizeEvent(), setOrientation(), and splitChild().

QWidget * Splitter::firstChild ( )

Returns the first child.
This is useful for destroying the splitter when the number of children has gone down to one. See TopLevel::eventFilter().
Definition at line 77 of file splitter.cpp.
References childlist.

int Splitter::handleWidth ( ) const [private]

Definition at line 83 of file splitter.cpp.
References orientation().
Referenced by moveSplitter(), and splitChild().

bool Splitter::hasMultipleChildren ( ) const

Returns true if there is more than one child.

Definition at line 71 of file splitter.cpp.
References childlist.
Referenced by setOrientation().

QSize Splitter::minimumSizeHint ( ) const [protected, virtual]

Definition at line 224 of file splitter.cpp.
References childlist, and orientation().

void Splitter::moveSplitter ( QWidget * w,

int pos

)

Moves the splitter after widget w to the vertical offset pos.

Definition at line 164 of file splitter.cpp.
References childlist, doLayout(), handleWidth(), and sizes.

Qt::Orientation Splitter::orientation ( ) const

Definition at line 65 of file splitter.cpp.
Referenced by addChild(), childEvent(), doLayout(), handleWidth(), minimumSizeHint(), replaceChild(), and splitChild().

void Splitter::replaceChild ( QWidget * old,

QWidget * w

)

Puts the widget w into the space formerly covered by old.
old is not destroyed. Note: w must have the splitter as parent.
Definition at line 144 of file splitter.cpp.
References childlist, doLayout(), handlelist, kdDebug(), and orientation().

void Splitter::resizeEvent ( QResizeEvent * e ) [protected, virtual]

Definition at line 268 of file splitter.cpp.
References doLayout().

void Splitter::setOrientation ( Orientation orient )

Definition at line 42 of file splitter.cpp.
References _or, childlist, doLayout(), handlelist, hasMultipleChildren(), and kdDebug().

void Splitter::splitChild ( QWidget * old,

QWidget * w

)

Splits the space covered by old into two halves and embeds the widget w into the second.
Note: w must have the splitter as parent.
Definition at line 109 of file splitter.cpp.
References childlist, doLayout(), handlelist, handleWidth(), kdDebug(), orientation(), and sizes.
Referenced by addChild().

Member Data Documentation

Orientation Splitter::_or [private]

Definition at line 101 of file splitter.h.
Referenced by setOrientation(), and Splitter().

QPtrList<QWidget> Splitter::childlist [private]

Definition at line 98 of file splitter.h.
Referenced by addChild(), childEvent(), doLayout(), firstChild(), hasMultipleChildren(), minimumSizeHint(), moveSplitter(), replaceChild(), setOrientation(), and splitChild().

QPtrList<SplitterHandle> Splitter::handlelist [private]

Definition at line 99 of file splitter.h.
Referenced by addChild(), childEvent(), doLayout(), replaceChild(), setOrientation(), splitChild(), and Splitter().

QValueList<int> Splitter::sizes [private]

Definition at line 100 of file splitter.h.
Referenced by childEvent(), doLayout(), moveSplitter(), and splitChild().

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

lib/util/splitter.h
lib/util/splitter.cpp

KDevelop API Documentation

Splitter Class Reference

Signals

Public Member Functions

Protected Member Functions

Private Slots

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation