• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDEUI

KXYSelector Class Reference

#include <kxyselector.h>

Inheritance diagram for KXYSelector:

Inheritance graph
[legend]

List of all members.


Detailed Description

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

The currently chosen value is indicated by a cross. An example is the KHSSelector which allows to choose from a range of colors, and which is used in KColorDialog.

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

Definition at line 39 of file kxyselector.h.


Signals

void valueChanged (int x, int y)

Public Member Functions

QRect contentsRect () const
 KXYSelector (QWidget *parent=0)
virtual QSize minimumSizeHint () const
void setMarkerColor (const QColor &col)
void setRange (int minX, int minY, int maxX, int maxY)
void setValues (int xPos, int yPos)
void setXValue (int xPos)
void setYValue (int yPos)
int xValue () const
int yValue () const
 ~KXYSelector ()

Protected Member Functions

virtual void drawContents (QPainter *)
virtual void drawMarker (QPainter *p, int xp, int yp)
virtual void mouseMoveEvent (QMouseEvent *e)
virtual void mousePressEvent (QMouseEvent *e)
virtual void paintEvent (QPaintEvent *e)
void valuesFromPosition (int x, int y, int &xVal, int &yVal) const
virtual void wheelEvent (QWheelEvent *)

Properties

int xValue
int yValue

Constructor & Destructor Documentation

KXYSelector::KXYSelector ( QWidget *  parent = 0  )  [explicit]

Constructs a two-dimensional selector widget which has a value range of [0.

.100] in both directions.

Definition at line 61 of file kxyselector.cpp.

KXYSelector::~KXYSelector (  ) 

Destructs the widget.

Definition at line 68 of file kxyselector.cpp.


Member Function Documentation

QRect KXYSelector::contentsRect (  )  const

Returns:
the rectangle on which subclasses should draw.

Definition at line 150 of file kxyselector.cpp.

void KXYSelector::drawContents ( QPainter *   )  [protected, virtual]

Override this function to draw the contents of the widget.

The default implementation does nothing.

Draw within contentsRect() only.

Reimplemented in KHueSaturationSelector.

Definition at line 241 of file kxyselector.cpp.

void KXYSelector::drawMarker ( QPainter *  p,
int  xp,
int  yp 
) [protected, virtual]

Override this function to draw the marker which indicates the currently selected value pair.

Definition at line 245 of file kxyselector.cpp.

QSize KXYSelector::minimumSizeHint (  )  const [virtual]

Reimplemented to give the widget a minimum size.

Definition at line 156 of file kxyselector.cpp.

void KXYSelector::mouseMoveEvent ( QMouseEvent *  e  )  [protected, virtual]

Reimplemented from QWidget.

Definition at line 183 of file kxyselector.cpp.

void KXYSelector::mousePressEvent ( QMouseEvent *  e  )  [protected, virtual]

Reimplemented from QWidget.

Definition at line 178 of file kxyselector.cpp.

void KXYSelector::paintEvent ( QPaintEvent *  e  )  [protected, virtual]

Reimplemented from QWidget.

Definition at line 162 of file kxyselector.cpp.

void KXYSelector::setMarkerColor ( const QColor &  col  ) 

Sets the color used to draw the marker.

Parameters:
col the color

Definition at line 145 of file kxyselector.cpp.

void KXYSelector::setRange ( int  minX,
int  minY,
int  maxX,
int  maxY 
)

Sets the range of possible values.

Definition at line 83 of file kxyselector.cpp.

void KXYSelector::setValues ( int  xPos,
int  yPos 
)

Sets the current values in horizontal and vertical direction.

Parameters:
xPos the horizontal value
yPos the vertical value

Definition at line 114 of file kxyselector.cpp.

void KXYSelector::setXValue ( int  xPos  ) 

Sets the current horizontal value.

Parameters:
xPos the horizontal value

Definition at line 104 of file kxyselector.cpp.

void KXYSelector::setYValue ( int  yPos  ) 

Sets the current vertical value.

Parameters:
yPos the vertical value

Definition at line 109 of file kxyselector.cpp.

void KXYSelector::valueChanged ( int  x,
int  y 
) [signal]

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

by clicking with the mouse on the widget.

void KXYSelector::valuesFromPosition ( int  x,
int  y,
int &  xVal,
int &  yVal 
) const [protected]

Converts a pixel position to its corresponding values.

Definition at line 203 of file kxyselector.cpp.

void KXYSelector::wheelEvent ( QWheelEvent *  e  )  [protected, virtual]

Reimplemented from QWidget.

Definition at line 193 of file kxyselector.cpp.

int KXYSelector::xValue (  )  const

Returns:
the current value in horizontal direction.

int KXYSelector::yValue (  )  const

Returns:
the current value in vertical direction.


Property Documentation

int KXYSelector::xValue [read, write]

Definition at line 42 of file kxyselector.h.

int KXYSelector::yValue [read, write]

Definition at line 43 of file kxyselector.h.


The documentation for this class was generated from the following files:
  • kxyselector.h
  • kxyselector.cpp

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • KIO
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal