QwtScaleWidget(3) Qwt User's Guide QwtScaleWidget(3)

QwtScaleWidget - A Widget which contains a scale.

#include <qwt_scale_widget.h>

Inherits QWidget.


enum LayoutFlag { TitleInverted = 1 }
Layout flags of the title. typedef QFlags< LayoutFlag > LayoutFlags
Layout flags of the title.


void scaleDivChanged ()
Signal emitted, whenever the scale division changes.


QwtScaleWidget (QWidget *parent=NULL)
Create a scale with the position QwtScaleWidget::Left. QwtScaleWidget (QwtScaleDraw::Alignment, QWidget *parent=NULL)
Constructor. virtual ~QwtScaleWidget ()
Destructor. void setTitle (const QString &title)
void setTitle (const QwtText &title)
QwtText title () const
void setLayoutFlag (LayoutFlag, bool on)
bool testLayoutFlag (LayoutFlag) const
void setBorderDist (int dist1, int dist2)
int startBorderDist () const
int endBorderDist () const
void getBorderDistHint (int &start, int &end) const
Calculate a hint for the border distances. void getMinBorderDist (int &start, int &end) const
void setMinBorderDist (int start, int end)
void setMargin (int)
Specify the margin to the colorBar/base line. int margin () const
void setSpacing (int)
Specify the distance between color bar, scale and title. int spacing () const
void setScaleDiv (const QwtScaleDiv &)
Assign a scale division. void setTransformation (QwtTransform *)
void setScaleDraw (QwtScaleDraw *)
const QwtScaleDraw * scaleDraw () const
QwtScaleDraw * scaleDraw ()
void setLabelAlignment (Qt::Alignment)
Change the alignment for the labels. void setLabelRotation (double rotation)
Change the rotation for the labels. See QwtScaleDraw::setLabelRotation(). void setColorBarEnabled (bool)
bool isColorBarEnabled () const
void setColorBarWidth (int)
int colorBarWidth () const
void setColorMap (const QwtInterval &, QwtColorMap *)
QwtInterval colorBarInterval () const
const QwtColorMap * colorMap () const
virtual QSize sizeHint () const
virtual QSize minimumSizeHint () const
int titleHeightForWidth (int width) const
Find the height of the title for a given width. int dimForLength (int length, 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. void drawColorBar (QPainter *painter, const QRectF &) const
void drawTitle (QPainter *painter, QwtScaleDraw::Alignment, const QRectF &rect) const
void setAlignment (QwtScaleDraw::Alignment)
QwtScaleDraw::Alignment alignment () const
QRectF colorBarRect (const QRectF &) const


virtual void paintEvent (QPaintEvent *)
paintEvent virtual void resizeEvent (QResizeEvent *)
void draw (QPainter *) const
draw the scale void scaleChange ()
Notify a change of the scale. void layoutScale (bool update_geometry=true)

A Widget which contains a scale.

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

Layout flags of the title.

Enumerator

The title of vertical scales is painted from top to bottom. Otherwise it is painted from bottom to top.

Create a scale with the position QwtScaleWidget::Left.

Parameters:

parent Parent widget

Constructor.

Parameters:

align Alignment.
parent Parent widget

QwtScaleDraw::Alignment QwtScaleWidget::alignment () const

Returns:

position

See also:

setPosition()

QwtInterval QwtScaleWidget::colorBarInterval () const

Returns:

Value interval for the color bar

See also:

setColorMap(), colorMap()

Calculate the the rectangle for the color bar

Parameters:

rect Bounding rectangle for all components of the scale

Returns:

Rectangle for the color bar

Returns:

Width of the color bar

See also:

setColorBarEnabled(), setColorBarEnabled()

const QwtColorMap * QwtScaleWidget::colorMap () const

Returns:

Color map

See also:

setColorMap(), colorBarInterval()

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

Returns:

height for horizontal, width for vertical scales

Draw the color bar of the scale widget

Parameters:

painter Painter
rect Bounding rectangle for the color bar

See also:

setColorBarEnabled()

Rotate and paint a title according to its position into a given rectangle.

Parameters:

painter Painter
align Alignment
rect Bounding rectangle

Returns:

end border distance

See also:

setBorderDist()

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.

Parameters:

start Return parameter for the border width at the beginning of the scale
end Return parameter for the border width at the end of the scale

Warning:

•
The minimum border distance depends on the font.

See also:

setMinBorderDist(), getMinBorderDist(), setBorderDist()

Get the minimum value for the distances of the scale's endpoints from the widget borders.

Parameters:

start Return parameter for the border width at the beginning of the scale
end Return parameter for the border width at the end of the scale

See also:

setMinBorderDist(), getBorderDistHint()

Returns:

true, when the color bar is enabled

See also:

setColorBarEnabled(), setColorBarWidth()

Recalculate the scale's geometry and layout based on the current geometry and fonts.

Parameters:

update_geometry Notify the layout system and call update to redraw the scale

Returns:

margin

See also:

setMargin()

Returns:

a minimum size hint

Event handler for resize events

Parameters:

event Resize event

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.

const QwtScaleDraw * QwtScaleWidget::scaleDraw () const

Returns:

scaleDraw of this scale

See also:

setScaleDraw(), QwtScaleDraw::setScaleDraw()

QwtScaleDraw * QwtScaleWidget::scaleDraw ()

Returns:

scaleDraw of this scale

See also:

QwtScaleDraw::setScaleDraw()

Change the alignment

Parameters:

alignment New alignment

See also:

alignment()

Specify distances of the scale's endpoints from the widget's borders. The actual borders will never be less than minimum border distance.

Parameters:

dist1 Left or top Distance
dist2 Right or bottom distance

See also:

borderDist()

En/disable a color bar associated to the scale

See also:

isColorBarEnabled(), setColorBarWidth()

Set the width of the color bar

Parameters:

width Width

See also:

colorBarWidth(), setColorBarEnabled()

Set the color map and value interval, that are used for displaying the color bar.

Parameters:

interval Value interval
colorMap Color map

See also:

colorMap(), colorBarInterval()

Change the alignment for the labels.

See also:

QwtScaleDraw::setLabelAlignment(), setLabelRotation()

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

Parameters:

rotation Rotation

See also:

QwtScaleDraw::setLabelRotation(), setLabelFlags()

Toggle an layout flag

Parameters:

flag Layout flag
on true/false

See also:

testLayoutFlag(), LayoutFlag

Specify the margin to the colorBar/base line.

Parameters:

margin Margin

See also:

margin()

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.

Parameters:

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

See also:

getMinBorderDist(), getBorderDistHint()

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

Parameters:

scaleDiv Scale Division

See also:

For more information about scale divisions, see QwtScaleDiv.

Set a scale draw

scaleDraw has to be created with new and will be deleted in ~QwtScaleWidget() or the next call of setScaleDraw(). scaleDraw will be initialized with the attributes of the previous scaleDraw object.

Parameters:

scaleDraw ScaleDraw object

See also:

scaleDraw()

Specify the distance between color bar, scale and title.

Parameters:

spacing Spacing

See also:

spacing()

Give title new text contents

Parameters:

title New title

See also:

title(), setTitle(const QwtText &);

Give title new text contents

Parameters:

title New title

See also:

title()

Warning:

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.

Set the transformation

Parameters:

transformation Transformation

See also:

QwtAbstractScaleDraw::scaleDraw(), QwtScaleMap

Returns:

a size hint

Returns:

distance between scale and title

See also:

setMargin()

Returns:

start border distance

See also:

setBorderDist()

Test a layout flag

Parameters:

flag Layout flag

Returns:

true/false

See also:

setLayoutFlag(), LayoutFlag

QwtText QwtScaleWidget::title () const

Returns:

title

See also:

setTitle()

Find the height of the title for a given width.

Parameters:

width Width

Returns:

height Height

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

Wed Jan 2 2019 Version 6.1.4