QwtScaleWidget man page

QwtScaleWidget —

A Widget which contains a scale.


#include <qwt_scale_widget.h>


void scaleDivChanged ()

Public Member Functions

QwtScaleDraw::Alignment alignment () const

QwtDoubleInterval colorBarInterval () const

QRect colorBarRect (const QRect &) const

int colorBarWidth () const

const QwtColorMap & colorMap () const

int dimForLength (int length, const QFont &scaleFont) const

void drawColorBar (QPainter *painter, const QRect &rect) const

void drawTitle (QPainter *painter, QwtScaleDraw::Alignment, const QRect &rect) const

int endBorderDist () const

void getBorderDistHint (int &start, int &end) const

void getMinBorderDist (int &start, int &end) const

bool isColorBarEnabled () const

int margin () const

virtual QSize minimumSizeHint () const

int penWidth () const

QwtScaleWidget (QWidget *parent=NULL)

QwtScaleWidget (QwtScaleDraw::Alignment, QWidget *parent=NULL)

const QwtScaleDraw * scaleDraw () const

QwtScaleDraw * scaleDraw ()

void setAlignment (QwtScaleDraw::Alignment)

void setBorderDist (int start, int end)

void setColorBarEnabled (bool)

void setColorBarWidth (int)

void setColorMap (const QwtDoubleInterval &, const QwtColorMap &)

void setLabelAlignment (Qt::Alignment)

void setLabelRotation (double rotation)

void setMargin (int)

void setMinBorderDist (int start, int end)

void setPenWidth (int)

void setScaleDiv (QwtScaleTransformation *, const QwtScaleDiv &sd)

void setScaleDraw (QwtScaleDraw *)

void setSpacing (int td)

void setTitle (const QString &title)

void setTitle (const QwtText &title)

virtual QSize sizeHint () const

int spacing () const

int startBorderDist () const

QwtText title () const

int titleHeightForWidth (int width) const

virtual ~QwtScaleWidget ()

Protected Member Functions

void draw (QPainter *p) const

void layoutScale (bool update=true)

virtual void paintEvent (QPaintEvent *e)

virtual void resizeEvent (QResizeEvent *e)

void scaleChange ()

Detailed Description

A Widget which contains a scale.

This Widget can be used to decorate composite widgets with a scale.

Constructor & Destructor Documentation

QwtScaleWidget::QwtScaleWidget (QWidget *parent = NULL) [explicit]

Create a scale with the position QwtScaleWidget::Left. Parameters:

parent Parent widget

QwtScaleWidget::QwtScaleWidget (QwtScaleDraw::Alignmentalign, QWidget *parent = NULL) [explicit]

Constructor. Parameters:

align Alignment.
parent Parent widget

QwtScaleWidget::~QwtScaleWidget () [virtual]


Member Function Documentation

QwtScaleDraw::Alignment QwtScaleWidget::alignment () const Returns


See also:


int QwtScaleWidget::dimForLength (intlength, const QFont &scaleFont) const

Find the minimum dimension for a given length. dim is the height, length the width seen in direction of the title. Parameters:

length width for horizontal, height for vertical scales
scaleFont Font of the scale


height for horizontal, width for vertical scales

void QwtScaleWidget::draw (QPainter *p) const [protected]

draw the scale

void QwtScaleWidget::drawTitle (QPainter *painter, QwtScaleDraw::Alignmentalign, const QRect &rect) const Rotate and paint a title according to its position into a given rectangle.


painter Painter
align Alignment
rect Bounding rectangle

int QwtScaleWidget::endBorderDist () const Returns

end border distance

See also:


void QwtScaleWidget::getBorderDistHint (int &start, int &end) const

Calculate a hint for the border distances. This member function calculates the distance of the scale's endpoints from the widget borders which is required for the mark labels to fit into the widget. The maximum of this distance an the minimum border distance is returned.


The minimum border distance depends on the font.

See also:

setMinBorderDist(), getMinBorderDist(), setBorderDist()

void QwtScaleWidget::getMinBorderDist (int &start, int &end) const Get the minimum value for the distances of the scale's endpoints from the widget borders.

See also:

setMinBorderDist(), getBorderDistHint()

void QwtScaleWidget::layoutScale (boolupdate = true) [protected]

Recalculate the scale's geometry and layout based on.

int QwtScaleWidget::margin () const Returns


See also:


QSize QwtScaleWidget::minimumSizeHint () const [virtual] Returns

a minimum size hint

void QwtScaleWidget::paintEvent (QPaintEvent *e) [protected, virtual]


int QwtScaleWidget::penWidth () const Returns

Scale pen width

See also:


void QwtScaleWidget::resizeEvent (QResizeEvent *e) [protected, virtual]


void QwtScaleWidget::scaleChange () [protected]

Notify a change of the scale. This virtual function can be overloaded by derived classes. The default implementation updates the geometry and repaints the widget.

void QwtScaleWidget::scaleDivChanged () [signal]

Signal emitted, whenever the scale divison changes.

const QwtScaleDraw * QwtScaleWidget::scaleDraw () const scaleDraw of this scale

See also:

setScaleDraw(), QwtScaleDraw::setScaleDraw()

QwtScaleDraw * QwtScaleWidget::scaleDraw () scaleDraw of this scale

See also:


void QwtScaleWidget::setAlignment (QwtScaleDraw::Alignmentalignment) Change the alignment


alignment New alignment

See also:


void QwtScaleWidget::setBorderDist (intdist1, intdist2) Specify distances of the scale's endpoints from the widget's borders. The actual borders will never be less than minimum border distance.


dist1 Left or top Distance
dist2 Right or bottom distance

See also:


void QwtScaleWidget::setLabelAlignment (Qt::Alignmentalignment)

Change the alignment for the labels. See also:

QwtScaleDraw::setLabelAlignment(), setLabelRotation()

void QwtScaleWidget::setLabelRotation (doublerotation)

Change the rotation for the labels. See QwtScaleDraw::setLabelRotation(). Parameters:

rotation Rotation

See also:

QwtScaleDraw::setLabelRotation(), setLabelFlags()

void QwtScaleWidget::setMargin (intmargin)

Specify the margin to the colorBar/base line. Parameters:

margin Margin

See also:


void QwtScaleWidget::setMinBorderDist (intstart, intend) Set a minimum value for the distances of the scale's endpoints from the widget borders. This is useful to avoid that the scales are 'jumping', when the tick labels or their positions change often.


start Minimum for the start border
end Minimum for the end border

See also:

getMinBorderDist(), getBorderDistHint()

void QwtScaleWidget::setPenWidth (intwidth)

Specify the width of the scale pen. Parameters:

width Pen width

See also:


void QwtScaleWidget::setScaleDiv (QwtScaleTransformation *transformation, const QwtScaleDiv &scaleDiv)

Assign a scale division. The scale division determines where to set the tick marks.


transformation Transformation, needed to translate between scale and pixal values
scaleDiv Scale Division

See also:

For more information about scale divisions, see QwtScaleDiv.

void QwtScaleWidget::setScaleDraw (QwtScaleDraw *sd) Set a scale draw sd has to be created with new and will be deleted in ~QwtScaleWidget() or the next call of setScaleDraw().


sd ScaleDraw object

See also:


void QwtScaleWidget::setSpacing (intspacing)

Specify the distance between color bar, scale and title. Parameters:

spacing Spacing

See also:


void QwtScaleWidget::setTitle (const QString &title) Give title new text contents


title New title

See also:

title(), setTitle(const QwtText &);

void QwtScaleWidget::setTitle (const QwtText &title) Give title new text contents


title New title

See also:



The title flags are interpreted in direction of the label, AlignTop, AlignBottom can't be set as the title will always be aligned to the scale.

QSize QwtScaleWidget::sizeHint () const [virtual] Returns

a size hint

int QwtScaleWidget::spacing () const Returns

distance between scale and title

See also:


int QwtScaleWidget::startBorderDist () const Returns

start border distance

See also:


QwtText QwtScaleWidget::title () const Returns


See also:


int QwtScaleWidget::titleHeightForWidth (intwidth) const

Find the height of the title for a given width. Parameters:

width Width


height Height


Generated automatically by Doxygen for Qwt User's Guide from the source code.


Qwt User's Guide Version 5.2.2 Mon Aug 1 2011