qwtthermo.3

linux下qt的第三方的一个类

.TH "QwtThermo" 3 "16 Nov 2004" "Version 4.2.0" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
QwtThermo \- 
.SH SYNOPSIS
.br
.PP
Inherits \fBQwtScaleIf\fP.
.PP
.SH "Detailed Description"
.PP 
The Thermometer Widget. 

QwtThermo is a widget which displays a value in an interval. It supports:
.IP "\(bu" 2
a horizontal or vertical layout;
.IP "\(bu" 2
a range;
.IP "\(bu" 2
a scale;
.IP "\(bu" 2
an alarm level.
.PP
.PP
By default, the scale and range run over the same interval of values. \fBQwtScaleIf::setScale()\fP 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: 
.PP
.nf
#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();
}

.fi
.PP
.PP
\fBTodo\fP
.RS 4
Improve the support for a logarithmic range and/or scale. 
.RE
.PP

.PP
Definition at line 67 of file qwt_thermo.h.
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBScalePos\fP { \fBNone\fP, \fBLeft\fP, \fBRight\fP, \fBTop\fP, \fBBottom\fP }"
.br
.in -1c
.SS "Public Slots"

.in +1c
.ti -1c
.RI "void \fBsetValue\fP (double val)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBQwtThermo\fP (QWidget *parent=0, const char *name=0)"
.br
.ti -1c
.RI "virtual \fB~QwtThermo\fP ()"
.br
.ti -1c
.RI "void \fBsetOrientation\fP (Qt::Orientation o, ScalePos s)"
.br
.ti -1c
.RI "void \fBsetScalePosition\fP (ScalePos s)"
.br
.ti -1c
.RI "ScalePos \fBscalePosition\fP () const"
.br
.ti -1c
.RI "void \fBsetBorderWidth\fP (int w)"
.br
.ti -1c
.RI "int \fBborderWidth\fP () const"
.br
.ti -1c
.RI "void \fBsetFillBrush\fP (const QBrush &b)"
.br
.ti -1c
.RI "const QBrush & \fBfillBrush\fP () const"
.br
.ti -1c
.RI "void \fBsetFillColor\fP (const QColor &c)"
.br
.ti -1c
.RI "const QColor & \fBfillColor\fP () const"
.br
.ti -1c
.RI "void \fBsetAlarmBrush\fP (const QBrush &b)"
.br
.ti -1c
.RI "const QBrush & \fBalarmBrush\fP () const"
.br
.ti -1c
.RI "void \fBsetAlarmColor\fP (const QColor &c)"
.br
.ti -1c
.RI "const QColor & \fBalarmColor\fP () const"
.br
.ti -1c
.RI "void \fBsetAlarmLevel\fP (double v)"
.br
.ti -1c
.RI "double \fBalarmLevel\fP () const"
.br
.ti -1c
.RI "void \fBsetAlarmEnabled\fP (bool tf)"
.br
.ti -1c
.RI "bool \fBalarmEnabled\fP () const"
.br
.ti -1c
.RI "void \fBsetPipeWidth\fP (int w)"
.br
.ti -1c
.RI "int \fBpipeWidth\fP () const"
.br
.ti -1c
.RI "void \fBsetMaxValue\fP (double v)"
.br
.ti -1c
.RI "double \fBmaxValue\fP () const"
.br
.ti -1c
.RI "void \fBsetMinValue\fP (double v)"
.br
.ti -1c
.RI "double \fBminValue\fP () const"
.br
.ti -1c
.RI "double \fBvalue\fP () const"
.br
.ti -1c
.RI "void \fBsetRange\fP (double vmin, double vmax, bool lg=FALSE)"
.br
.ti -1c
.RI "void \fBsetMargin\fP (int m)"
.br
.ti -1c
.RI "virtual QSize \fBsizeHint\fP () const"
.br
.ti -1c
.RI "virtual QSize \fBminimumSizeHint\fP () const"
.br
.ti -1c
.RI "virtual QSizePolicy \fBsizePolicy\fP () const"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBdraw\fP (QPainter *p, const QRect &update_rect)"
.br
.ti -1c
.RI "void \fBdrawThermo\fP (QPainter *p)"
.br
.ti -1c
.RI "void \fBlayoutThermo\fP (bool update=TRUE)"
.br
.ti -1c
.RI "virtual void \fBscaleChange\fP ()"
.br
.ti -1c
.RI "virtual void \fBfontChange\fP (const QFont &oldFont)"
.br
.ti -1c
.RI "virtual void \fBpaintEvent\fP (QPaintEvent *e)"
.br
.ti -1c
.RI "virtual void \fBresizeEvent\fP (QResizeEvent *e)"
.br
.in -1c
.SH "Constructor & Destructor Documentation"
.PP 
.SS "QwtThermo::QwtThermo (QWidget * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Constructor. 
.PP
Definition at line 20 of file qwt_thermo.cpp.
.SS "QwtThermo::~\fBQwtThermo\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 27 of file qwt_thermo.cpp.
.SH "Member Function Documentation"
.PP 
.SS "const QBrush & QwtThermo::alarmBrush () const"
.PP
Return the liquid brush above the alarm threshold. 
.PP
Definition at line 529 of file qwt_thermo.cpp.
.SS "const QColor & QwtThermo::alarmColor () const"
.PP
Return the liquid color above the alarm threshold. 
.PP
Definition at line 545 of file qwt_thermo.cpp.
.SS "bool QwtThermo::alarmEnabled () const"
.PP
Return if the alarm threshold is enabled or disabled. 
.PP
Definition at line 611 of file qwt_thermo.cpp.
.SS "double QwtThermo::alarmLevel () const"
.PP
Return the alarm threshold. 
.PP
Definition at line 559 of file qwt_thermo.cpp.
.SS "int QwtThermo::borderWidth () const"
.PP
Return the border width of the thermometer pipe. 
.PP
Definition at line 457 of file qwt_thermo.cpp.
.SS "void QwtThermo::draw (QPainter * p, const QRect & update_rect)\fC [protected]\fP"
.PP
Draw the whole QwtThermo. 
.PP
Definition at line 80 of file qwt_thermo.cpp.
.PP
References QwtScaleDraw::draw(), drawThermo(), and QwtScaleIf::scaleDraw().
.PP
Referenced by paintEvent().
.SS "void QwtThermo::drawThermo (QPainter * p)\fC [protected]\fP"
.PP
Redraw the liquid in thermometer pipe. 
.PP
Definition at line 288 of file qwt_thermo.cpp.
.PP
References QwtDiMap::limTransform().
.PP
Referenced by draw().
.SS "const QBrush & QwtThermo::fillBrush () const"
.PP
Return the liquid brush. 
.PP
Definition at line 497 of file qwt_thermo.cpp.
.SS "const QColor & QwtThermo::fillColor () const"
.PP
Return the liquid color. 
.PP
Definition at line 513 of file qwt_thermo.cpp.
.SS "void QwtThermo::fontChange (const QFont & oldFont)\fC [protected, virtual]\fP"
.PP
Notify a font change. 
.PP
Definition at line 274 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.SS "void QwtThermo::layoutThermo (bool update_geometry = \fCTRUE\fP)\fC [protected]\fP"
.PP
Recalculate the QwtThermo geometry and layout based on the QwtThermo::rect() and the fonts. 
.PP
\fBParameters:\fP
.RS 4
\fIupdate_geometry\fP notify the layout system and call update to redraw the scale 
.RE
.PP
Definition at line 109 of file qwt_thermo.cpp.
.PP
References QwtScaleDraw::minBorderDist(), QwtScaleIf::scaleDraw(), QwtScaleDraw::setGeometry(), and QwtDiMap::setIntRange().
.PP
Referenced by fontChange(), resizeEvent(), scaleChange(), setBorderWidth(), setOrientation(), setPipeWidth(), and setRange().
.SS "double QwtThermo::maxValue () const"
.PP
Return the maximum value. 
.PP
Definition at line 133 of file qwt_thermo.h.
.SS "QSize QwtThermo::minimumSizeHint () const\fC [virtual]\fP"
.PP
Return a minimum size hint. 
.PP
\fBWarning:\fP
.RS 4
The return value depends on the font and the scale. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtThermo::sizeHint\fP 
.RE
.PP
Definition at line 652 of file qwt_thermo.cpp.
.PP
References QwtScaleDraw::minHeight(), QwtScaleDraw::minWidth(), and QwtScaleIf::scaleDraw().
.PP
Referenced by sizeHint().
.SS "double QwtThermo::minValue () const"
.PP
Return the minimum value. 
.PP
Definition at line 138 of file qwt_thermo.h.
.SS "void QwtThermo::paintEvent (QPaintEvent * e)\fC [protected, virtual]\fP"
.PP
Qt paint event. 
.PP
Definition at line 68 of file qwt_thermo.cpp.
.PP
References draw(), and QwtPaintBuffer::painter().
.SS "int QwtThermo::pipeWidth () const"
.PP
Return the width of the pipe. 
.PP
Definition at line 575 of file qwt_thermo.cpp.
.SS "void QwtThermo::resizeEvent (QResizeEvent * e)\fC [protected, virtual]\fP"
.PP
Qt resize event handler. 
.PP
Definition at line 98 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.SS "void QwtThermo::scaleChange ()\fC [protected, virtual]\fP"
.PP
Notify a scale change. 
.PP
Implements \fBQwtScaleIf\fP.
.PP
Definition at line 281 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.PP
Referenced by setRange().
.SS "QwtThermo::ScalePos QwtThermo::scalePosition () const"
.PP
Return the scale position. 
.PP
Definition at line 268 of file qwt_thermo.cpp.
.SS "void QwtThermo::setAlarmBrush (const QBrush & b)"
.PP
Specify the liquid brush above the alarm threshold. 
.PP
\fBParameters:\fP
.RS 4
\fIc\fP New brush. The default is solid white. 
.RE
.PP
Definition at line 522 of file qwt_thermo.cpp.
.SS "void QwtThermo::setAlarmColor (const QColor & c)"
.PP
Specify the liquid color above the alarm threshold. 
.PP
\fBParameters:\fP
.RS 4
\fIc\fP New color. The default is white. 
.RE
.PP
Definition at line 538 of file qwt_thermo.cpp.
.SS "void QwtThermo::setAlarmEnabled (bool tf)"
.PP
Enable or disable the alarm threshold. 
.PP
\fBParameters:\fP
.RS 4
\fItf\fP TRUE (disabled) or FALSE (enabled) 
.RE
.PP
Definition at line 604 of file qwt_thermo.cpp.
.SS "void QwtThermo::setAlarmLevel (double v)"
.PP
Specify the alarm threshold. 
.PP
Definition at line 551 of file qwt_thermo.cpp.
.SS "void QwtThermo::setBorderWidth (int w)"
.PP
Set the border width of the pipe. 
.PP
Definition at line 446 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.SS "void QwtThermo::setFillBrush (const QBrush & b)"
.PP
Change the brush of the liquid. 
.PP
\fBParameters:\fP
.RS 4
\fIc\fP New brush. The default brush is solid black. 
.RE
.PP
Definition at line 490 of file qwt_thermo.cpp.
.SS "void QwtThermo::setFillColor (const QColor & c)"
.PP
Change the color of the liquid. 
.PP
\fBParameters:\fP
.RS 4
\fIc\fP New color. The default color is black. 
.RE
.PP
Definition at line 506 of file qwt_thermo.cpp.
.SS "void QwtThermo::setMargin (int m)"
.PP
Specify the distance between the pipe's endpoints and the widget's border. 
.PP
The margin is used to leave some space for the scale labels. If a large font is used, it is advisable to adjust the margins. 
.PP
\fBParameters:\fP
.RS 4
\fIm\fP New Margin. The default values are 10 for horizontal orientation and 20 for vertical orientation. 
.RE
.PP
\fBWarning:\fP
.RS 4
The margin has no effect if the scale is disabled. 
.PP
This function is a NOOP because margins are determined automatically. 
.RE
.PP
Definition at line 595 of file qwt_thermo.cpp.
.SS "void QwtThermo::setMaxValue (double v)"
.PP
Set the maximum value. 
.PP
Definition at line 131 of file qwt_thermo.h.
.SS "void QwtThermo::setMinValue (double v)"
.PP
Set the minimum value. 
.PP
Definition at line 136 of file qwt_thermo.h.
.SS "void QwtThermo::setOrientation (Qt::Orientation o, ScalePos s)"
.PP
Set the thermometer orientation and the scale position. 
.PP
The scale position None disables the scale. 
.PP
\fBParameters:\fP
.RS 4
\fIo\fP orientation. Possible values are Qt::Horizontal and Qt::Vertical. The default value is Qt::Vertical. 
.br
\fIs\fP Position of the scale. The default value is None.
.RE
.PP
A valid combination of scale position and orientation is enforced:
.IP "\(bu" 2
a horizontal thermometer can have the scale positions Top, Bottom or None;
.IP "\(bu" 2
a vertical thermometer can have the scale positions Left, Right or None;
.IP "\(bu" 2
an invalid scale position will default to None.
.PP
.PP
\fBSee also:\fP
.RS 4
\fBQwtThermo::setScalePosition()\fP 
.RE
.PP
Definition at line 220 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.PP
Referenced by setScalePosition().
.SS "void QwtThermo::setPipeWidth (int w)"
.PP
Change the width of the pipe. 
.PP
Definition at line 565 of file qwt_thermo.cpp.
.PP
References layoutThermo().
.SS "void QwtThermo::setRange (double vmin, double vmax, bool logarithmic = \fCFALSE\fP)"
.PP
Set the range. 
.PP
\fBParameters:\fP
.RS 4
\fIvmin\fP value corresponding lower or left end of the thermometer 
.br
\fIvmax\fP value corresponding to the upper or right end of the thermometer 
.br
\fIlogarithmic\fP logarithmic mapping, TRUE or FALSE 
.RE
.PP
Definition at line 468 of file qwt_thermo.cpp.
.PP
References QwtScaleIf::hasUserScale(), layoutThermo(), scaleChange(), QwtScaleDraw::scaleDiv(), QwtScaleIf::scaleDraw(), QwtScaleIf::scaleMaxMajor(), QwtScaleIf::scaleMaxMinor(), QwtDiMap::setDblRange(), and QwtScaleDraw::setScale().
.SS "void QwtThermo::setScalePosition (ScalePos s)"
.PP
Change the scale position (and thermometer orientation). 
.PP
\fBParameters:\fP
.RS 4
\fIs\fP Position of the scale.
.RE
.PP
A valid combination of scale position and orientation is enforced:
.IP "\(bu" 2
if the new scale position is Left or Right, the scale orientation will become Qt::Vertical;
.IP "\(bu" 2
if the new scale position is Bottom or Top, the scale orientation will become Qt::Horizontal;
.IP "\(bu" 2
if the new scale position is None, the scale orientation will not change.
.PP
.PP
\fBSee also:\fP
.RS 4
\fBQwtThermo::setOrientation()\fP 
.RE
.PP
Definition at line 257 of file qwt_thermo.cpp.
.PP
References setOrientation().
.SS "void QwtThermo::setValue (double val)\fC [slot]\fP"
.PP
Set the current value. 
.PP
Definition at line 58 of file qwt_thermo.cpp.
.SS "QSize QwtThermo::sizeHint () const\fC [virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
the minimum size hint 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtThermo::minimumSizeHint\fP 
.RE
.PP
Definition at line 642 of file qwt_thermo.cpp.
.PP
References minimumSizeHint().
.SS "QSizePolicy QwtThermo::sizePolicy () const\fC [virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
Fixed/MinimumExpanding for vertical, MinimumExpanding/Fixed for horizontal thermos. 
.RE
.PP
Definition at line 621 of file qwt_thermo.cpp.
.PP
References QwtScaleDraw::orientation(), and QwtScaleIf::scaleDraw().
.SS "double QwtThermo::value () const"
.PP
Return the value. 
.PP
Definition at line 141 of file qwt_thermo.h.

.SH "Author"
.PP 
Generated automatically by Doxygen for Qwt User's Guide from the source code.