Qwt User's Guide 6.0.0
|
The Thermometer Widget. More...
#include <qwt_thermo.h>
Public Types | |
enum | ScalePos { NoScale, LeftScale, RightScale, TopScale, BottomScale } |
Public Slots | |
virtual void | setValue (double val) |
Public Member Functions | |
QwtThermo (QWidget *parent=NULL) | |
virtual | ~QwtThermo () |
void | setOrientation (Qt::Orientation, ScalePos) |
void | setScalePosition (ScalePos s) |
ScalePos | scalePosition () const |
void | setSpacing (int) |
int | spacing () const |
void | setBorderWidth (int w) |
int | borderWidth () const |
void | setFillBrush (const QBrush &b) |
const QBrush & | fillBrush () const |
void | setAlarmBrush (const QBrush &b) |
const QBrush & | alarmBrush () const |
void | setAlarmLevel (double v) |
double | alarmLevel () const |
void | setAlarmEnabled (bool tf) |
bool | alarmEnabled () const |
void | setColorMap (QwtColorMap *) |
QwtColorMap * | colorMap () |
const QwtColorMap * | colorMap () const |
void | setPipeWidth (int w) |
int | pipeWidth () const |
void | setRangeFlags (QwtInterval::BorderFlags) |
QwtInterval::BorderFlags | rangeFlags () const |
void | setMaxValue (double v) |
double | maxValue () const |
void | setMinValue (double v) |
double | minValue () const |
double | value () const |
void | setRange (double vmin, double vmax, bool lg=false) |
virtual QSize | sizeHint () const |
virtual QSize | minimumSizeHint () const |
void | setScaleDraw (QwtScaleDraw *) |
const QwtScaleDraw * | scaleDraw () const |
Protected Member Functions | |
virtual void | drawLiquid (QPainter *, const QRect &) const |
virtual void | scaleChange () |
virtual void | paintEvent (QPaintEvent *) |
virtual void | resizeEvent (QResizeEvent *) |
virtual void | changeEvent (QEvent *) |
QwtScaleDraw * | scaleDraw () |
QRect | pipeRect () const |
The Thermometer Widget.
QwtThermo is a widget which displays a value in an interval. It supports:
The fill colors might be calculated from an optional color map If no color map has been assigned QwtThermo uses the following colors/brushes from the widget palette:
By default, the scale and range run over the same interval of values. QwtAbstractScale::setScale() changes the interval of the scale and allows easy conversion between physical units.
The example shows how to make the scale indicate in degrees Fahrenheit and to set the value in degrees Kelvin:
#include <qapplication.h> #include <qwt_thermo.h> double Kelvin2Fahrenheit(double kelvin) { // see http://en.wikipedia.org/wiki/Kelvin return 1.8*kelvin - 459.67; } int main(int argc, char **argv) { const double minKelvin = 0.0; const double maxKelvin = 500.0; QApplication a(argc, argv); QwtThermo t; t.setRange(minKelvin, maxKelvin); t.setScale(Kelvin2Fahrenheit(minKelvin), Kelvin2Fahrenheit(maxKelvin)); // set the value in Kelvin but the scale displays in Fahrenheit // 273.15 Kelvin = 0 Celsius = 32 Fahrenheit t.setValue(273.15); a.setMainWidget(&t); t.show(); return a.exec(); }
enum QwtThermo::ScalePos |
Scale position. QwtThermo tries to enforce valid combinations of its orientation and scale position:
QwtThermo::QwtThermo | ( | QWidget * | parent = NULL | ) | [explicit] |
Constructor
parent | Parent widget |
QwtThermo::~QwtThermo | ( | ) | [virtual] |
Destructor.
const QBrush & QwtThermo::alarmBrush | ( | ) | const |
Return the liquid brush ( QPalette::Highlight ) above the alarm threshold.
bool QwtThermo::alarmEnabled | ( | ) | const |
double QwtThermo::alarmLevel | ( | ) | const |
Return the alarm threshold.
int QwtThermo::borderWidth | ( | ) | const |
Return the border width of the thermometer pipe.
void QwtThermo::changeEvent | ( | QEvent * | event | ) | [protected, virtual] |
Qt change event handler
event | Event |
QwtColorMap * QwtThermo::colorMap | ( | ) |
const QwtColorMap * QwtThermo::colorMap | ( | ) | const |
void QwtThermo::drawLiquid | ( | QPainter * | painter, |
const QRect & | pipeRect | ||
) | const [protected, virtual] |
Redraw the liquid in thermometer pipe.
painter | Painter |
pipeRect | Bounding rectangle of the pipe without borders |
const QBrush & QwtThermo::fillBrush | ( | ) | const |
Return the liquid ( QPalette::ButtonText ) brush.
double QwtThermo::maxValue | ( | ) | const |
Return the maximum value.
QSize QwtThermo::minimumSizeHint | ( | ) | const [virtual] |
Return a minimum size hint.
double QwtThermo::minValue | ( | ) | const |
Return the minimum value.
void QwtThermo::paintEvent | ( | QPaintEvent * | event | ) | [protected, virtual] |
Qt paint event.
event | Paint event |
QRect QwtThermo::pipeRect | ( | ) | const [protected] |
int QwtThermo::pipeWidth | ( | ) | const |
Return the width of the pipe.
QwtInterval::BorderFlags QwtThermo::rangeFlags | ( | ) | const |
void QwtThermo::resizeEvent | ( | QResizeEvent * | event | ) | [protected, virtual] |
Qt resize event handler
event | Resize event |
void QwtThermo::scaleChange | ( | ) | [protected, virtual] |
Notify a scale change.
Reimplemented from QwtAbstractScale.
const QwtScaleDraw * QwtThermo::scaleDraw | ( | ) | const |
QwtScaleDraw * QwtThermo::scaleDraw | ( | ) | [protected] |
QwtThermo::ScalePos QwtThermo::scalePosition | ( | ) | const |
Return the scale position.
void QwtThermo::setAlarmBrush | ( | const QBrush & | brush | ) |
Specify the liquid brush above the alarm threshold.
Changes the QPalette::Highlight brush of the palette.
brush | New brush. |
void QwtThermo::setAlarmEnabled | ( | bool | tf | ) |
Enable or disable the alarm threshold.
tf | true (disabled) or false (enabled) |
void QwtThermo::setAlarmLevel | ( | double | level | ) |
Specify the alarm threshold.
level | Alarm threshold |
void QwtThermo::setBorderWidth | ( | int | width | ) |
void QwtThermo::setColorMap | ( | QwtColorMap * | colorMap | ) |
Assign a color map for the fill color.
colorMap | Color map |
void QwtThermo::setFillBrush | ( | const QBrush & | brush | ) |
Change the brush of the liquid.
Changes the QPalette::ButtonText brush of the palette.
brush | New brush. |
void QwtThermo::setMaxValue | ( | double | maxValue | ) |
Set the maximum value.
maxValue | Maximum value |
void QwtThermo::setMinValue | ( | double | minValue | ) |
Set the minimum value.
minValue | Minimum value |
void QwtThermo::setOrientation | ( | Qt::Orientation | o, |
ScalePos | s | ||
) |
Set the thermometer orientation and the scale position.
The scale position NoScale disables the scale.
o | orientation. Possible values are Qt::Horizontal and Qt::Vertical. The default value is Qt::Vertical. |
s | Position of the scale. The default value is NoScale. |
A valid combination of scale position and orientation is enforced:
void QwtThermo::setPipeWidth | ( | int | width | ) |
void QwtThermo::setRange | ( | double | minValue, |
double | maxValue, | ||
bool | logarithmic = false |
||
) |
Set the range.
minValue | value corresponding lower or left end of the thermometer |
maxValue | value corresponding to the upper or right end of the thermometer |
logarithmic | logarithmic mapping, true or false |
void QwtThermo::setRangeFlags | ( | QwtInterval::BorderFlags | flags | ) |
Exclude/Include min/max values.
According to the flags minValue() and maxValue() are included/excluded from the pipe. In case of an excluded value the corresponding tick is painted 1 pixel off of the pipeRect().
F.e. when a minimum of 0.0 has to be displayed as an empty pipe the minValue() needs to be excluded.
flags | Range flags |
void QwtThermo::setScaleDraw | ( | QwtScaleDraw * | scaleDraw | ) |
Set a scale draw.
For changing the labels of the scales, it is necessary to derive from QwtScaleDraw and overload QwtScaleDraw::label().
scaleDraw | ScaleDraw object, that has to be created with new and will be deleted in ~QwtThermo or the next call of setScaleDraw(). |
void QwtThermo::setScalePosition | ( | ScalePos | scalePos | ) |
Change the scale position (and thermometer orientation).
scalePos | Position of the scale. |
A valid combination of scale position and orientation is enforced:
void QwtThermo::setSpacing | ( | int | spacing | ) |
Change the spacing between pipe and scale.
A spacing of 0 means, that the backbone of the scale is below the pipe.
The default setting is 3 pixels.
spacing | Number of pixels |
void QwtThermo::setValue | ( | double | value | ) | [virtual, slot] |
QSize QwtThermo::sizeHint | ( | ) | const [virtual] |
int QwtThermo::spacing | ( | ) | const |
double QwtThermo::value | ( | ) | const |
Return the value.