KDockSplitter Class Reference

Like QSplitter but specially designed for dockwidgets stuff. More...

#include <kdockwidget_private.h>

Inheritance diagram for KDockSplitter:
QWidget

List of all members.

Public Member Functions

 KDockSplitter (QWidget *parent=0, const char *name=0, Orientation orient=Vertical, int pos=50)
void activate (QWidget *c0, QWidget *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 (QObject *, QEvent *)
virtual bool event (QEvent *)
QWidgetgetFirst () const
QWidgetgetLast () const
QWidgetgetAnother (QWidget *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, QWidget *child) const
virtual void resizeEvent (QResizeEvent *ev)

Friends

class KDockContainer

Detailed Description

Like QSplitter but specially designed for dockwidgets stuff.

Author:
Max Judin.

Definition at line 44 of file kdockwidget_private.h.


Constructor & Destructor Documentation

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

Constructor.

Parameters:
parentparent widget
namename
orientorientation. Either Vertical or Horizontal
posprocentual position of the splitter. Must be int [0...100].

Definition at line 32 of file kdockwidget_private.cpp.


Member Function Documentation

void KDockSplitter::activate ( QWidget c0,
QWidget 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:
c0the widget on top/left
c1the widget on borrom/right

Definition at line 51 of file kdockwidget_private.cpp.

int KDockSplitter::checkValue ( int  position) const [protected]

Make sure the splitter position is not out of bounds.

Parameters:
positionthe current position
Returns:
a (new) valid splitter position.

Definition at line 466 of file kdockwidget_private.cpp.

int KDockSplitter::checkValueOverlapped ( int  position,
QWidget child 
) const [protected]

Make sure the splitter position is not out of bounds.

It has to honor all child widgets' mimimumSize.

Parameters:
positioncurrent divider position
childthe overlapping child
Returns:
the (new) splitter position.

Definition at line 442 of file kdockwidget_private.cpp.

void KDockSplitter::deactivate ( )

Disables the splitter.

Definition at line 204 of file kdockwidget_private.cpp.

bool KDockSplitter::eventFilter ( QObject o,
QEvent e 
) [virtual]

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

Definition at line 492 of file kdockwidget_private.cpp.

QWidget * KDockSplitter::getAnother ( QWidget w) const

If w is child0, return child1, otherwise child0.

Returns:
the other child widget

Definition at line 578 of file kdockwidget_private.cpp.

QWidget* KDockSplitter::getFirst ( ) const [inline]
Returns:
the top/left child widget.

Definition at line 124 of file kdockwidget_private.h.

QWidget* KDockSplitter::getLast ( ) const [inline]
Returns:
the bottom/right child widget.

Definition at line 128 of file kdockwidget_private.h.

Orientation KDockSplitter::orientation ( ) [inline]

The orientation is either Horizontal or Vertical.

Definition at line 159 of file kdockwidget_private.h.

void KDockSplitter::resizeEvent ( QResizeEvent ev) [protected, virtual]

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:
evthe resize Event. If ev=0L the user changed the mode (for example from overlap to nonoverlap mode).

Reimplemented from QWidget.

Definition at line 239 of file kdockwidget_private.cpp.

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.

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.

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.

void KDockSplitter::setOpaqueResize ( bool  b = true)

Set opaque flag.

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

Definition at line 601 of file kdockwidget_private.cpp.

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

set separator position.

Parameters:
posthe separator position in range [0..100000]. 100000 is 100%.
do_resizeif 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.

void KDockSplitter::setSeparatorPosInPercent ( int  percent)

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

Parameters:
percentseparator position in percent

Definition at line 216 of file kdockwidget_private.cpp.

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:
KDE Home | KDE Accessibility Home | Description of Access Keys