QwtThermo (3) - Linux Manuals

NAME

QwtThermo -

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 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.

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

const QwtScaleDraw * QwtThermo::scaleDraw () const

Returns:

the scale draw of the thermo

See Also:

setScaleDraw()

QwtScaleDraw * QwtThermo::scaleDraw () [protected]

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 (boolon)

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 (doublelevel)

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 (intwidth)

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::Orientationorientation)

Set the orientation.

Parameters:

orientation Allowed values are Qt::Horizontal and Qt::Vertical.

See Also:

orientation(), scalePosition()

void QwtThermo::setOrigin (doubleorigin)

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 (OriginModem)

Change how the origin is determined.

See Also:

originMode(), serOrigin(), origin()

void QwtThermo::setPipeWidth (intwidth)

Change the width of the pipe.

Parameters:

width Width of the pipe

See Also:

pipeWidth()

void QwtThermo::setRangeFlags (QwtInterval::BorderFlagsflags)

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 (ScalePositionscalePosition)

Change the position of the scale.

Parameters:

scalePosition Position of the scale.

See Also:

ScalePosition, scalePosition()

void QwtThermo::setSpacing (intspacing)

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 (doublevalue) [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.