QwtThermo - Man Page
The Thermometer Widget.
Synopsis
#include <qwt_thermo.h>
Inherits QwtAbstractScale.
Public Types
enum ScalePosition { NoScale, LeadingScale, TrailingScale }
enum OriginMode { OriginMinimum, OriginMaximum, OriginCustom }
Public Slots
virtual void setValue (double)
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)
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 &)
Change the brush of the liquid.
QBrush fillBrush () const
void setAlarmBrush (const QBrush &)
Specify the liquid brush above the alarm threshold.
QBrush alarmBrush () const
void setAlarmLevel (double)
double alarmLevel () const
void setAlarmEnabled (bool)
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)
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.
Detailed Description
The Thermometer Widget.
QwtThermo is a widget which displays a value in an interval. It supports:
- a horizontal or vertical layout;
- a range;
- a scale;
- an alarm level.
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:
- QPalette::Base Background of the pipe
- QPalette::ButtonText Fill brush below the alarm level
- QPalette::Highlight Fill brush for the values above the alarm level
- QPalette::WindowText For the axis of the scale
- QPalette::Text For the labels of the scale
Member Enumeration Documentation
enum QwtThermo::OriginMode
Origin mode. This property specifies where the beginning of the liquid is placed.
- See also
setOriginMode(), setOrigin()
Enumerator
- 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.
enum QwtThermo::ScalePosition
Position of the scale
- See also
setScalePosition(), setOrientation()
Enumerator
- NoScale
The slider has no scale.
- LeadingScale
The scale is right of a vertical or below of a horizontal slider.
- TrailingScale
The scale is left of a vertical or above of a horizontal slider.
Constructor & Destructor Documentation
QwtThermo::QwtThermo (QWidget * parent = NULL) [explicit]
Constructor
- Parameters
parent Parent widget
Member Function Documentation
QBrush QwtThermo::alarmBrush () const
- Returns
Liquid brush ( QPalette::Highlight ) above the alarm threshold.
- See also
setAlarmBrush(), QWidget::palette()
- Warning
The alarm threshold has no effect, when a color map has been assigned
bool QwtThermo::alarmEnabled () const
- Returns
True, when the alarm threshold is enabled.
- Warning
The alarm threshold has no effect, when a color map has been assigned
double QwtThermo::alarmLevel () const
- Returns
Alarm threshold.
- See also
setAlarmLevel()
- Warning
The alarm threshold has no effect, when a color map has been assigned
QRect QwtThermo::alarmRect (const QRect & fillRect) const [protected]
Calculate the alarm rectangle of the pipe.
- Parameters
fillRect Filled rectangle in the pipe
- Returns
Rectangle to be filled with the alarm brush
- See also
pipeRect(), fillRect(), alarmLevel(), alarmBrush()
int QwtThermo::borderWidth () const
- Returns
Border width of the thermometer pipe.
- See also
setBorderWidth()
void QwtThermo::changeEvent (QEvent * event) [protected], [virtual]
Qt change event handler
- Parameters
event Event
QwtColorMap * QwtThermo::colorMap ()
- Returns
Color map for the fill color
- Warning
The alarm threshold has no effect, when a color map has been assigned
const QwtColorMap * QwtThermo::colorMap () const
- Returns
Color map for the fill color
- Warning
The alarm threshold has no effect, when a color map has been assigned
void QwtThermo::drawLiquid (QPainter * painter, const QRect & pipeRect) const [protected], [virtual]
Redraw the liquid in thermometer pipe.
- Parameters
painter Painter
pipeRect Bounding rectangle of the pipe without borders
QBrush QwtThermo::fillBrush () const
- Returns
Liquid ( QPalette::ButtonText ) brush.
- See also
setFillBrush(), QWidget::palette()
QRect QwtThermo::fillRect (const QRect & pipeRect) const [protected]
Calculate the filled rectangle of the pipe.
- Parameters
pipeRect Rectangle of the pipe
- Returns
Rectangle to be filled ( fill and alarm brush )
- See also
pipeRect(), alarmRect()
QSize QwtThermo::minimumSizeHint () const [virtual]
- Returns
Minimum size hint
- Warning
The return value depends on the font and the scale.
- See also
sizeHint()
Qt::Orientation QwtThermo::orientation () const
- Returns
Orientation
- See also
setOrientation()
double QwtThermo::origin () const
- Returns
Origin of the thermo, when OriginCustom is enabled
- See also
setOrigin(), setOriginMode(), originMode()
QwtThermo::OriginMode QwtThermo::originMode () const
- Returns
Mode, how the origin is determined.
- See also
setOriginMode(), serOrigin(), origin()
void QwtThermo::paintEvent (QPaintEvent * event) [protected], [virtual]
Paint event handler
- Parameters
event Paint event
QRect QwtThermo::pipeRect () const [protected]
- Returns
Bounding rectangle of the pipe ( without borders ) in widget coordinates
int QwtThermo::pipeWidth () const
- Returns
Width of the pipe.
- See also
setPipeWidth()
QwtInterval::BorderFlags QwtThermo::rangeFlags () const
- Returns
Range flags
- See also
setRangeFlags()
void QwtThermo::resizeEvent (QResizeEvent * event) [protected], [virtual]
Resize event handler
- Parameters
event Resize event
QwtScaleDraw * QwtThermo::scaleDraw () [protected]
- Returns
the scale draw of the thermo
- See also
setScaleDraw()
const QwtScaleDraw * QwtThermo::scaleDraw () const
- Returns
the scale draw of the thermo
- See also
setScaleDraw()
QwtThermo::ScalePosition QwtThermo::scalePosition () const
- Returns
Scale position.
- See also
setScalePosition()
void QwtThermo::setAlarmBrush (const QBrush & brush)
Specify the liquid brush above the alarm threshold. Changes the QPalette::Highlight brush of the palette.
- Parameters
brush New brush.
- See also
alarmBrush(), QWidget::setPalette()
- Warning
The alarm threshold has no effect, when a color map has been assigned
void QwtThermo::setAlarmEnabled (bool on)
Enable or disable the alarm threshold.
- Parameters
on true (disabled) or false (enabled)
- Warning
The alarm threshold has no effect, when a color map has been assigned
void QwtThermo::setAlarmLevel (double level)
Specify the alarm threshold.
- Parameters
level Alarm threshold
- See also
alarmLevel()
- Warning
The alarm threshold has no effect, when a color map has been assigned
void QwtThermo::setBorderWidth (int width)
Set the border width of the pipe.
- Parameters
width Border width
- See also
borderWidth()
void QwtThermo::setColorMap (QwtColorMap * colorMap)
Assign a color map for the fill color.
- Parameters
colorMap Color map
- Warning
The alarm threshold has no effect, when a color map has been assigned
void QwtThermo::setFillBrush (const QBrush & brush)
Change the brush of the liquid. Changes the QPalette::ButtonText brush of the palette.
- Parameters
brush New brush.
- See also
fillBrush(), QWidget::setPalette()
void QwtThermo::setOrientation (Qt::Orientation orientation)
Set the orientation.
- Parameters
orientation Allowed values are Qt::Horizontal and Qt::Vertical.
- See also
orientation(), scalePosition()
void QwtThermo::setOrigin (double origin)
Specifies the custom origin. If originMode is set to OriginCustom this property controls where the liquid starts.
- Parameters
origin New origin level
- See also
setOriginMode(), originMode(), origin()
void QwtThermo::setOriginMode (OriginMode m)
Change how the origin is determined.
- See also
originMode(), serOrigin(), origin()
void QwtThermo::setPipeWidth (int width)
Change the width of the pipe.
- Parameters
width Width of the pipe
- See also
pipeWidth()
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.
- Parameters
flags Range flags
- See also
rangeFlags()
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().
- Parameters
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.
- Parameters
scalePosition Position of the scale.
- See also
ScalePosition, scalePosition()
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.
- Parameters
spacing Number of pixels
- See also
spacing();
void QwtThermo::setValue (double value) [virtual], [slot]
Set the current value.
- Parameters
value New Value
- See also
value()
QSize QwtThermo::sizeHint () const [virtual]
- Returns
the minimum size hint
- See also
minimumSizeHint()
int QwtThermo::spacing () const
- Returns
Number of pixels between pipe and scale
- See also
setSpacing()
Author
Generated automatically by Doxygen for Qwt User's Guide from the source code.