Qwt User's Guide
|
The Thermometer Widget. More...
#include <qwt_thermo.h>
Public Types | |
enum | ScalePosition { NoScale, LeadingScale, TrailingScale } |
enum | OriginMode { OriginMinimum, OriginMaximum, OriginCustom } |
Public Slots | |
virtual void | setValue (double val) |
Public Member Functions | |
QwtThermo (QWidget *parent=NULL) | |
virtual | ~QwtThermo () |
Destructor. | |
void | setOrientation (Qt::Orientation) |
Set the orientation. | |
Qt::Orientation | orientation () const |
void | setScalePosition (ScalePosition) |
Change the position of the scale. | |
ScalePosition | scalePosition () const |
void | setSpacing (int) |
Change the spacing between pipe and scale. | |
int | spacing () const |
void | setBorderWidth (int w) |
int | borderWidth () const |
void | setOriginMode (OriginMode) |
Change how the origin is determined. | |
OriginMode | originMode () const |
void | setOrigin (double) |
Specifies the custom origin. | |
double | origin () const |
void | setFillBrush (const QBrush &b) |
Change the brush of the liquid. | |
QBrush | fillBrush () const |
void | setAlarmBrush (const QBrush &b) |
Specify the liquid brush above the alarm threshold. | |
QBrush | alarmBrush () const |
void | setAlarmLevel (double v) |
double | alarmLevel () const |
void | setAlarmEnabled (bool tf) |
Enable or disable the alarm threshold. | |
bool | alarmEnabled () const |
void | setColorMap (QwtColorMap *) |
Assign a color map for the fill color. | |
QwtColorMap * | colorMap () |
const QwtColorMap * | colorMap () const |
void | setPipeWidth (int w) |
int | pipeWidth () const |
void | setRangeFlags (QwtInterval::BorderFlags) |
Exclude/Include min/max values. | |
QwtInterval::BorderFlags | rangeFlags () const |
double | value () const |
Return the value. | |
virtual QSize | sizeHint () const |
virtual QSize | minimumSizeHint () const |
void | setScaleDraw (QwtScaleDraw *) |
Set a scale draw. | |
const QwtScaleDraw * | scaleDraw () const |
Protected Member Functions | |
virtual void | drawLiquid (QPainter *, const QRect &) const |
virtual void | scaleChange () |
Notify a scale change. | |
virtual void | paintEvent (QPaintEvent *) |
virtual void | resizeEvent (QResizeEvent *) |
virtual void | changeEvent (QEvent *) |
QwtScaleDraw * | scaleDraw () |
QRect | pipeRect () const |
QRect | fillRect (const QRect &) const |
Calculate the filled rectangle of the pipe. | |
QRect | alarmRect (const QRect &) const |
Calculate the alarm rectangle of the pipe. |
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:
Origin mode. This property specifies where the beginning of the liquid is placed.
OriginMinimum |
The origin is the minimum of the scale. |
OriginMaximum |
The origin is the maximum of the scale. |
OriginCustom |
The origin is specified using the origin() property. |
Position of the scale
QwtThermo::QwtThermo | ( | QWidget * | parent = NULL | ) | [explicit] |
Constructor
parent | Parent widget |
QBrush QwtThermo::alarmBrush | ( | ) | const |
bool QwtThermo::alarmEnabled | ( | ) | const |
double QwtThermo::alarmLevel | ( | ) | const |
QRect QwtThermo::alarmRect | ( | const QRect & | fillRect | ) | const [protected] |
Calculate the alarm rectangle of the pipe.
fillRect | Filled rectangle in the pipe |
int QwtThermo::borderWidth | ( | ) | const |
void QwtThermo::changeEvent | ( | QEvent * | event | ) | [protected, virtual] |
Qt change event handler
event | Event |
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 |
QBrush QwtThermo::fillBrush | ( | ) | const |
QRect QwtThermo::fillRect | ( | const QRect & | pipeRect | ) | const [protected] |
Calculate the filled rectangle of the pipe.
pipeRect | Rectangle of the pipe |
QSize QwtThermo::minimumSizeHint | ( | ) | const [virtual] |
Qt::Orientation QwtThermo::orientation | ( | ) | const |
double QwtThermo::origin | ( | ) | const |
QwtThermo::OriginMode QwtThermo::originMode | ( | ) | const |
void QwtThermo::paintEvent | ( | QPaintEvent * | event | ) | [protected, virtual] |
Paint event handler
event | Paint event |
QRect QwtThermo::pipeRect | ( | ) | const [protected] |
int QwtThermo::pipeWidth | ( | ) | const |
void QwtThermo::resizeEvent | ( | QResizeEvent * | event | ) | [protected, virtual] |
Resize event handler
event | Resize event |
const QwtScaleDraw * QwtThermo::scaleDraw | ( | ) | const |
QwtScaleDraw * QwtThermo::scaleDraw | ( | ) | [protected] |
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 | on | ) |
Enable or disable the alarm threshold.
on | 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::setOrientation | ( | Qt::Orientation | orientation | ) |
Set the orientation.
orientation | Allowed values are Qt::Horizontal and Qt::Vertical. |
void QwtThermo::setOrigin | ( | double | origin | ) |
Specifies the custom origin.
If originMode is set to OriginCustom this property controls where the liquid starts.
origin | New origin level |
void QwtThermo::setOriginMode | ( | OriginMode | m | ) |
Change how the origin is determined.
void QwtThermo::setPipeWidth | ( | int | width | ) |
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 | ( | ScalePosition | scalePosition | ) |
Change the position of the scale.
scalePosition | Position of the scale. |
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 |