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:

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:

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.

Info

Mon Jun 1 2020 Version 6.1.5 Qwt User's Guide