KXYSelector Class Reference
from PyKDE5.kwidgetsaddons import *
Inherits: QWidget → QObject
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.
Signals | |
valueChanged (int x, int y) | |
Methods | |
__init__ (self, QWidget parent=0) | |
QRect | contentsRect (self) |
drawContents (self, QPainter a0) | |
drawMarker (self, QPainter p, int xp, int yp) | |
QSize | minimumSizeHint (self) |
mouseMoveEvent (self, QMouseEvent e) | |
mousePressEvent (self, QMouseEvent e) | |
paintEvent (self, QPaintEvent e) | |
setMarkerColor (self, QColor col) | |
setRange (self, int minX, int minY, int maxX, int maxY) | |
setValues (self, int xPos, int yPos) | |
setXValue (self, int xPos) | |
setYValue (self, int yPos) | |
valuesFromPosition (self, int x, int y, int xVal, int yVal) | |
wheelEvent (self, QWheelEvent a0) | |
int | xValue (self) |
int | yValue (self) |
Signal Documentation
valueChanged | ( | int | x, | |
int | y | |||
) |
This signal is emitted whenever the user chooses a value, e.g. by clicking with the mouse on the widget.
- Signal syntax:
QObject.connect(source, SIGNAL("valueChanged(int, int)"), target_slot)
Method Documentation
__init__ | ( | self, | ||
QWidget | parent=0 | |||
) |
Constructs a two-dimensional selector widget which has a value range of [0..100] in both directions.
QRect contentsRect | ( | self ) |
- Returns:
- the rectangle on which subclasses should draw.
drawContents | ( | self, | ||
QPainter | a0 | |||
) |
Override this function to draw the contents of the widget. The default implementation does nothing.
Draw within contentsRect() only.
drawMarker | ( | self, | ||
QPainter | p, | |||
int | xp, | |||
int | yp | |||
) |
Override this function to draw the marker which indicates the currently selected value pair.
QSize minimumSizeHint | ( | self ) |
Reimplemented to give the widget a minimum size
mouseMoveEvent | ( | self, | ||
QMouseEvent | e | |||
) |
mousePressEvent | ( | self, | ||
QMouseEvent | e | |||
) |
paintEvent | ( | self, | ||
QPaintEvent | e | |||
) |
setMarkerColor | ( | self, | ||
QColor | col | |||
) |
Sets the color used to draw the marker
- Parameters:
-
col the color
setRange | ( | self, | ||
int | minX, | |||
int | minY, | |||
int | maxX, | |||
int | maxY | |||
) |
Sets the range of possible values.
setValues | ( | self, | ||
int | xPos, | |||
int | yPos | |||
) |
Sets the current values in horizontal and vertical direction.
- Parameters:
-
xPos the horizontal value yPos the vertical value
setXValue | ( | self, | ||
int | xPos | |||
) |
Sets the current horizontal value
- Parameters:
-
xPos the horizontal value
setYValue | ( | self, | ||
int | yPos | |||
) |
Sets the current vertical value
- Parameters:
-
yPos the vertical value
valuesFromPosition | ( | self, | ||
int | x, | |||
int | y, | |||
int | xVal, | |||
int | yVal | |||
) |
Converts a pixel position to its corresponding values.
wheelEvent | ( | self, | ||
QWheelEvent | a0 | |||
) |
int xValue | ( | self ) |
- Returns:
- the current value in horizontal direction.
int yValue | ( | self ) |
- Returns:
- the current value in vertical direction.