Classes | Public Types | Public Slots | Signals | Public Member Functions | Protected Member Functions | Static Protected Member Functions | Properties | Private Slots | Private Member Functions | Private Attributes | Friends | List of all members
QwtPlot Class Reference

A 2-D plotting widget. More...

#include <qwt_plot.h>

Inheritance diagram for QwtPlot:
Inheritance graph
[legend]

Classes

class  AxisData
 
class  PrivateData
 

Public Types

enum  Axis {
  yLeft, yRight, xBottom, xTop,
  axisCnt
}
 Axis index. More...
 
enum  LegendPosition { LeftLegend, RightLegend, BottomLegend, TopLegend }
 

Public Slots

void autoRefresh ()
 Replots the plot if autoReplot() is true. More...
 
virtual void replot ()
 Redraw the plot. More...
 

Signals

void itemAttached (QwtPlotItem *plotItem, bool on)
 
void legendDataChanged (const QVariant &itemInfo, const QList< QwtLegendData > &data)
 

Public Member Functions

void applyProperties (const QString &)
 
bool autoReplot () const
 
bool axisAutoScale (int axisId) const
 
bool axisEnabled (int axisId) const
 
QFont axisFont (int axisId) const
 
QwtInterval axisInterval (int axisId) const
 Return the current interval of the specified axis. More...
 
int axisMaxMajor (int axisId) const
 
int axisMaxMinor (int axisId) const
 
const QwtScaleDivaxisScaleDiv (int axisId) const
 Return the scale division of a specified axis. More...
 
const QwtScaleDrawaxisScaleDraw (int axisId) const
 Return the scale draw of a specified axis. More...
 
QwtScaleDrawaxisScaleDraw (int axisId)
 Return the scale draw of a specified axis. More...
 
QwtScaleEngineaxisScaleEngine (int axisId)
 
const QwtScaleEngineaxisScaleEngine (int axisId) const
 
double axisStepSize (int axisId) const
 Return the step size parameter that has been set in setAxisScale. More...
 
QwtText axisTitle (int axisId) const
 
const QwtScaleWidgetaxisWidget (int axisId) const
 
QwtScaleWidgetaxisWidget (int axisId)
 
QWidget * canvas ()
 
const QWidget * canvas () const
 
QBrush canvasBackground () const
 
virtual QwtScaleMap canvasMap (int axisId) const
 
virtual void drawCanvas (QPainter *)
 
virtual void drawItems (QPainter *, const QRectF &, const QwtScaleMap maps[axisCnt]) const
 
void enableAxis (int axisId, bool tf=true)
 Enable or disable a specified axis. More...
 
virtual bool event (QEvent *)
 Adds handling of layout requests. More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Event filter. More...
 
QwtText footer () const
 
QwtTextLabelfooterLabel ()
 
const QwtTextLabelfooterLabel () const
 
virtual void getCanvasMarginsHint (const QwtScaleMap maps[], const QRectF &canvasRect, double &left, double &top, double &right, double &bottom) const
 Calculate the canvas margins. More...
 
QString grabProperties () const
 
virtual QwtPlotIteminfoToItem (const QVariant &) const
 Identify the plot item according to an item info object, that has bee generated from itemToInfo(). More...
 
void insertLegend (QwtAbstractLegend *, LegendPosition=QwtPlot::RightLegend, double ratio=-1.0)
 Insert a legend. More...
 
double invTransform (int axisId, int pos) const
 
virtual QVariant itemToInfo (QwtPlotItem *) const
 Build an information, that can be used to identify a plot item on the legend. More...
 
QwtAbstractLegendlegend ()
 
const QwtAbstractLegendlegend () const
 
virtual QSize minimumSizeHint () const
 Return a minimum size hint. More...
 
QwtPlotLayoutplotLayout ()
 
const QwtPlotLayoutplotLayout () const
 
 QwtPlot (QWidget *=NULL)
 Constructor. More...
 
 QwtPlot (const QwtText &title, QWidget *=NULL)
 Constructor. More...
 
void setAutoReplot (bool=true)
 Set or reset the autoReplot option. More...
 
void setAxisAutoScale (int axisId, bool on=true)
 Enable autoscaling for a specified axis. More...
 
void setAxisFont (int axisId, const QFont &f)
 Change the font of an axis. More...
 
void setAxisLabelAlignment (int axisId, Qt::Alignment)
 
void setAxisLabelRotation (int axisId, double rotation)
 
void setAxisMaxMajor (int axisId, int maxMajor)
 
void setAxisMaxMinor (int axisId, int maxMinor)
 
void setAxisScale (int axisId, double min, double max, double step=0)
 Disable autoscaling and specify a fixed scale for a selected axis. More...
 
void setAxisScaleDiv (int axisId, const QwtScaleDiv &)
 Disable autoscaling and specify a fixed scale for a selected axis. More...
 
void setAxisScaleDraw (int axisId, QwtScaleDraw *)
 Set a scale draw. More...
 
void setAxisScaleEngine (int axisId, QwtScaleEngine *)
 
void setAxisTitle (int axisId, const QString &)
 Change the title of a specified axis. More...
 
void setAxisTitle (int axisId, const QwtText &)
 Change the title of a specified axis. More...
 
void setCanvas (QWidget *)
 Set the drawing canvas of the plot widget. More...
 
void setCanvasBackground (const QBrush &)
 Change the background of the plotting area. More...
 
void setFooter (const QString &)
 
void setFooter (const QwtText &t)
 
void setPlotLayout (QwtPlotLayout *)
 Assign a new plot layout. More...
 
void setTitle (const QString &)
 
void setTitle (const QwtText &t)
 
virtual QSize sizeHint () const
 
QwtText title () const
 
QwtTextLabeltitleLabel ()
 
const QwtTextLabeltitleLabel () const
 
double transform (int axisId, double value) const
 Transform a value into a coordinate in the plotting region. More...
 
void updateAxes ()
 Rebuild the axes scales. More...
 
void updateCanvasMargins ()
 Update the canvas margins. More...
 
virtual void updateLayout ()
 Adjust plot content to its current size. More...
 
void updateLegend ()
 
void updateLegend (const QwtPlotItem *)
 
virtual ~QwtPlot ()
 Destructor. More...
 
- Public Member Functions inherited from QwtPlotDict
bool autoDelete () const
 
void detachItems (int rtti=QwtPlotItem::Rtti_PlotItem, bool autoDelete=true)
 
const QwtPlotItemListitemList () const
 A QwtPlotItemList of all attached plot items. More...
 
QwtPlotItemList itemList (int rtti) const
 
 QwtPlotDict ()
 
void setAutoDelete (bool)
 
virtual ~QwtPlotDict ()
 

Protected Member Functions

virtual void resizeEvent (QResizeEvent *e)
 
- Protected Member Functions inherited from QwtPlotDict
void insertItem (QwtPlotItem *)
 
void removeItem (QwtPlotItem *)
 

Static Protected Member Functions

static bool axisValid (int axisId)
 

Properties

bool autoReplot
 
QBrush canvasBackground
 

Private Slots

void updateLegendItems (const QVariant &itemInfo, const QList< QwtLegendData > &data)
 Update all plot items interested in legend attributes. More...
 

Private Member Functions

void attachItem (QwtPlotItem *, bool)
 Attach/Detach a plot item. More...
 
void deleteAxesData ()
 
void initAxesData ()
 Initialize axes. More...
 
void initPlot (const QwtText &title)
 Initializes a QwtPlot instance. More...
 
void updateScaleDiv ()
 

Private Attributes

AxisDatad_axisData [axisCnt]
 
PrivateDatad_data
 

Friends

class QwtPlotItem
 

Detailed Description

A 2-D plotting widget.

QwtPlot is a widget for plotting two-dimensional graphs. An unlimited number of plot items can be displayed on its canvas. Plot items might be curves (QwtPlotCurve), markers (QwtPlotMarker), the grid (QwtPlotGrid), or anything else derived from QwtPlotItem. A plot can have up to four axes, with each plot item attached to an x- and a y axis. The scales at the axes can be explicitly set (QwtScaleDiv), or are calculated from the plot items, using algorithms (QwtScaleEngine) which can be configured separately for each axis.

The simpleplot example is a good starting point to see how to set up a plot widget.

plot.png
Example
The following example shows (schematically) the most simple way to use QwtPlot. By default, only the left and bottom axes are visible and their scales are computed automatically.
#include <qwt_plot.h>
#include <qwt_plot_curve.h>

QwtPlot *myPlot = new QwtPlot("Two Curves", parent);

// add curves
QwtPlotCurve *curve1 = new QwtPlotCurve("Curve 1");
QwtPlotCurve *curve2 = new QwtPlotCurve("Curve 2");

// connect or copy the data to the curves
curve1->setData(...);
curve2->setData(...);

curve1->attach(myPlot);
curve2->attach(myPlot);

// finally, refresh the plot
myPlot->replot();

Definition at line 74 of file qwt_plot.h.

Member Enumeration Documentation

Axis index.

Enumerator
yLeft 

Y axis left of the canvas.

yRight 

Y axis right of the canvas.

xBottom 

X axis below the canvas.

xTop 

X axis above the canvas.

axisCnt 

Number of axes.

Definition at line 93 of file qwt_plot.h.

Position of the legend, relative to the canvas.

See also
insertLegend()
Enumerator
LeftLegend 

The legend will be left from the QwtPlot::yLeft axis.

RightLegend 

The legend will be right from the QwtPlot::yRight axis.

BottomLegend 

The legend will be below the footer.

TopLegend 

The legend will be above the title.

Definition at line 116 of file qwt_plot.h.

Constructor & Destructor Documentation

QwtPlot::QwtPlot ( QWidget *  parent = NULL)
explicit

Constructor.

Parameters
parentParent widget

Definition at line 110 of file qwt_plot.cpp.

QwtPlot::QwtPlot ( const QwtText title,
QWidget *  parent = NULL 
)
explicit

Constructor.

Parameters
titleTitle text
parentParent widget

Definition at line 121 of file qwt_plot.cpp.

QwtPlot::~QwtPlot ( )
virtual

Destructor.

Definition at line 128 of file qwt_plot.cpp.

Member Function Documentation

void QwtPlot::applyProperties ( const QString &  )

This method is intended for manipulating the plot widget from a specific editor in the Qwt designer plugin.

Warning
The plot editor has never been implemented.

Definition at line 18 of file qwt_plot_xml.cpp.

void QwtPlot::attachItem ( QwtPlotItem plotItem,
bool  on 
)
private

Attach/Detach a plot item.

Parameters
plotItemPlot item
onWhen true attach the item, otherwise detach it

Definition at line 1079 of file qwt_plot.cpp.

void QwtPlot::autoRefresh ( )
slot

Replots the plot if autoReplot() is true.

Definition at line 293 of file qwt_plot.cpp.

bool QwtPlot::autoReplot ( ) const
bool QwtPlot::axisAutoScale ( int  axisId) const
Returns
True, if autoscaling is enabled
Parameters
axisIdAxis index

Definition at line 186 of file qwt_plot_axis.cpp.

bool QwtPlot::axisEnabled ( int  axisId) const
Returns
True, if a specified axis is enabled
Parameters
axisIdAxis index

Definition at line 198 of file qwt_plot_axis.cpp.

QFont QwtPlot::axisFont ( int  axisId) const
Returns
The font of the scale labels for a specified axis
Parameters
axisIdAxis index

Definition at line 210 of file qwt_plot_axis.cpp.

QwtInterval QwtPlot::axisInterval ( int  axisId) const

Return the current interval of the specified axis.

This is only a convenience function for axisScaleDiv( axisId )->interval();

Parameters
axisIdAxis index
Returns
Scale interval
See also
QwtScaleDiv, axisScaleDiv()

Definition at line 317 of file qwt_plot_axis.cpp.

int QwtPlot::axisMaxMajor ( int  axisId) const
Returns
The maximum number of major ticks for a specified axis
Parameters
axisIdAxis index
See also
setAxisMaxMajor(), QwtScaleEngine::divideScale()

Definition at line 224 of file qwt_plot_axis.cpp.

int QwtPlot::axisMaxMinor ( int  axisId) const
Returns
the maximum number of minor ticks for a specified axis
Parameters
axisIdAxis index
See also
setAxisMaxMinor(), QwtScaleEngine::divideScale()

Definition at line 237 of file qwt_plot_axis.cpp.

const QwtScaleDiv & QwtPlot::axisScaleDiv ( int  axisId) const

Return the scale division of a specified axis.

axisScaleDiv(axisId).lowerBound(), axisScaleDiv(axisId).upperBound() are the current limits of the axis scale.

Parameters
axisIdAxis index
Returns
Scale division
See also
QwtScaleDiv, setAxisScaleDiv(), QwtScaleEngine::divideScale()

Definition at line 256 of file qwt_plot_axis.cpp.

const QwtScaleDraw * QwtPlot::axisScaleDraw ( int  axisId) const

Return the scale draw of a specified axis.

Parameters
axisIdAxis index
Returns
Specified scaleDraw for axis, or NULL if axis is invalid.

Definition at line 267 of file qwt_plot_axis.cpp.

QwtScaleDraw * QwtPlot::axisScaleDraw ( int  axisId)

Return the scale draw of a specified axis.

Parameters
axisIdAxis index
Returns
Specified scaleDraw for axis, or NULL if axis is invalid.

Definition at line 281 of file qwt_plot_axis.cpp.

QwtScaleEngine * QwtPlot::axisScaleEngine ( int  axisId)
Parameters
axisIdAxis index
Returns
Scale engine for a specific axis

Definition at line 163 of file qwt_plot_axis.cpp.

const QwtScaleEngine * QwtPlot::axisScaleEngine ( int  axisId) const
Parameters
axisIdAxis index
Returns
Scale engine for a specific axis

Definition at line 175 of file qwt_plot_axis.cpp.

double QwtPlot::axisStepSize ( int  axisId) const

Return the step size parameter that has been set in setAxisScale.

This doesn't need to be the step size of the current scale.

Parameters
axisIdAxis index
Returns
step size parameter value
See also
setAxisScale(), QwtScaleEngine::divideScale()

Definition at line 299 of file qwt_plot_axis.cpp.

QwtText QwtPlot::axisTitle ( int  axisId) const
Returns
Title of a specified axis
Parameters
axisIdAxis index

Definition at line 329 of file qwt_plot_axis.cpp.

bool QwtPlot::axisValid ( int  axisId)
staticprotected
Returns
true if the specified axis exists, otherwise false
Parameters
axisIdaxis index

Definition at line 886 of file qwt_plot.cpp.

const QwtScaleWidget * QwtPlot::axisWidget ( int  axisId) const
Returns
Scale widget of the specified axis, or NULL if axisId is invalid.
Parameters
axisIdAxis index

Definition at line 113 of file qwt_plot_axis.cpp.

QwtScaleWidget * QwtPlot::axisWidget ( int  axisId)
Returns
Scale widget of the specified axis, or NULL if axisId is invalid.
Parameters
axisIdAxis index

Definition at line 125 of file qwt_plot_axis.cpp.

QWidget * QwtPlot::canvas ( )
Returns
the plot's canvas

Definition at line 467 of file qwt_plot.cpp.

const QWidget * QwtPlot::canvas ( ) const
Returns
the plot's canvas

Definition at line 475 of file qwt_plot.cpp.

QBrush QwtPlot::canvasBackground ( ) const
QwtScaleMap QwtPlot::canvasMap ( int  axisId) const
virtual
Parameters
axisIdAxis
Returns
Map for the axis on the canvas. With this map pixel coordinates can translated to plot coordinates and vice versa.
See also
QwtScaleMap, transform(), invTransform()

Definition at line 790 of file qwt_plot.cpp.

void QwtPlot::deleteAxesData ( )
private

Definition at line 99 of file qwt_plot_axis.cpp.

void QwtPlot::drawCanvas ( QPainter *  painter)
virtual

Redraw the canvas.

Parameters
painterPainter used for drawing
Warning
drawCanvas calls drawItems what is also used for printing. Applications that like to add individual plot items better overload drawItems()
See also
drawItems()

Definition at line 735 of file qwt_plot.cpp.

void QwtPlot::drawItems ( QPainter *  painter,
const QRectF &  canvasRect,
const QwtScaleMap  maps[axisCnt] 
) const
virtual

Redraw the canvas items.

Parameters
painterPainter used for drawing
canvasRectBounding rectangle where to paint
mapsQwtPlot::axisCnt maps, mapping between plot and paint device coordinates
Note
Usually canvasRect is contentsRect() of the plot canvas. Due to a bug in Qt this rectangle might be wrong for certain frame styles ( f.e QFrame::Box ) and it might be necessary to fix the margins manually using QWidget::setContentsMargins()

Definition at line 757 of file qwt_plot.cpp.

void QwtPlot::enableAxis ( int  axisId,
bool  tf = true 
)

Enable or disable a specified axis.

When an axis is disabled, this only means that it is not visible on the screen. Curves, markers and can be attached to disabled axes, and transformation of screen coordinates into values works as normal.

Only xBottom and yLeft are enabled by default.

Parameters
axisIdAxis index
tftrue (enabled) or false (disabled)

Definition at line 350 of file qwt_plot_axis.cpp.

bool QwtPlot::event ( QEvent *  event)
virtual

Adds handling of layout requests.

Parameters
eventEvent
Returns
See QFrame::event()

Definition at line 241 of file qwt_plot.cpp.

bool QwtPlot::eventFilter ( QObject *  object,
QEvent *  event 
)
virtual

Event filter.

The plot handles the following events for the canvas:

  • QEvent::Resize The canvas margins might depend on its size
  • QEvent::ContentsRectChange The layout needs to be recalculated
Parameters
objectObject to be filtered
eventEvent
Returns
See QFrame::eventFilter()
See also
updateCanvasMargins(), updateLayout()

Reimplemented in PlotWidget.

Definition at line 275 of file qwt_plot.cpp.

QwtText QwtPlot::footer ( ) const
Returns
Text of the footer

Definition at line 399 of file qwt_plot.cpp.

QwtTextLabel * QwtPlot::footerLabel ( )
Returns
Footer label widget.

Definition at line 405 of file qwt_plot.cpp.

const QwtTextLabel * QwtPlot::footerLabel ( ) const
Returns
Footer label widget.

Definition at line 411 of file qwt_plot.cpp.

void QwtPlot::getCanvasMarginsHint ( const QwtScaleMap  maps[],
const QRectF &  canvasRect,
double &  left,
double &  top,
double &  right,
double &  bottom 
) const
virtual

Calculate the canvas margins.

Parameters
mapsQwtPlot::axisCnt maps, mapping between plot and paint device coordinates
canvasRectBounding rectangle where to paint
leftReturn parameter for the left margin
topReturn parameter for the top margin
rightReturn parameter for the right margin
bottomReturn parameter for the bottom margin

Plot items might indicate, that they need some extra space at the borders of the canvas by the QwtPlotItem::Margins flag.

updateCanvasMargins(), QwtPlotItem::getCanvasMarginHint()

Definition at line 667 of file qwt_plot.cpp.

QString QwtPlot::grabProperties ( ) const

This method is intended for manipulating the plot widget from a specific editor in the Qwt designer plugin.

Returns
QString()
Warning
The plot editor has never been implemented.

Definition at line 34 of file qwt_plot_xml.cpp.

QwtPlotItem * QwtPlot::infoToItem ( const QVariant &  itemInfo) const
virtual

Identify the plot item according to an item info object, that has bee generated from itemToInfo().

The default implementation simply tries to unwrap a QwtPlotItem pointer:

if ( itemInfo.canConvert<QwtPlotItem *>() )
return qvariant_cast<QwtPlotItem *>( itemInfo );
Parameters
itemInfoPlot item
Returns
A plot item, when successful, otherwise a NULL pointer.
See also
itemToInfo()

Definition at line 1165 of file qwt_plot.cpp.

void QwtPlot::initAxesData ( )
private

Initialize axes.

Definition at line 37 of file qwt_plot_axis.cpp.

void QwtPlot::initPlot ( const QwtText title)
private

Initializes a QwtPlot instance.

Parameters
titleTitle text

Definition at line 142 of file qwt_plot.cpp.

void QwtPlot::insertLegend ( QwtAbstractLegend legend,
QwtPlot::LegendPosition  pos = QwtPlot::RightLegend,
double  ratio = -1.0 
)

Insert a legend.

If the position legend is QwtPlot::LeftLegend or QwtPlot::RightLegend the legend will be organized in one column from top to down. Otherwise the legend items will be placed in a table with a best fit number of columns from left to right.

insertLegend() will set the plot widget as parent for the legend. The legend will be deleted in the destructor of the plot or when another legend is inserted.

Legends, that are not inserted into the layout of the plot widget need to connect to the legendDataChanged() signal. Calling updateLegend() initiates this signal for an initial update. When the application code wants to implement its own layout this also needs to be done for rendering plots to a document ( see QwtPlotRenderer ).

Parameters
legendLegend
posThe legend's position. For top/left position the number of columns will be limited to 1, otherwise it will be set to unlimited.
ratioRatio between legend and the bounding rectangle of title, canvas and axes. The legend will be shrunk if it would need more space than the given ratio. The ratio is limited to ]0.0 .. 1.0]. In case of <= 0.0 it will be reset to the default ratio. The default vertical/horizontal ratio is 0.33/0.5.
See also
legend(), QwtPlotLayout::legendPosition(), QwtPlotLayout::setLegendPosition()

Definition at line 924 of file qwt_plot.cpp.

double QwtPlot::invTransform ( int  axisId,
int  pos 
) const

Transform the x or y coordinate of a position in the drawing region into a value.

Parameters
axisIdAxis index
posposition
Returns
Position as axis coordinate
Warning
The position can be an x or a y coordinate, depending on the specified axis.

Definition at line 371 of file qwt_plot_axis.cpp.

void QwtPlot::itemAttached ( QwtPlotItem plotItem,
bool  on 
)
signal

A signal indicating, that an item has been attached/detached

Parameters
plotItemPlot item
onAttached/Detached
QVariant QwtPlot::itemToInfo ( QwtPlotItem plotItem) const
virtual

Build an information, that can be used to identify a plot item on the legend.

The default implementation simply wraps the plot item into a QVariant object. When overloading itemToInfo() usually infoToItem() needs to reimplemeted too.

QVariant itemInfo;
qVariantSetValue( itemInfo, plotItem );
Parameters
plotItemPlot item
Returns
Plot item embedded in a QVariant
See also
infoToItem()

Definition at line 1142 of file qwt_plot.cpp.

QwtAbstractLegend * QwtPlot::legend ( )
Returns
the plot's legend
See also
insertLegend()

Definition at line 449 of file qwt_plot.cpp.

const QwtAbstractLegend * QwtPlot::legend ( ) const
Returns
the plot's legend
See also
insertLegend()

Definition at line 458 of file qwt_plot.cpp.

void QwtPlot::legendDataChanged ( const QVariant &  itemInfo,
const QList< QwtLegendData > &  data 
)
signal

A signal with the attributes how to update the legend entries for a plot item.

Parameters
itemInfoInfo about a plot item, build from itemToInfo()
dataAttributes of the entries ( usually <= 1 ) for the plot item.
See also
itemToInfo(), infoToItem(), QwtAbstractLegend::updateLegend()
QSize QwtPlot::minimumSizeHint ( ) const
virtual

Return a minimum size hint.

Definition at line 519 of file qwt_plot.cpp.

QwtPlotLayout * QwtPlot::plotLayout ( )
Returns
the plot's layout

Definition at line 434 of file qwt_plot.cpp.

const QwtPlotLayout * QwtPlot::plotLayout ( ) const
Returns
the plot's layout

Definition at line 440 of file qwt_plot.cpp.

void QwtPlot::replot ( )
virtualslot

Redraw the plot.

If the autoReplot option is not set (which is the default) or if any curves are attached to raw data, the plot has to be refreshed explicitly in order to make changes visible.

See also
updateAxes(), setAutoReplot()

Definition at line 546 of file qwt_plot.cpp.

void QwtPlot::resizeEvent ( QResizeEvent *  e)
protectedvirtual

Resize and update internal layout

Parameters
eResize event

Reimplemented in PlotWidget.

Definition at line 531 of file qwt_plot.cpp.

void QwtPlot::setAutoReplot ( bool  tf = true)

Set or reset the autoReplot option.

If the autoReplot option is set, the plot will be updated implicitly by manipulating member functions. Since this may be time-consuming, it is recommended to leave this option switched off and call replot() explicitly if necessary.

The autoReplot option is set to false by default, which means that the user has to call replot() in order to make changes visible.

Parameters
tftrue or false. Defaults to true.
See also
replot()

Definition at line 314 of file qwt_plot.cpp.

void QwtPlot::setAxisAutoScale ( int  axisId,
bool  on = true 
)

Enable autoscaling for a specified axis.

This member function is used to switch back to autoscaling mode after a fixed scale has been set. Autoscaling is enabled by default.

Parameters
axisIdAxis index
onOn/Off
See also
setAxisScale(), setAxisScaleDiv(), updateAxes()
Note
The autoscaling flag has no effect until updateAxes() is executed ( called by replot() ).

Definition at line 423 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisFont ( int  axisId,
const QFont &  font 
)

Change the font of an axis.

Parameters
axisIdAxis index
fontFont
Warning
This function changes the font of the tick labels, not of the axis title.

Definition at line 404 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisLabelAlignment ( int  axisId,
Qt::Alignment  alignment 
)

Change the alignment of the tick labels

Parameters
axisIdAxis index
alignmentOr'd Qt::AlignmentFlags see <qnamespace.h>
See also
QwtScaleDraw::setLabelAlignment()

Definition at line 523 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisLabelRotation ( int  axisId,
double  rotation 
)

Rotate all tick labels

Parameters
axisIdAxis index
rotationAngle in degrees. When changing the label rotation, the label alignment might be adjusted too.
See also
QwtScaleDraw::setLabelRotation(), setAxisLabelAlignment()

Definition at line 538 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisMaxMajor ( int  axisId,
int  maxMajor 
)

Set the maximum number of major scale intervals for a specified axis

Parameters
axisIdAxis index
maxMajorMaximum number of major steps
See also
axisMaxMajor()

Definition at line 576 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisMaxMinor ( int  axisId,
int  maxMinor 
)

Set the maximum number of minor scale intervals for a specified axis

Parameters
axisIdAxis index
maxMinorMaximum number of minor steps
See also
axisMaxMinor()

Definition at line 552 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisScale ( int  axisId,
double  min,
double  max,
double  stepSize = 0 
)

Disable autoscaling and specify a fixed scale for a selected axis.

In updateAxes() the scale engine calculates a scale division from the specified parameters, that will be assigned to the scale widget. So updates of the scale widget usually happen delayed with the next replot.

Parameters
axisIdAxis index
minMinimum of the scale
maxMaximum of the scale
stepSizeMajor step size. If step == 0, the step size is calculated automatically using the maxMajor setting.
See also
setAxisMaxMajor(), setAxisAutoScale(), axisStepSize(), QwtScaleEngine::divideScale()

Definition at line 447 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisScaleDiv ( int  axisId,
const QwtScaleDiv scaleDiv 
)

Disable autoscaling and specify a fixed scale for a selected axis.

The scale division will be stored locally only until the next call of updateAxes(). So updates of the scale widget usually happen delayed with the next replot.

Parameters
axisIdAxis index
scaleDivScale division
See also
setAxisScale(), setAxisAutoScale()

Definition at line 476 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisScaleDraw ( int  axisId,
QwtScaleDraw scaleDraw 
)

Set a scale draw.

Parameters
axisIdAxis index
scaleDrawObject responsible for drawing scales.

By passing scaleDraw it is possible to extend QwtScaleDraw functionality and let it take place in QwtPlot. Please note that scaleDraw has to be created with new and will be deleted by the corresponding QwtScale member ( like a child object ).

See also
QwtScaleDraw, QwtScaleWidget
Warning
The attributes of scaleDraw will be overwritten by those of the previous QwtScaleDraw.

Definition at line 506 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisScaleEngine ( int  axisId,
QwtScaleEngine scaleEngine 
)

Change the scale engine for an axis

Parameters
axisIdAxis index
scaleEngineScale engine
See also
axisScaleEngine()

Definition at line 141 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisTitle ( int  axisId,
const QString &  title 
)

Change the title of a specified axis.

Parameters
axisIdAxis index
titleaxis title

Definition at line 598 of file qwt_plot_axis.cpp.

void QwtPlot::setAxisTitle ( int  axisId,
const QwtText title 
)

Change the title of a specified axis.

Parameters
axisIdAxis index
titleAxis title

Definition at line 610 of file qwt_plot_axis.cpp.

void QwtPlot::setCanvas ( QWidget *  canvas)

Set the drawing canvas of the plot widget.

QwtPlot invokes methods of the canvas as meta methods ( see QMetaObject ). In opposite to using conventional C++ techniques like virtual methods they allow to use canvas implementations that are derived from QWidget or QGLWidget.

The following meta methods could be implemented:

  • replot() When the canvas doesn't offer a replot method, QwtPlot calls update() instead.
  • borderPath() The border path is necessary to clip the content of the canvas When the canvas doesn't have any special border ( f.e rounded corners ) it is o.k. not to implement this method.

The default canvas is a QwtPlotCanvas

Parameters
canvasCanvas Widget
See also
canvas()

Definition at line 217 of file qwt_plot.cpp.

void QwtPlot::setCanvasBackground ( const QBrush &  brush)

Change the background of the plotting area.

Sets brush to QPalette::Window of all color groups of the palette of the canvas. Using canvas()->setPalette() is a more powerful way to set these colors.

Parameters
brushNew background brush
See also
canvasBackground()

Definition at line 861 of file qwt_plot.cpp.

void QwtPlot::setFooter ( const QString &  text)

Change the text the footer

Parameters
textNew text of the footer

Definition at line 376 of file qwt_plot.cpp.

void QwtPlot::setFooter ( const QwtText text)

Change the text the footer

Parameters
textNew text of the footer

Definition at line 389 of file qwt_plot.cpp.

void QwtPlot::setPlotLayout ( QwtPlotLayout layout)

Assign a new plot layout.

Parameters
layoutLayout()
See also
plotLayout()

Definition at line 422 of file qwt_plot.cpp.

void QwtPlot::setTitle ( const QString &  title)

Change the plot's title

Parameters
titleNew title

Definition at line 332 of file qwt_plot.cpp.

void QwtPlot::setTitle ( const QwtText title)

Change the plot's title

Parameters
titleNew title

Definition at line 345 of file qwt_plot.cpp.

QSize QwtPlot::sizeHint ( ) const
virtual
Returns
Size hint for the plot widget
See also
minimumSizeHint()

Definition at line 484 of file qwt_plot.cpp.

QwtText QwtPlot::title ( ) const
Returns
Title of the plot

Definition at line 355 of file qwt_plot.cpp.

QwtTextLabel * QwtPlot::titleLabel ( )
Returns
Title label widget.

Definition at line 361 of file qwt_plot.cpp.

const QwtTextLabel * QwtPlot::titleLabel ( ) const
Returns
Title label widget.

Definition at line 367 of file qwt_plot.cpp.

double QwtPlot::transform ( int  axisId,
double  value 
) const

Transform a value into a coordinate in the plotting region.

Parameters
axisIdAxis index
valuevalue
Returns
X or Y coordinate in the plotting region corresponding to the value.

Definition at line 388 of file qwt_plot_axis.cpp.

void QwtPlot::updateAxes ( )

Rebuild the axes scales.

In case of autoscaling the boundaries of a scale are calculated from the bounding rectangles of all plot items, having the QwtPlotItem::AutoScale flag enabled ( QwtScaleEngine::autoScale() ). Then a scale division is calculated ( QwtScaleEngine::didvideScale() ) and assigned to scale widget.

When the scale boundaries have been assigned with setAxisScale() a scale division is calculated ( QwtScaleEngine::didvideScale() ) for this interval and assigned to the scale widget.

When the scale has been set explicitly by setAxisScaleDiv() the locally stored scale division gets assigned to the scale widget.

The scale widget indicates modifications by emitting a QwtScaleWidget::scaleDivChanged() signal.

updateAxes() is usually called by replot().

See also
setAxisAutoScale(), setAxisScale(), setAxisScaleDiv(), replot() QwtPlotItem::boundingRect()

Definition at line 640 of file qwt_plot_axis.cpp.

void QwtPlot::updateCanvasMargins ( )

Update the canvas margins.

Plot items might indicate, that they need some extra space at the borders of the canvas by the QwtPlotItem::Margins flag.

getCanvasMarginsHint(), QwtPlotItem::getCanvasMarginHint()

Definition at line 701 of file qwt_plot.cpp.

void QwtPlot::updateLayout ( )
virtual

Adjust plot content to its current size.

See also
resizeEvent()

Reimplemented in PlotWidget.

Definition at line 578 of file qwt_plot.cpp.

void QwtPlot::updateLegend ( )

Emit legendDataChanged() for all plot item

See also
QwtPlotItem::legendData(), legendDataChanged()

Definition at line 1014 of file qwt_plot.cpp.

void QwtPlot::updateLegend ( const QwtPlotItem plotItem)

Emit legendDataChanged() for a plot item

Parameters
plotItemPlot item
See also
QwtPlotItem::legendData(), legendDataChanged()

Definition at line 1030 of file qwt_plot.cpp.

void QwtPlot::updateLegendItems ( const QVariant &  itemInfo,
const QList< QwtLegendData > &  legendData 
)
privateslot

Update all plot items interested in legend attributes.

Call QwtPlotItem::updateLegend(), when the QwtPlotItem::LegendInterest flag is set.

Parameters
itemInfoInfo about the plot item
legendDataEntries to be displayed for the plot item ( usually 1 )
See also
QwtPlotItem::LegendInterest, QwtPlotLegendItem, QwtPlotItem::updateLegend()

Definition at line 1056 of file qwt_plot.cpp.

void QwtPlot::updateScaleDiv ( )
private

Friends And Related Function Documentation

friend class QwtPlotItem
friend

Definition at line 296 of file qwt_plot.h.

Member Data Documentation

AxisData* QwtPlot::d_axisData[axisCnt]
private

Definition at line 305 of file qwt_plot.h.

PrivateData* QwtPlot::d_data
private

Definition at line 308 of file qwt_plot.h.

Property Documentation

bool QwtPlot::autoReplot
readwrite
Returns
true if the autoReplot option is set.
See also
setAutoReplot()

Definition at line 80 of file qwt_plot.h.

QBrush QwtPlot::canvasBackground
readwrite

Nothing else than: canvas()->palette().brush( QPalette::Normal, QPalette::Window);

Returns
Background brush of the plotting area.
See also
setCanvasBackground()

Definition at line 79 of file qwt_plot.h.


The documentation for this class was generated from the following files:


plotjuggler
Author(s): Davide Faconti
autogenerated on Sat Jul 6 2019 03:44:18