qwtscaledraw.3

linux下qt的第三方的一个类

.TH "QwtScaleDraw" 3 "16 Nov 2004" "Version 4.2.0" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
QwtScaleDraw \- 
.SH SYNOPSIS
.br
.PP
Inherits \fBQwtDiMap\fP.
.PP
Inherited by \fBQwtDialScaleDraw\fP.
.PP
.SH "Detailed Description"
.PP 
A class for drawing scales. 

QwtScaleDraw can be used to draw linear or logarithmic scales. A scale has an origin, an orientation and a length, which all can be specified with \fBQwtScaleDraw::setGeometry()\fP. The labels can be rotated and aligned to the ticks using \fBQwtScaleDraw::setLabelRotation()\fP, \fBQwtScaleDraw::setLabelAlignment()\fP.
.PP
After a scale division has been specified as a \fBQwtScaleDiv\fP object using \fBQwtScaleDraw::setScale(const QwtScaleDiv &s)\fP, or determined internally using \fBQwtScaleDraw::setScale\fP(double vmin, double vmax, int maxMajIntv, int maxMinIntv, double step = 0.0, int logarithmic = 0), the scale can be drawn with the \fBQwtScaleDraw::draw()\fP member. 
.PP
Definition at line 38 of file qwt_scldraw.h.
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBOrientation\fP { \fBBottom\fP, \fBTop\fP, \fBLeft\fP, \fBRight\fP, \fBRound\fP }"
.br
.ti -1c
.RI "enum \fBOption\fP { \fBNone\fP =  0, \fBBackbone\fP =  1 }"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBQwtScaleDraw\fP ()"
.br
.ti -1c
.RI "virtual \fB~QwtScaleDraw\fP ()"
.br
.ti -1c
.RI "void \fBsetScale\fP (const \fBQwtScaleDiv\fP &s)"
.br
.ti -1c
.RI "void \fBsetScale\fP (double vmin, double vmax, int maxMajIntv, int maxMinIntv, double step=0.0, int logarithmic=0)"
.br
.ti -1c
.RI "void \fBsetOptions\fP (int opt)"
.br
.ti -1c
.RI "int \fBoptions\fP () const"
.br
.ti -1c
.RI "void \fBsetGeometry\fP (int xorigin, int yorigin, int length, \fBOrientation\fP o)"
.br
.ti -1c
.RI "int \fBx\fP () const"
.br
.ti -1c
.RI "int \fBy\fP () const"
.br
.ti -1c
.RI "int \fBlength\fP () const"
.br
.ti -1c
.RI "\fBOrientation\fP \fBorientation\fP () const"
.br
.ti -1c
.RI "void \fBsetAngleRange\fP (double angle1, double angle2)"
.br
.ti -1c
.RI "void \fBsetLabelFormat\fP (char f, int prec, int fieldwidth=0)"
.br
.ti -1c
.RI "void \fBsetLabelAlignment\fP (int align)"
.br
.ti -1c
.RI "void \fBsetLabelRotation\fP (double rotation)"
.br
.ti -1c
.RI "void \fBsetTickLength\fP (unsigned int minLen, unsigned int medLen, unsigned int majLen)"
.br
.ti -1c
.RI "void \fBsetMargin\fP (uint hMargin, uint vMargin)"
.br
.ti -1c
.RI "const \fBQwtScaleDiv\fP & \fBscaleDiv\fP () const"
.br
.ti -1c
.RI "int \fBmaxWidth\fP (const QPen &pen, const QFontMetrics &fm) const"
.br
.ti -1c
.RI "int \fBmaxHeight\fP (const QPen &pen, const QFontMetrics &fm) const"
.br
.ti -1c
.RI "void \fBminBorderDist\fP (const QFontMetrics &fm, int &start, int &end) const"
.br
.ti -1c
.RI "int \fBminLabelDist\fP (const QFontMetrics &fm) const"
.br
.ti -1c
.RI "int \fBminHeight\fP (const QPen &pen, const QFontMetrics &fm) const"
.br
.ti -1c
.RI "int \fBminWidth\fP (const QPen &pen, const QFontMetrics &fm) const"
.br
.ti -1c
.RI "void \fBlabelFormat\fP (char &f, int &prec, int &fieldwidth) const"
.br
.ti -1c
.RI "int \fBlabelAlignment\fP () const"
.br
.ti -1c
.RI "double \fBlabelRotation\fP () const"
.br
.ti -1c
.RI "void \fBtickLength\fP (unsigned int &minLen, unsigned int &medLen, unsigned int &majLen) const"
.br
.ti -1c
.RI "unsigned int \fBmajTickLength\fP () const"
.br
.ti -1c
.RI "virtual void \fBdraw\fP (QPainter *p) const"
.br
.ti -1c
.RI "virtual QString \fBlabel\fP (double) const"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBlabelPlacement\fP (const QFontMetrics &, double val, QPoint &pos, int &alignment, double &rotation) const"
.br
.ti -1c
.RI "virtual int \fBmaxLabelHeight\fP (const QFontMetrics &) const"
.br
.ti -1c
.RI "virtual int \fBmaxLabelWidth\fP (const QFontMetrics &) const"
.br
.ti -1c
.RI "QRect \fBlabelBoundingRect\fP (const QFontMetrics &, double val) const"
.br
.ti -1c
.RI "void \fBdrawTick\fP (QPainter *p, double val, int len) const"
.br
.ti -1c
.RI "void \fBdrawBackbone\fP (QPainter *p) const"
.br
.ti -1c
.RI "void \fBdrawLabel\fP (QPainter *p, double val) const"
.br
.ti -1c
.RI "QWMatrix \fBlabelWorldMatrix\fP (const QFontMetrics &, const QPoint &, int alignment, double rotation, const QString &) const"
.br
.in -1c
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBQwtScaleDraw::Orientation\fP"
.PP
Orientation/Position of the scale draw 
.PP
\fBSee also:\fP
.RS 4
\fBQwtScaleDraw::setGeometry\fP 
.RE
.PP
Definition at line 45 of file qwt_scldraw.h.
.PP
Referenced by orientation().
.SH "Constructor & Destructor Documentation"
.PP 
.SS "QwtScaleDraw::QwtScaleDraw ()"
.PP
Constructor. 
.PP
The range of the scale is initialized to [0, 100], the angle range is set to [-135, 135], the geometry is initialized such that the origin is at (0,0), the length is 100, and the orientation is QwtScaleDraw::Bottom. Definition at line 29 of file qwt_scldraw.cpp.
.PP
References setGeometry(), and setScale().
.SS "QwtScaleDraw::~\fBQwtScaleDraw\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 52 of file qwt_scldraw.cpp.
.SH "Member Function Documentation"
.PP 
.SS "void QwtScaleDraw::draw (QPainter * p) const\fC [virtual]\fP"
.PP
Draw the scale. 
.PP
\fBParameters:\fP
.RS 4
\fIp\fP the painter 
.RE
.PP
Definition at line 104 of file qwt_scldraw.cpp.
.PP
References drawBackbone(), drawLabel(), drawTick(), QwtScaleDiv::logScale(), QwtScaleDiv::majCnt(), QwtScaleDiv::majMark(), QwtScaleDiv::majStep(), QwtScaleDiv::minCnt(), QwtScaleDiv::minMark(), and options().
.PP
Referenced by QwtThermo::draw(), QwtSlider::draw(), QwtScale::draw(), QwtKnob::draw(), QwtDial::drawScale(), and QwtPlot::printScale().
.SS "void QwtScaleDraw::drawBackbone (QPainter * p) const\fC [protected]\fP"
.PP
Draws the baseline of the scale. 
.PP
Definition at line 374 of file qwt_scldraw.cpp.
.PP
References QwtPainter::drawLine(), QwtDiMap::i1(), and QwtDiMap::i2().
.PP
Referenced by draw().
.SS "void QwtScaleDraw::drawLabel (QPainter * p, double val) const\fC [protected]\fP"
.PP
Draws the number label for a major scale tick. 
.PP
Definition at line 204 of file qwt_scldraw.cpp.
.PP
References QwtPainter::drawText(), label(), labelPlacement(), and labelWorldMatrix().
.PP
Referenced by draw().
.SS "void QwtScaleDraw::drawTick (QPainter * p, double val, int len) const\fC [protected]\fP"
.PP
Draws a single scale tick. 
.PP
Definition at line 160 of file qwt_scldraw.cpp.
.PP
References QwtPainter::drawLine(), and QwtDiMap::transform().
.PP
Referenced by draw().
.SS "QString QwtScaleDraw::label (double value) const\fC [virtual]\fP"
.PP
Convert a value into its representing label using the labelFormat. 
.PP
\fBParameters:\fP
.RS 4
\fIvalue\fP Value 
.RE
.PP
\fBReturns:\fP
.RS 4
Label string. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScaleDraw::setLabelFormat()\fP 
.RE
.PP

.PP
Reimplemented in \fBQwtDialScaleDraw\fP.
.PP
Definition at line 1045 of file qwt_scldraw.cpp.
.PP
Referenced by drawLabel(), QwtDialScaleDraw::label(), labelBoundingRect(), and labelPlacement().
.SS "int QwtScaleDraw::labelAlignment () const"
.PP
\fBReturns:\fP
.RS 4
the label alignment 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetLabelAlignment()\fP, \fBlabelRotation()\fP 
.RE
.PP
Definition at line 588 of file qwt_scldraw.cpp.
.SS "QRect QwtScaleDraw::labelBoundingRect (const QFontMetrics & fm, double val) const\fC [protected]\fP"
.PP
Find the bounding rect for the label. The coordinates of the rect are relative to margin + ticklength from the backbone in direction of the tick. Definition at line 793 of file qwt_scldraw.cpp.
.PP
References label(), labelPlacement(), and labelWorldMatrix().
.PP
Referenced by maxLabelHeight(), maxLabelWidth(), minBorderDist(), and minLabelDist().
.SS "void QwtScaleDraw::labelFormat (char & f, int & prec, int & fieldwidth) const"
.PP
Return the number format for the major scale labels. 
.PP
Format character, precision and fieldwidth have the same meaning as for sprintf(). 
.PP
\fBParameters:\fP
.RS 4
\fIf\fP format character 'e', 'f' or 'g' 
.br
\fIprec\fP 
.IP "\(bu" 2
for 'e', 'f': the number of digits after the radix character (point)
.IP "\(bu" 2
for 'g': the maximum number of significant digits 
.PP
.br
\fIfieldwidth\fP fieldwidth
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetLabelFormat()\fP 
.RE
.PP
Definition at line 679 of file qwt_scldraw.cpp.
.PP
Referenced by QwtScale::labelFormat().
.SS "void QwtScaleDraw::labelPlacement (const QFontMetrics &, double val, QPoint & pos, int & alignment, double & rotation) const\fC [protected, virtual]\fP"
.PP
Find position, alignment and rotation of the label. 
.PP
Definition at line 232 of file qwt_scldraw.cpp.
.PP
References label(), QwtScaleDiv::logScale(), QwtScaleDiv::majStep(), QwtDiMap::transform(), x(), and y().
.PP
Referenced by drawLabel(), and labelBoundingRect().
.SS "double QwtScaleDraw::labelRotation () const"
.PP
\fBReturns:\fP
.RS 4
the label rotation 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetLabelRotation()\fP, \fBlabelAlignment()\fP 
.RE
.PP
Definition at line 555 of file qwt_scldraw.cpp.
.SS "QWMatrix QwtScaleDraw::labelWorldMatrix (const QFontMetrics &, const QPoint &, int alignment, double rotation, const QString &) const\fC [protected]\fP"
.PP
Return the world matrix for painting the label. 
.PP
Definition at line 335 of file qwt_scldraw.cpp.
.PP
References x(), and y().
.PP
Referenced by drawLabel(), and labelBoundingRect().
.SS "int QwtScaleDraw::length () const"
.PP
Return length. 
.PP
Definition at line 1076 of file qwt_scldraw.cpp.
.PP
Referenced by QwtPlot::printScale().
.SS "unsigned int QwtScaleDraw::majTickLength () const"
.PP
Return the length of the major ticks 
.PP
\fBSee also:\fP
.RS 4
\fBQwtScaleDraw::tickLength()\fP 
.RE
.PP
Definition at line 727 of file qwt_scldraw.cpp.
.PP
Referenced by QwtPlotLayout::minimumSizeHint().
.SS "int QwtScaleDraw::maxHeight (const QPen & pen, const QFontMetrics & fm) const"
.PP
\fBParameters:\fP
.RS 4
\fIpen\fP pen 
.br
\fIfm\fP font metrics 
.RE
.PP
\fBReturns:\fP
.RS 4
the maximum height of the scale 
.RE
.PP
Definition at line 513 of file qwt_scldraw.cpp.
.PP
References maxLabelHeight().
.PP
Referenced by QwtScale::layoutScale(), maxLabelHeight(), and QwtDial::scaleContentsRect().
.SS "int QwtScaleDraw::maxLabelHeight (const QFontMetrics & fm) const\fC [protected, virtual]\fP"
.PP
\fBParameters:\fP
.RS 4
\fIfm\fP QFontMetrics 
.RE
.PP
\fBReturns:\fP
.RS 4
the maximum width of a label 
.RE
.PP
Definition at line 764 of file qwt_scldraw.cpp.
.PP
References labelBoundingRect(), QwtScaleDiv::logScale(), QwtScaleDiv::majCnt(), QwtScaleDiv::majMark(), QwtScaleDiv::majStep(), and maxHeight().
.PP
Referenced by maxHeight(), and minHeight().
.SS "int QwtScaleDraw::maxLabelWidth (const QFontMetrics & fm) const\fC [protected, virtual]\fP"