qwtscale.3

linux下qt的第三方的一个类

.TH "QwtScale" 3 "16 Nov 2004" "Version 4.2.0" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
QwtScale \- 
.SH SYNOPSIS
.br
.PP
.SH "Detailed Description"
.PP 
A Widget which contains a scale. 

This Widget can be used to decorate composite widgets with a scale. 
.PP
Definition at line 34 of file qwt_scale.h.
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBPosition\fP { \fBLeft\fP, \fBRight\fP, \fBTop\fP, \fBBottom\fP }"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBQwtScale\fP (QWidget *parent=0, const char *name=0)"
.br
.ti -1c
.RI "\fBQwtScale\fP (\fBPosition\fP, QWidget *parent=0, const char *name=0)"
.br
.ti -1c
.RI "virtual \fB~QwtScale\fP ()"
.br
.ti -1c
.RI "void \fBsetTitle\fP (const QString &title)"
.br
.ti -1c
.RI "const QString \fBtitle\fP () const"
.br
.ti -1c
.RI "void \fBsetTitleColor\fP (const QColor &c)"
.br
.ti -1c
.RI "const QColor \fBtitleColor\fP () const"
.br
.ti -1c
.RI "void \fBsetTitleFont\fP (const QFont &f)"
.br
.ti -1c
.RI "const QFont \fBtitleFont\fP () const"
.br
.ti -1c
.RI "void \fBsetTitleAlignment\fP (int flags)"
.br
.ti -1c
.RI "int \fBtitleAlignment\fP () const"
.br
.ti -1c
.RI "void \fBsetBorderDist\fP (int start, int end)"
.br
.ti -1c
.RI "int \fBstartBorderDist\fP () const"
.br
.ti -1c
.RI "int \fBendBorderDist\fP () const"
.br
.ti -1c
.RI "void \fBminBorderDist\fP (int &start, int &end) const"
.br
.ti -1c
.RI "void \fBsetBaselineDist\fP (int bd)"
.br
.ti -1c
.RI "int \fBbaseLineDist\fP () const"
.br
.ti -1c
.RI "void \fBsetTitleDist\fP (int td)"
.br
.ti -1c
.RI "int \fBtitleDist\fP () const"
.br
.ti -1c
.RI "void \fBsetScaleDiv\fP (const \fBQwtScaleDiv\fP &sd)"
.br
.ti -1c
.RI "void \fBsetScaleDraw\fP (\fBQwtScaleDraw\fP *)"
.br
.ti -1c
.RI "const \fBQwtScaleDraw\fP * \fBscaleDraw\fP () const"
.br
.ti -1c
.RI "void \fBsetLabelFormat\fP (char f, int prec, int fieldWidth)"
.br
.ti -1c
.RI "void \fBlabelFormat\fP (char &f, int &prec, int &fieldWidth) const"
.br
.ti -1c
.RI "void \fBsetLabelAlignment\fP (int align)"
.br
.ti -1c
.RI "void \fBsetLabelRotation\fP (double rotation)"
.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
.ti -1c
.RI "int \fBtitleHeightForWidth\fP (int width) const"
.br
.ti -1c
.RI "int \fBdimForLength\fP (int length, const QFontMetrics &scaleFontMetrics) const"
.br
.ti -1c
.RI "void \fBdrawTitle\fP (QPainter *painter, \fBQwtScaleDraw::Orientation\fP o, const QRect &rect) const"
.br
.ti -1c
.RI "void \fBsetPosition\fP (\fBPosition\fP o)"
.br
.ti -1c
.RI "\fBPosition\fP \fBposition\fP () const"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBdraw\fP (QPainter *p) const"
.br
.ti -1c
.RI "void \fBpaintEvent\fP (QPaintEvent *e)"
.br
.ti -1c
.RI "void \fBresizeEvent\fP (QResizeEvent *e)"
.br
.ti -1c
.RI "void \fBscaleChange\fP ()"
.br
.ti -1c
.RI "void \fBfontChange\fP (const QFont &oldfont)"
.br
.ti -1c
.RI "void \fBlayoutScale\fP (bool update=TRUE)"
.br
.in -1c
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBQwtScale::Position\fP"
.PP
Position of the scale 
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::QwtScale\fP 
.RE
.PP
Definition at line 49 of file qwt_scale.h.
.PP
Referenced by position().
.SH "Constructor & Destructor Documentation"
.PP 
.SS "QwtScale::QwtScale (QWidget * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Create a scale with the position QwtScale::Left. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP .br
\fIname\fP passed to QWidget's CTOR
.RE
.PP
\fBWarning:\fP
.RS 4
Workaround of a designer problem 
.RE
.PP
Definition at line 27 of file qwt_scale.cpp.
.SS "QwtScale::QwtScale (\fBQwtScale::Position\fP pos, QWidget * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Constructor. 
.PP
\fBParameters:\fP
.RS 4
\fIpos\fP Position. Must be one of \fCQwtScale::Left, QwtScale::Right, QwtScale::Bottom, \fPor \fCQwtScale::Top\fP 
.br
\fIparent\fP 
.br
\fIname\fP passed to QWidget's CTOR 
.RE
.PP
Definition at line 41 of file qwt_scale.cpp.
.SS "QwtScale::~\fBQwtScale\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 48 of file qwt_scale.cpp.
.SH "Member Function Documentation"
.PP 
.SS "int QwtScale::baseLineDist () const"
.PP
\fBReturns:\fP
.RS 4
base line distance 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::setBaselineDist\fP 
.RE
.PP
Definition at line 396 of file qwt_scale.cpp.
.PP
Referenced by QwtPlotLayout::minimumSizeHint(), and QwtPlot::print().
.SS "int QwtScale::dimForLength (int length, const QFontMetrics & scaleFontMetrics) const"
.PP
Find the minimum dimension for a given length. dim is the height, length the width seen in direction of the title. 
.PP
\fBParameters:\fP
.RS 4
\fIlength\fP width for horizontal, height for vertical scales 
.br
\fIscaleFontMetrics\fP Font metrics of the scale 
.RE
.PP
\fBReturns:\fP
.RS 4
height for horizontal, width for vertical scales 
.RE
.PP
Definition at line 686 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::minHeight(), QwtScaleDraw::minWidth(), QwtScaleDraw::orientation(), QwtText::text(), and titleHeightForWidth().
.PP
Referenced by minimumSizeHint().
.SS "void QwtScale::draw (QPainter * p) const\fC [protected]\fP"
.PP
draw the scale 
.PP
Definition at line 426 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::draw(), drawTitle(), and QwtScaleDraw::orientation().
.PP
Referenced by paintEvent().
.SS "void QwtScale::drawTitle (QPainter * painter, \fBQwtScaleDraw::Orientation\fP o, const QRect & rect) const"
.PP
Rotate and paint a title according to its position into a given rectangle. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIo\fP Orientation 
.br
\fIrect\fP Bounding rectangle 
.RE
.PP
Definition at line 529 of file qwt_scale.cpp.
.PP
References QwtText::alignment(), QwtText::draw(), and QwtText::setAlignment().
.PP
Referenced by draw(), and QwtPlot::printScale().
.SS "int QwtScale::endBorderDist () const"
.PP
\fBReturns:\fP
.RS 4
end border distance 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::setBorderDist\fP 
.RE
.PP
Definition at line 387 of file qwt_scale.cpp.
.PP
Referenced by QwtPlot::canvasMap().
.SS "void QwtScale::fontChange (const QFont & oldFont)\fC [protected]\fP"
.PP
Notify a change of the font. 
.PP
This virtual function may be overloaded by derived widgets. The default implementation resizes the scale and repaints the widget. 
.PP
\fBParameters:\fP
.RS 4
\fIoldFont\fP Previous font 
.RE
.PP
Definition at line 732 of file qwt_scale.cpp.
.PP
References layoutScale().
.SS "void QwtScale::labelFormat (char & f, int & prec, int & fieldwidth) const"
.PP
Format character and precision have the same meaning as for the QString class. 
.PP
\fBReturn values:\fP
.RS 4
\fIf\fP format character 
.br
\fIprec\fP precision 
.br
\fIfieldwidth\fP minimum fieldwidth 
.RE
.PP
\fBReturns:\fP
.RS 4
the number format for the major scale labels 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::setLabelFormat\fP, QString::sprintf in the Qt manual 
.RE
.PP
Definition at line 324 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::labelFormat().
.PP
Referenced by QwtPlot::axisLabelFormat().
.SS "void QwtScale::layoutScale (bool update = \fCTRUE\fP)\fC [protected]\fP"
.PP
Recalculate the scale's geometry and layout based on. 
.PP
Definition at line 468 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::maxHeight(), QwtScaleDraw::maxWidth(), minBorderDist(), QwtScaleDraw::orientation(), and QwtScaleDraw::setGeometry().
.PP
Referenced by fontChange(), resizeEvent(), scaleChange(), setBaselineDist(), setBorderDist(), setLabelAlignment(), setLabelFormat(), setLabelRotation(), setPosition(), setScaleDiv(), setScaleDraw(), setTitle(), setTitleAlignment(), setTitleDist(), and setTitleFont().
.SS "void QwtScale::minBorderDist (int & start, int & end) const"
.PP
Determine the minimum Border distances. 
.PP
This member function returns the minimum distance of the scale's endpoints from the widget borders which is required for the mark labels to fit into the widget. 
.PP
\fBWarning:\fP
.RS 4
.PD 0

.IP "\(bu" 2
The minimum border distance depends on the font.
.PP
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::setBorderDist()\fP 
.RE
.PP
Definition at line 718 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::minBorderDist().
.PP
Referenced by QwtPlotPrintFilter::apply(), layoutScale(), minimumSizeHint(), QwtPlotLayout::minimumSizeHint(), QwtPlotPrintFilter::reset(), and QwtPlot::updateAxes().
.SS "QSize QwtScale::minimumSizeHint () const\fC [virtual]\fP"
.PP
\fBReturns:\fP
.RS 4
a minimum size hint 
.RE
.PP
Definition at line 628 of file qwt_scale.cpp.
.PP
References dimForLength(), minBorderDist(), QwtScaleDraw::minHeight(), QwtScaleDraw::minWidth(), and QwtScaleDraw::orientation().
.PP
Referenced by QwtPlotLayout::minimumSizeHint(), sizeHint(), and QwtPlot::sizeHint().
.SS "void QwtScale::paintEvent (QPaintEvent * e)\fC [protected]\fP"
.PP
paintEvent 
.PP
Definition at line 413 of file qwt_scale.cpp.
.PP
References draw(), and QwtPaintBuffer::painter().
.SS "\fBQwtScale::Position\fP QwtScale::position () const"
.PP
\fBReturns:\fP
.RS 4
position 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtScale::setPosition\fP 
.RE
.PP
Definition at line 144 of file qwt_scale.cpp.
.PP
References QwtScaleDraw::orientation(), Position, and scaleDraw().
.SS "void QwtScale::resizeEvent (QResizeEvent * e)\fC [protected]\fP"
.PP
resizeEvent 
.PP
Definition at line 458 of file qwt_scale.cpp.