KDockSplitter Class Reference

#include <kdockwidget_private.h>

Inherits TQWidget.

Public Member Functions
	KDockSplitter (TQWidget *parent=0, const char *name=0, Orientation orient=TQt::Vertical, int pos=50)
void	activate (TQWidget *c0, TQWidget *c1=0L)
void	deactivate ()
int	separatorPosInPercent ()
void	setSeparatorPosInPercent (int percent)
int	separatorPos () const
void	setSeparatorPos (int pos, bool do_resize=true)
void	setSeparatorPosX (int pos, bool do_resize=false)
virtual bool	eventFilter (TQObject *, TQEvent *)
virtual bool	event (TQEvent *)
TQWidget *	getFirst () const
TQWidget *	getLast () const
TQWidget *	getAnother (TQWidget *w) const
void	updateName ()
void	setOpaqueResize (bool b=true)
bool	opaqueResize () const
void	setKeepSize (bool b=true)
bool	keepSize () const
void	setForcedFixedWidth (KDockWidget *dw, int w)
void	setForcedFixedHeight (KDockWidget *dw, int h)
void	restoreFromForcedFixedSize (KDockWidget *dw)
Orientation	orientation ()

Protected Member Functions
int	checkValue (int position) const
int	checkValueOverlapped (int position, TQWidget *child) const
virtual void	resizeEvent (TQResizeEvent *ev)

Friends
class	KDockContainer

Detailed Description

Like TQSplitter but specially designed for dockwidgets stuff.

Author

Max Judin.

Definition at line 44 of file kdockwidget_private.h.

Constructor & Destructor Documentation

KDockSplitter()

KDockSplitter::KDockSplitter	(	TQWidget *	parent = 0,
		const char *	name = 0,
		Orientation	orient = TQt::Vertical,
		int	pos = 50
	)

Constructor.

Parameters

parent	parent widget
name	name
orient	orientation. Either Vertical or Horizontal
pos	procentual position of the splitter. Must be int [0...100].

Definition at line 32 of file kdockwidget_private.cpp.

Member Function Documentation

activate()

void KDockSplitter::activate	(	TQWidget *	c0,
		TQWidget *	c1 = 0L
	)

Initialize the splitter.

If c0 or c1 is 0L the child will not be replaced. So if you want to change c1 and not change c0, you'd call activate(0L,new_widget);

Parameters

c0	the widget on top/left
c1	the widget on borrom/right

Definition at line 51 of file kdockwidget_private.cpp.

checkValue()

int KDockSplitter::checkValue ( int  position ) const

protected

Make sure the splitter position is not out of bounds.

Parameters

position

the current position

Returns

a (new) valid splitter position.

Definition at line 466 of file kdockwidget_private.cpp.

checkValueOverlapped()

int KDockSplitter::checkValueOverlapped ( int  position, TQWidget *  child  ) const

protected

Make sure the splitter position is not out of bounds.

It has to honor all child widgets' mimimumSize.

Parameters

position	current divider position
child	the overlapping child

Returns

the (new) splitter position.

Definition at line 442 of file kdockwidget_private.cpp.

deactivate()

void KDockSplitter::deactivate

(

)

Disables the splitter.

Definition at line 204 of file kdockwidget_private.cpp.

eventFilter()

bool KDockSplitter::eventFilter ( TQObject *  o, TQEvent *  e  )

virtual

The eventfilter installed on the divider processes all splitter resizing events.

Definition at line 492 of file kdockwidget_private.cpp.

getAnother()

TQWidget * KDockSplitter::getAnother

(

TQWidget *

w

)

const

If w is child0, return child1, otherwise child0.

Returns

the other child widget

Definition at line 578 of file kdockwidget_private.cpp.

getFirst()

TQWidget* KDockSplitter::getFirst ( ) const

inline

Returns

the top/left child widget.

Definition at line 124 of file kdockwidget_private.h.

getLast()

TQWidget* KDockSplitter::getLast ( ) const

inline

Returns

the bottom/right child widget.

Definition at line 128 of file kdockwidget_private.h.

orientation()

Orientation KDockSplitter::orientation ( )

inline

The orientation is either Horizontal or Vertical.

Definition at line 159 of file kdockwidget_private.h.

resizeEvent()

void KDockSplitter::resizeEvent ( TQResizeEvent *  ev )

protectedvirtual

The resize event resizes child0, child1 and the divider.

The new sizes are dependant of

• whether child0 or child1 is a KDockContainer
• the current mode which may be
  • Closed
  • Overlapped (opened)
  • Nonoverlap (opened)

So there are 3*2=6 different modes we have to face.

Parameters

ev	the resize Event. If ev=0L the user changed the mode (for example from overlap to nonoverlap mode).

Definition at line 239 of file kdockwidget_private.cpp.

separatorPos()

int KDockSplitter::separatorPos

(

)

const

Return the separator position in the range [0..100000] To get the separator position in procent (%), call separatorPositionInPercent()!

Returns

high resolution separator position in range [0..100000], where 100000 is 100%.

Definition at line 234 of file kdockwidget_private.cpp.

separatorPosInPercent()

int KDockSplitter::separatorPosInPercent

(

)

Return the separator position in percent (%), so the range is [0..100].

Returns

separator position in percent

Definition at line 211 of file kdockwidget_private.cpp.

setKeepSize()

void KDockSplitter::setKeepSize

(

bool

b = true

)

If b is true, the splitter will keep its size on resize events.

If no KDockContainer is around, always the left child0 will be fixed size.

Definition at line 611 of file kdockwidget_private.cpp.

setOpaqueResize()

void KDockSplitter::setOpaqueResize

(

bool

b = true

)

Set opaque flag.

Parameters

b	if true, both child widgets are resized immediately, if false, the widgets only resize on MouseUpEvent.

Definition at line 601 of file kdockwidget_private.cpp.

setSeparatorPos()

void KDockSplitter::setSeparatorPos	(	int	pos,
		bool	do_resize = true
	)

set separator position.

Parameters

pos	the separator position in range [0..100000]. 100000 is 100%.
do_resize	if this is true, then a resize event is generated. This may cause the size to change.

Definition at line 221 of file kdockwidget_private.cpp.

setSeparatorPosInPercent()

void KDockSplitter::setSeparatorPosInPercent

(

int

percent

)

Set the separator position in percent (%), so the range must be [0..100].

Parameters

percent

separator position in percent

Definition at line 216 of file kdockwidget_private.cpp.

setSeparatorPosX()

void KDockSplitter::setSeparatorPosX	(	int	pos,
		bool	do_resize = false
	)

For usage from outside.

If the splitter is in fixed position when called, the value of pos will be saved and used when the splitter is restored. If do_resize is true, the size will be changed unless the splitter is in fixed mode.

Definition at line 228 of file kdockwidget_private.cpp.

---

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

• kdockwidget_private.h
• kdockwidget_private.cpp