QwtScaleDraw can be used to draw linear or logarithmic scales. A scale has a position, an alignment and a length, which can be specified . The labels can be rotated and aligned to the ticks using setLabelRotation() and setLabelAlignment().
After a scale division has been specified as a QwtScaleDiv object using QwtAbstractScaleDraw::setScaleDiv(const QwtScaleDiv &s), the scale can be drawn with the QwtAbstractScaleDraw::draw() member.
Definition at line 30 of file qwt_scale_draw.h.
Public Types | |
enum | Alignment { BottomScale, TopScale, LeftScale, RightScale } |
Public Member Functions | |
QwtScaleDraw () | |
QwtScaleDraw (const QwtScaleDraw &) | |
virtual | ~QwtScaleDraw () |
QwtScaleDraw & | operator= (const QwtScaleDraw &other) |
void | getBorderDistHint (const QFont &, int &start, int &end) const |
int | minLabelDist (const QFont &) const |
int | minLength (const QPen &, const QFont &) const |
virtual int | extent (const QPen &, const QFont &) const |
void | move (int x, int y) |
void | move (const QPoint &) |
void | setLength (int length) |
Alignment | alignment () const |
void | setAlignment (Alignment) |
Qt::Orientation | orientation () const |
QPoint | pos () const |
int | length () const |
void | setLabelAlignment (Qt::Alignment) |
Qt::Alignment | labelAlignment () const |
void | setLabelRotation (double rotation) |
double | labelRotation () const |
int | maxLabelHeight (const QFont &) const |
int | maxLabelWidth (const QFont &) const |
QPoint | labelPosition (double val) const |
QRect | labelRect (const QFont &, double val) const |
QSize | labelSize (const QFont &, double val) const |
Protected Member Functions | |
QMatrix | labelMatrix (const QPoint &, const QSize &) const |
virtual void | drawTick (QPainter *p, double val, int len) const |
virtual void | drawBackbone (QPainter *p) const |
virtual void | drawLabel (QPainter *p, double val) const |
Alignment of the scale draw
Definition at line 37 of file qwt_scale_draw.h.
QwtScaleDraw::QwtScaleDraw | ( | ) |
Constructor.
The range of the scale is initialized to [0, 100], The position is at (0, 0) with a length of 100. The orientation is QwtAbstractScaleDraw::Bottom.
Definition at line 60 of file qwt_scale_draw.cpp.
References setLength().
QwtScaleDraw::QwtScaleDraw | ( | const QwtScaleDraw & | ) |
QwtScaleDraw::~QwtScaleDraw | ( | ) | [virtual] |
QwtScaleDraw & QwtScaleDraw::operator= | ( | const QwtScaleDraw & | other | ) |
void QwtScaleDraw::getBorderDistHint | ( | const QFont & | font, | |
int & | start, | |||
int & | end | |||
) | const |
Determine the minimum border distance.
This member function returns the minimum space needed to draw the mark labels at the scale's endpoints.
font | Font | |
start | Start border distance | |
end | End border distance |
Definition at line 139 of file qwt_scale_draw.cpp.
References QwtAbstractScaleDraw::hasComponent(), labelRect(), QwtAbstractScaleDraw::Labels, QwtScaleDiv::MajorTick, QwtAbstractScaleDraw::map(), orientation(), QwtAbstractScaleDraw::scaleDiv(), and QwtScaleDiv::ticks().
Referenced by QwtSlider::layoutSlider(), QwtThermo::layoutThermo(), QwtSlider::minimumSizeHint(), and minLength().
int QwtScaleDraw::minLabelDist | ( | const QFont & | font | ) | const |
Determine the minimum distance between two labels, that is necessary that the texts don't overlap.
font | Font |
Definition at line 192 of file qwt_scale_draw.cpp.
References QwtAbstractScaleDraw::hasComponent(), labelRect(), labelRotation(), QwtAbstractScaleDraw::Labels, QwtScaleDiv::MajorTick, orientation(), QwtAbstractScaleDraw::scaleDiv(), and QwtScaleDiv::ticks().
Referenced by minLength().
int QwtScaleDraw::minLength | ( | const QPen & | pen, | |
const QFont & | font | |||
) | const |
Calculate the minimum length that is needed to draw the scale
pen | Pen that is used for painting backbone and ticks | |
font | Font used for painting the labels |
Definition at line 318 of file qwt_scale_draw.cpp.
References getBorderDistHint(), QwtAbstractScaleDraw::hasComponent(), QwtAbstractScaleDraw::Labels, QwtScaleDiv::MajorTick, QwtScaleDiv::MediumTick, minLabelDist(), QwtScaleDiv::MinorTick, QwtAbstractScaleDraw::scaleDiv(), QwtAbstractScaleDraw::Ticks, and QwtScaleDiv::ticks().
Referenced by QwtThermo::minimumSizeHint(), and QwtSlider::minimumSizeHint().
int QwtScaleDraw::extent | ( | const QPen & | pen, | |
const QFont & | font | |||
) | const [virtual] |
Calculate the width/height that is needed for a vertical/horizontal scale.
The extent is calculated from the pen width of the backbone, the major tick length, the spacing and the maximum width/height of the labels.
pen | Pen that is used for painting backbone and ticks | |
font | Font used for painting the labels |
Implements QwtAbstractScaleDraw.
Definition at line 280 of file qwt_scale_draw.cpp.
References QwtAbstractScaleDraw::Backbone, QwtAbstractScaleDraw::hasComponent(), QwtAbstractScaleDraw::Labels, QwtAbstractScaleDraw::majTickLength(), maxLabelHeight(), maxLabelWidth(), QwtAbstractScaleDraw::minimumExtent(), orientation(), QwtAbstractScaleDraw::spacing(), and QwtAbstractScaleDraw::Ticks.
Referenced by QwtThermo::minimumSizeHint(), and QwtSlider::minimumSizeHint().
void QwtScaleDraw::move | ( | const QPoint & | pos | ) |
Move the position of the scale.
The meaning of the parameter pos depends on the alignment:
pos | Origin of the scale |
Definition at line 566 of file qwt_scale_draw.cpp.
void QwtScaleDraw::setLength | ( | int | length | ) |
Set the length of the backbone.
The length doesn't include the space needed for overlapping labels.
Definition at line 589 of file qwt_scale_draw.cpp.
Referenced by QwtSlider::layoutSlider(), QwtThermo::layoutThermo(), QwtPlot::printScale(), and QwtScaleDraw().
QwtScaleDraw::Alignment QwtScaleDraw::alignment | ( | ) | const |
Return alignment of the scale
Definition at line 91 of file qwt_scale_draw.cpp.
Referenced by QwtScaleWidget::alignment(), drawBackbone(), drawTick(), labelMatrix(), and labelPosition().
void QwtScaleDraw::setAlignment | ( | Alignment | align | ) |
Set the alignment of the scale
The default alignment is QwtScaleDraw::BottomScale
Definition at line 102 of file qwt_scale_draw.cpp.
Referenced by QwtThermo::layoutThermo(), and QwtScaleWidget::setScaleDraw().
Qt::Orientation QwtScaleDraw::orientation | ( | ) | const |
Return the orientation
TopScale, BottomScale are horizontal (Qt::Horizontal) scales, LeftScale, RightScale are vertical (Qt::Vertical) scales.
Definition at line 115 of file qwt_scale_draw.cpp.
References BottomScale, LeftScale, RightScale, and TopScale.
Referenced by QwtScaleWidget::drawColorBar(), drawTick(), extent(), getBorderDistHint(), minLabelDist(), and QwtPlot::printScale().
QPoint QwtScaleDraw::pos | ( | ) | const |
Definition at line 576 of file qwt_scale_draw.cpp.
Referenced by drawBackbone(), drawLabel(), drawTick(), labelRect(), and QwtPlot::printScale().
int QwtScaleDraw::length | ( | ) | const |
Definition at line 599 of file qwt_scale_draw.cpp.
Referenced by QwtPlot::printScale().
void QwtScaleDraw::setLabelAlignment | ( | Qt::Alignment | alignment | ) |
Change the label flags.
Labels are aligned to the point ticklength + spacing away from the backbone.
The alignment is relative to the orientation of the label text. In case of an flags of 0 the label will be aligned depending on the orientation of the scale:
QwtScaleDraw::TopScale: Qt::AlignHCenter | Qt::AlignTop
QwtScaleDraw::BottomScale: Qt::AlignHCenter | Qt::AlignBottom
QwtScaleDraw::LeftScale: Qt::AlignLeft | Qt::AlignVCenter
QwtScaleDraw::RightScale: Qt::AlignRight | Qt::AlignVCenter
Changing the alignment is often necessary for rotated labels.
alignment | Or'd Qt::AlignmentFlags <see qnamespace.h> |
Definition at line 821 of file qwt_scale_draw.cpp.
Qt::Alignment QwtScaleDraw::labelAlignment | ( | ) | const |
Definition at line 834 of file qwt_scale_draw.cpp.
Referenced by labelMatrix().
void QwtScaleDraw::setLabelRotation | ( | double | rotation | ) |
Rotate all labels.
When changing the rotation, it might be necessary to adjust the label flags too. Finding a useful combination is often the result of try and error.
rotation | Angle in degrees. When changing the label rotation, the label flags often needs to be adjusted too. |
Definition at line 779 of file qwt_scale_draw.cpp.
double QwtScaleDraw::labelRotation | ( | ) | const |
Definition at line 788 of file qwt_scale_draw.cpp.
Referenced by labelMatrix(), and minLabelDist().
int QwtScaleDraw::maxLabelHeight | ( | const QFont & | font | ) | const |
font | Font |
Definition at line 867 of file qwt_scale_draw.cpp.
References labelSize(), QwtScaleDiv::MajorTick, QwtAbstractScaleDraw::scaleDiv(), and QwtScaleDiv::ticks().
Referenced by extent().
int QwtScaleDraw::maxLabelWidth | ( | const QFont & | font | ) | const |
font | Font |
Definition at line 844 of file qwt_scale_draw.cpp.
References labelSize(), QwtScaleDiv::MajorTick, QwtAbstractScaleDraw::scaleDiv(), and QwtScaleDiv::ticks().
Referenced by extent().
QPoint QwtScaleDraw::labelPosition | ( | double | value | ) | const |
Find the position, where to paint a label
The position has a distance of majTickLength() + spacing() + 1 from the backbone. The direction depends on the alignment()
value | Value |
Definition at line 356 of file qwt_scale_draw.cpp.
References alignment(), BottomScale, QwtAbstractScaleDraw::hasComponent(), LeftScale, QwtAbstractScaleDraw::majTickLength(), QwtAbstractScaleDraw::map(), RightScale, QwtAbstractScaleDraw::spacing(), QwtAbstractScaleDraw::Ticks, TopScale, and QwtScaleMap::transform().
Referenced by drawLabel(), and labelRect().
QRect QwtScaleDraw::labelRect | ( | const QFont & | font, | |
double | value | |||
) | const |
Find the bounding rect for the label. The coordinates of the rect are relative to spacing + ticklength from the backbone in direction of the tick.
font | Font used for painting | |
value | Value |
Definition at line 717 of file qwt_scale_draw.cpp.
References QwtText::isEmpty(), labelMatrix(), labelPosition(), labelSize(), pos(), QwtText::textSize(), QwtAbstractScaleDraw::tickLabel(), and QwtMetricsMap::translate().
Referenced by getBorderDistHint(), labelSize(), and minLabelDist().
QSize QwtScaleDraw::labelSize | ( | const QFont & | font, | |
double | value | |||
) | const |
Calculate the size that is needed to draw a label
font | Label font | |
value | Value |
Definition at line 761 of file qwt_scale_draw.cpp.
References labelRect().
Referenced by drawLabel(), labelRect(), maxLabelHeight(), and maxLabelWidth().
QMatrix QwtScaleDraw::labelMatrix | ( | const QPoint & | pos, | |
const QSize & | size | |||
) | const [protected] |
Calculate the matrix that is needed to paint a label depending on its alignment and rotation.
pos | Position where to paint the label | |
size | Size of the label |
Definition at line 646 of file qwt_scale_draw.cpp.
References alignment(), BottomScale, labelAlignment(), labelRotation(), LeftScale, RightScale, and TopScale.
Referenced by drawLabel(), and labelRect().
void QwtScaleDraw::drawTick | ( | QPainter * | painter, | |
double | value, | |||
int | len | |||
) | const [protected, virtual] |
Draw a tick
painter | Painter | |
value | Value of the tick | |
len | Lenght of the tick |
Implements QwtAbstractScaleDraw.
Definition at line 406 of file qwt_scale_draw.cpp.
References alignment(), BottomScale, QwtPainter::drawLine(), QwtMetricsMap::isIdentity(), QwtMetricsMap::layoutToDevice(), QwtMetricsMap::layoutToDeviceX(), QwtMetricsMap::layoutToDeviceY(), LeftScale, QwtAbstractScaleDraw::map(), QwtPainter::metricsMap(), orientation(), pos(), QwtPainter::resetMetricsMap(), RightScale, QwtAbstractScaleDraw::scaleMap(), QwtPainter::setMetricsMap(), and TopScale.
void QwtScaleDraw::drawBackbone | ( | QPainter * | painter | ) | const [protected, virtual] |
Draws the baseline of the scale
painter | Painter |
Implements QwtAbstractScaleDraw.
Definition at line 507 of file qwt_scale_draw.cpp.
References alignment(), BottomScale, QwtPainter::drawLine(), LeftScale, pos(), RightScale, and TopScale.
void QwtScaleDraw::drawLabel | ( | QPainter * | painter, | |
double | value | |||
) | const [protected, virtual] |
Draws the label for a major scale tick
painter | Painter | |
value | Value |
Implements QwtAbstractScaleDraw.
Definition at line 612 of file qwt_scale_draw.cpp.
References QwtText::draw(), QwtText::isEmpty(), labelMatrix(), labelPosition(), labelSize(), pos(), QwtText::textSize(), and QwtAbstractScaleDraw::tickLabel().