kdeui Library API Documentation

KSelector Class Reference

KSelector is the base class for other widgets which provides the ability to choose from a one-dimensional range of values. More...

#include <kselect.h>

Inheritance diagram for KSelector:

QWidget QRangeControl KGradientSelector KValueSelector List of all members.

Signals

void valueChanged (int value)

Public Member Functions

 KSelector (QWidget *parent=0, const char *name=0)
 KSelector (Orientation o, QWidget *parent=0L, const char *name=0L)
Orientation orientation () const
QRect contentsRect () const
void setIndent (bool i)
bool indent () const
void setValue (int value)
int value () const
void setMinValue (int value)
int minValue () const
void setMaxValue (int value)
int maxValue () const

Protected Member Functions

virtual void drawContents (QPainter *)
virtual void drawArrow (QPainter *painter, bool show, const QPoint &pos)
virtual void valueChange ()
virtual void paintEvent (QPaintEvent *)
virtual void mousePressEvent (QMouseEvent *e)
virtual void mouseMoveEvent (QMouseEvent *e)
virtual void wheelEvent (QWheelEvent *)
virtual void virtual_hook (int id, void *data)

Detailed Description

KSelector is the base class for other widgets which provides the ability to choose from a one-dimensional range of values.

An example is the KGradientSelector which allows to choose from a range of colors.

A custom drawing routine for the widget surface has to be provided by the subclass.

Definition at line 140 of file kselect.h.


Constructor & Destructor Documentation

KSelector::KSelector QWidget parent = 0,
const char *  name = 0
 

Constructs a horizontal one-dimensional selection widget.

Definition at line 207 of file kselect.cpp.

KSelector::KSelector Orientation  o,
QWidget parent = 0L,
const char *  name = 0L
 

Constructs a one-dimensional selection widget with a given orientation.

Definition at line 214 of file kselect.cpp.


Member Function Documentation

Orientation KSelector::orientation  )  const [inline]
 

Returns:
the orientation of the widget.

Definition at line 165 of file kselect.h.

Referenced by contentsRect(), drawArrow(), KGradientSelector::drawContents(), and KValueSelector::drawPalette().

QRect KSelector::contentsRect  )  const
 

Returns:
the rectangle on which subclasses should draw.

Definition at line 226 of file kselect.cpp.

References orientation().

Referenced by KGradientSelector::drawContents(), KValueSelector::drawContents(), and KValueSelector::drawPalette().

void KSelector::setIndent bool  i  )  [inline]
 

Sets the indent option of the widget to i.

This determines whether a shaded frame is drawn.

Definition at line 177 of file kselect.h.

bool KSelector::indent  )  const [inline]
 

Returns:
whether the indent option is set.

Definition at line 182 of file kselect.h.

void KSelector::setValue int  value  )  [inline]
 

Sets the value.

Definition at line 188 of file kselect.h.

int KSelector::value  )  const [inline]
 

Returns:
the value.

Definition at line 194 of file kselect.h.

void KSelector::setMinValue int  value  )  [inline]
 

Sets the min value.

Definition at line 200 of file kselect.h.

int KSelector::minValue  )  const [inline]
 

Returns:
the min value.

Definition at line 206 of file kselect.h.

void KSelector::setMaxValue int  value  )  [inline]
 

Sets the max value.

Definition at line 212 of file kselect.h.

int KSelector::maxValue  )  const [inline]
 

Returns:
the max value.

Definition at line 218 of file kselect.h.

void KSelector::valueChanged int  value  )  [signal]
 

This signal is emitted whenever the user chooses a value, e.g.

by clicking with the mouse on the widget.

void KSelector::drawContents QPainter  )  [protected, virtual]
 

Override this function to draw the contents of the control.

The default implementation does nothing.

Draw only within contentsRect().

Reimplemented in KValueSelector, and KGradientSelector.

Definition at line 328 of file kselect.cpp.

void KSelector::drawArrow QPainter painter,
bool  show,
const QPoint pos
[protected, virtual]
 

Override this function to draw the cursor which indicates the current value.

This function is always called twice, once with argument show=false to clear the old cursor, once with argument show=true to draw the new one.

Definition at line 331 of file kselect.cpp.

References orientation().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Tue Feb 14 09:16:42 2006 by doxygen 1.3.6 written by Dimitri van Heesch, © 1997-2003