QwtPlot(3)

NAME
QwtPlot - A 2-D plotting widget.

SYNOPSIS

#include <qwt_plot.h>

  Public Types
enum Axis { yLeft, yRight, xBottom, xTop, axisCnt }

  Public Slots
virtual void replot ()

  Signals
void plotMousePressed (const QMouseEvent &e)
void plotMouseReleased (const QMouseEvent &e)
void plotMouseMoved (const QMouseEvent &e)
void legendClicked (long key)

  Public Methods
QwtPlot (QWidget *p=0, const char *name=0)
QwtPlot (const QString &title, QWidget *p=0, const char *name=0)
virtual ~QwtPlot ()
void setAutoReplot (bool tf=TRUE)
bool autoReplot () const
void print (QPaintDevice &p, const QwtPlotPrintFilter &=QwtPlotPrintFilter()) const
virtual void print (QPainter *, const QRect &rect, const QwtPlotPrintFilter &=QwtPlotPrintFilter()) const
void clear ()
void enableOutline (bool tf)
bool outlineEnabled () const
void setOutlineStyle (Qwt::Shape os)
Qwt::Shape outlineStyle () const
void setOutlinePen (const QPen &pn)
const QPen & outlinePen () const
void setMargin (int margin)
int margin () const
void setTitle (const QString &t)
QString title () const
void setTitleFont (const QFont &f)
QFont titleFont () const
QwtPlotCanvas * canvas ()
const QwtPlotCanvas * canvas () const
void setCanvasBackground (const QColor &c)
const QColor & canvasBackground () const
void setCanvasLineWidth (int w)
int canvasLineWidth () const
QwtDiMap canvasMap (int axis) const
double invTransform (int axis, int pos) const
int transform (int axis, double value) const
long insertCurve (QwtPlotCurve *)
long insertCurve (const QString &title, int xAxis=xBottom, int yAxis=yLeft)
QwtPlotCurve * curve (long key)
const QwtPlotCurve * curve (long key) const
bool removeCurve (long key)
void removeCurves ()
QArray< long > curveKeys () const
long closestCurve (int xpos, int ypos, int &dist) const
long closestCurve (int xpos, int ypos, int &dist, double &xval, double &yval, int &index) const
bool setCurveBaseline (long key, double ref)
double curveBaseline (long key) const
bool setCurveData (long key, double *x, double *y, int size)
bool setCurveRawData (long key, double *x, double *y, int size)
bool setCurveOptions (long key, int t)
int curveOptions (long key) const
bool setCurvePen (long key, const QPen &pen)
QPen curvePen (long key) const
bool setCurveSplineSize (long key, int s)
int curveSplineSize (long key) const
bool setCurveStyle (long key, int s, int options=0)
int curveStyle (long key) const
bool setCurveSymbol (long key, const QwtSymbol &s)
QwtSymbol curveSymbol (long key) const
bool setCurveTitle (long key, const QString &s)
QString curveTitle (long key) const
bool setCurveXAxis (long key, int axis)
int curveXAxis (long key) const
bool setCurveYAxis (long key, int axis)
int curveYAxis (long key) const
void enableGridX (bool tf=TRUE)
void enableGridXMin (bool tf=TRUE)
void enableGridY (bool tf=TRUE)
void enableGridYMin (bool tf=TRUE)
void setGridXAxis (int axis)
int gridXAxis () const
void setGridYAxis (int axis)
int gridYAxis () const
void setGridPen (const QPen &p)
void setGridMajPen (const QPen &p)
const QPen & gridMajPen () const
void setGridMinPen (const QPen &p)
const QPen & gridMinPen () const
void setAxisAutoScale (int axis)
bool axisAutoScale (int axis) const
void enableAxis (int axis, bool tf=TRUE)
bool axisEnabled (int axis) const
void changeAxisOptions (int axis, int opt, bool value)
void setAxisOptions (int axis, int opt)
int axisOptions (int axis) const
void setAxisFont (int axis, const QFont &f)
QFont axisFont (int axis) const
void setAxisMargins (int axis, double mlo, double mhi)
bool axisMargins (int axis, double &mlo, double &mhi) const
void setAxisScale (int axis, double min, double max, double step=0)
void setAxisScaleDraw (int axis, QwtScaleDraw *)
const QwtScaleDiv * axisScale (int axis) const
const QwtScaleDraw * axisScaleDraw (int axis) const
void setAxisLabelFormat (int axis, char f, int prec, int fieldwidth=0)
void axisLabelFormat (int axis, char &f, int &prec, int &fieldwidth) const
void setAxisTitle (int axis, const QString &t)
const QString & axisTitle (int axis) const
void setAxisTitleFont (int axis, const QFont &f)
QFont axisTitleFont (int axis) const
void setAxisTitleAlignment (int axis, int align)
int axisTitleAlignment (int axis) const
void setAxisMaxMinor (int axis, int maxMinor)
int axisMaxMajor (int axis) const
void setAxisMaxMajor (int axis, int maxMajor)
int axisMaxMinor (int axis) const
void setAxisReference (int axis, double value)
double axisReference (int axis) const
long insertMarker (QwtPlotMarker *)
long insertMarker (const QString &label=QString::null, int xAxis=xBottom, int yAxis=yLeft)
long insertLineMarker (const QString &label, int axis)
QwtPlotMarker * marker (long key)
const QwtPlotMarker * marker (long key) const
bool removeMarker (long key)
void removeMarkers ()
long closestMarker (int xpos, int ypos, int &dist) const
QArray< long > markerKeys () const
bool setMarkerXAxis (long key, int axis)
int markerXAxis (long key) const
bool setMarkerYAxis (long key, int axis)
int markerYAxis (long key) const
bool setMarkerPos (long key, double xval, double yVal)
bool setMarkerXPos (long key, double val)
bool setMarkerYPos (long key, double val)
void markerPos (long key, double &mx, double &my) const
bool setMarkerFont (long key, const QFont &f)
QFont markerFont (long key) const
bool setMarkerPen (long key, const QPen &p)
bool setMarkerLabel (long key, const QString &txt)
const QString & markerLabel (long key) const
bool setMarkerLabelAlign (long key, int align)
int markerLabelAlign (long key) const
bool setMarkerLabelPen (long key, const QPen &p)
QPen markerLabelPen (long key) const
bool setMarkerLinePen (long key, const QPen &p)
QPen markerLinePen (long key) const
bool setMarkerLineStyle (long key, QwtMarker::LineStyle st)
QwtMarker::LineStyle markerLineStyle (long key) const
bool setMarkerSymbol (long key, const QwtSymbol &s)
QwtSymbol markerSymbol (long key) const
void setAutoLegend (bool enabled)
bool autoLegend () const
void enableLegend (bool tf, long curveKey=-1)
bool legendEnabled (long curveKey) const
void setLegendPos (int pos)
int legendPos () const
void setLegendFont (const QFont &f)
const QFont legendFont () const
void setLegendFrameStyle (int st)
int legendFrameStyle () const
virtual QSize sizeHint () const
virtual QSize minimumSizeHint () const
virtual QSizePolicy sizePolicy () const
virtual bool event (QEvent *)

  Protected Methods
void autoRefresh ()
void drawCanvas (const QRect &)
virtual void drawCanvas (QPainter *)
virtual void drawContents (QPainter *p)
void updateAxes ()
void updateLayout ()
virtual void resizeEvent (QResizeEvent *e)

  Static Protected Methods
bool axisValid (int axis)

  Protected Attributes
QLabel * d_lblTitle
QwtPlotCanvas * d_canvas
QwtScale * d_scale [axisCnt]
QwtLegend * d_legend
QwtAutoScale d_as [axisCnt]
QwtScaleDiv d_sdiv [axisCnt]
QwtPlotGrid d_grid
QwtCurveDict * d_curves
QwtMarkerDict * d_markers

  Friends
class QwtPlotItem
class QwtPlotCanvas

DETAILED DESCRIPTION

A 2-D plotting widget.

 QwtPlot is a widget for plotting two-dimensional graphs. An unlimited number of data pairs can be displayed as curves in different styles and colors. A plot can have up to four axes, with each curve attached to an x- and a y axis. The scales at the axes are dimensioned automatically using an algorithm which can be configured separately for each axis. Linear and logarithmic scaling is supported. Markers of different styles can be added to the plot.

Curves and markers are identified by unique keys which are generated automatically when a curve or a marker is inserted. These keys are used to access the properties of the corresponding curves and markers.

A QwtPlot widget can have up to four axes which are indexed by the constants QwtPlot::yLeft, QwtPlot::yRight, QwtPlot::xTop, and QwtPlot::xBottom. Curves, markers, and the grid must be attached to an x axis and a y axis (Default: yLeft and xBottom).

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 '../include/qwt_plot.h>
QwtPlot *myPlot;
long curve1, curve2;                    // keys
double x[100], y1[100], y2[100];        // x and y values
myPlot = new QwtPlot('Two Graphs', parent, name);
// add curves
curve1 = myPlot->insertCurve('Graph 1');
curve2 = myPlot->insertCurve('Graph 2');
getSomeValues(x, y1, y2);
// copy the data into the curves
myPlot->setCurveData(curve1, x, y1, 100);
myPlot->setCurveData(curve2, x, y2, 100);
// finally, refresh the plot
myPlot->replot();

MEMBER ENUMERATION DOCUMENTATION

  enum QwtPlot::Axis

Axis index.

CONSTRUCTOR & DESTRUCTOR DOCUMENTATION

  QwtPlot::QwtPlot (QWidget * p = 0, const char * name = 0)

Constructor.

Parameters:

parent
    Parent widget

name
    Widget name

  QwtPlot::QwtPlot (const QString & title, QWidget * p = 0, const char * name = 0)

Constructor.

Parameters:

title
    Title text

parent
    Parent widget

name
    Widget name

  QwtPlot::~QwtPlot () [virtual]

Destructor.

MEMBER FUNCTION DOCUMENTATION

  bool QwtPlot::autoLegend () const

Returns:
TRUE if the autoLegend option is set.

  void QwtPlot::autoRefresh () [protected]

Replots the plot if QwtPlot::autoReplot() is TRUE.

  bool QwtPlot::autoReplot () const

Returns:
TRUE if the autoReplot option is set.

  bool QwtPlot::axisAutoScale (int axis) const

Returns:
TRUE if autoscaling is enabled

Parameters:

axis
    axis index

  bool QwtPlot::axisEnabled (int axis) const

Returns:
TRUE if a specified axis is enabled

Parameters:

axis
    axis index

  QFont QwtPlot::axisFont (int axis) const

Returns:
the font of the scale labels for a specified axis

Parameters:

axis
    axis index

  void QwtPlot::axisLabelFormat (int axis, char & f, int & prec, int & fieldwidth) const

Returns:
the number format for the major scale labels of a specified axis

Parameters:

axis
    axis index

Return values:

f   format character

prec
    precision

fieldwidth
    minimum fieldwidth

See also:
QString::sprintf in the Qt manual

  bool QwtPlot::axisMargins (int axis, double & mlo, double & mhi) const

Determine the scale margins for a specified axis.

Parameters:

axis
    axis index

Return values:

mlo Margin at the lower limit

mhi Margin at the upper limit

See also:
QwtAutoScale::margins()

  int QwtPlot::axisMaxMajor (int axis) const

Returns:
the maximum number of major ticks for a specified axis

Parameters:

axis
    axis index

  int QwtPlot::axisMaxMinor (int axis) const

Returns:
the maximum number of minor ticks for a specified axis

Parameters:

axis
    axis index

  int QwtPlot::axisOptions (int axis) const

Returns:
the autoscaling options of a specified axis

Parameters:

axis
    axis index

See also:
QwtAutoScale::options

  double QwtPlot::axisReference (int axis) const

The reference value is needed if the autoscaling options QwtAutoScale::Symmetric or QwtAutoScale::IncludeRef are set.

Returns:
the reference value of an axis

Parameters:

axis
    axis index

See also:
QwtAutoScale, QwtPlot::setAxisOptions

  const QwtScaleDiv * QwtPlot::axisScale (int axis) const

Returns:
the scale division of a specified axis

Parameters:

axis
    axis index

See also:
QwtScaleDiv

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

Returns:
the scale draw of a specified axis

Parameters:

axis
    axis index

Returns:
specified scaleDraw for axis, or NULL if axis is invalid.

See also:
QwtScaleDraw

  const QString & QwtPlot::axisTitle (int axis) const

Returns:
the title of a specified axis

Parameters:

axis
    axis index

  int QwtPlot::axisTitleAlignment (int axis) const

Returns:
the title alignment of a specified axis

Parameters:

axis
    axis index

See also:
QwtPlot::setAxisTitleAlignment

  QFont QwtPlot::axisTitleFont (int axis) const

Returns:
the title font of a specified axis

Parameters:

axis
    axis index

  bool QwtPlot::axisValid (int axis) [static, protected]

Returns:
TRUE if the specified axis exists, otherwise FALSE

Parameters:

axis
    axis index

  const QwtPlotCanvas * QwtPlot::canvas () const

Returns:
the plot's canvas

  QwtPlotCanvas * QwtPlot::canvas ()

Returns:
the plot's canvas

  const QColor & QwtPlot::canvasBackground () const

Nothing else than: canvas()->palette().color( QPalette::Normal, QColorGroup::Background);

Returns:
the background color of the plotting area.

  int QwtPlot::canvasLineWidth () const

Nothing else than: canvas()->lineWidth(), left for compatibility only.

Returns:
the border width of the plotting area

  QwtDiMap QwtPlot::canvasMap (int axis) const

Parameters:

axis
    Axis

Returns:
Map for the axis on the canvas. With this map pixel coordinates can translated to plot coordinates and vice versa.

See also:
QwtDiMap, QwtPlot::transform, QwtPlot::invTransform

  void QwtPlot::changeAxisOptions (int axis, int opt, bool value)

Change specified autoscaling options of an axis.

Parameters:

axis
    axis index

opt Set of or'ed options

value
    Value to be assigned to all the specified options (TRUE or FALSE)

See also:
QwtAutoScale::changeOptions

  void QwtPlot::clear ()

Remove all curves and markers.

  long QwtPlot::closestCurve (int xpos, int ypos, int & dist, double & xval, double & yval, int & index) const

Find the curve which is closest to a point in the plotting area.

Determines the position and index of the closest data point.

Parameters:

xpos

ypos
    coordinates of a point in the plotting region

Return values:

xval

yvalvalues
    of the closest point in the curve's data array

dist
    -- distance in points between (xpos, ypos) and the closest data point

index
    -- index of the closest point in the curve's data array

Returns:
Key of the closest curve or 0 if no curve was found.

  long QwtPlot::closestCurve (int xpos, int ypos, int & dist) const

Find the curve which is closest to a specified point in the plotting area.

Parameters:

xpos

ypos
    position in the plotting region

Return values:

dist
    distance in points between (xpos, ypos) and the closest data point

Returns:
Key of the closest curve or 0 if no curve was found.

  long QwtPlot::closestMarker (int xpos, int ypos, int & dist) const

Find the marker which is closest to a given point.

Parameters:

xpos

ypos
    coordinates of a point in the plotting region

Return values:

dist
    Distance in points between the marker and the specified point.

Returns:
Key of the closest marker or 0 if no marker was found

  const QwtPlotCurve * QwtPlot::curve (long key) const

Find and return an existing curve.

Parameters:

key Key of the curve

Returns:
The curve for the given key or 0 if key is not valid.

  QwtPlotCurve * QwtPlot::curve (long key)

Find and return an existing curve.

Parameters:

key Key of the curve

Returns:
The curve for the given key or 0 if key is not valid.

  double QwtPlot::curveBaseline (long key) const

Return the baseline offset for a specified curve.

Parameters:

key curve key

Returns:
Baseline offset of the specified curve, or 0 if the curve doesn't exist

See also:
setCurveBaseline()

  QArray< long > QwtPlot::curveKeys () const

Returns:
an array containing the keys of all curves

  int QwtPlot::curveOptions (long key) const

Returns:
the drawing options of the curve indexed by key

Parameters:

key Key of the curve

  QPen QwtPlot::curvePen (long key) const

Returns:
the pen of the curve indexed by key

Parameters:

key Key of the curve

  int QwtPlot::curveSplineSize (long key) const

Returns:
the spline size of the curve indexed by key

Parameters:

key Key of the curve

  int QwtPlot::curveStyle (long key) const

Returns:
the style of the curve indexed by key

Parameters:

key Key of the curve

See also:
setCurveStyle()

  QwtSymbol QwtPlot::curveSymbol (long key) const

the symbol of the curve indexed by key.

Parameters:

key Key of the curve

Returns:
The symbol of the specified curve. If the key is invalid, a symbol of type 'NoSymbol'.

  QString QwtPlot::curveTitle (long key) const

Returns:
the title of the curve indexed by key

Parameters:

key Key of the curve

  int QwtPlot::curveXAxis (long key) const

Return the index of the x axis to which a curve is mapped.

Parameters:

key Key of the curve

Returns:
x axis of the curve or -1 if the key is invalid.

  int QwtPlot::curveYAxis (long key) const

the index of the y axis to which a curve is mapped.

Parameters:

key Key of the curve

Returns:
y axis of the curve or -1 if the key is invalid.

  void QwtPlot::drawCanvas (QPainter * p) [protected, virtual]

Redraw grid, curves, and markers. The draw code.

  void QwtPlot::drawCanvas (const QRect & ur) [protected]

Setup a QPixmap for double-buffering.

  void QwtPlot::drawContents (QPainter * p) [protected, virtual]

drawContents.

  void QwtPlot::enableAxis (int axis, 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:

axis
    axis index

tf  TRUE (enabled) or FALSE (disabled)

  void QwtPlot::enableGridX (bool tf = TRUE)

Enable or disable vertical gridlines.

Parameters:

tf  Enable (TRUE) or disable (FALSE). Defaults to TRUE.

  void QwtPlot::enableGridXMin (bool tf = TRUE)

Enable or disable vertical gridlines for the minor scale marks.

Parameters:

tf  enable (TRUE) or disable (FALSE). Defaults to TRUE.

  void QwtPlot::enableGridY (bool tf = TRUE)

Enable or disable horizontal gridlines.

Parameters:

tf  Enable (TRUE) or disable (FALSE). Defaults to TRUE.

  void QwtPlot::enableGridYMin (bool tf = TRUE)

Enable or disable horizontal gridlines for the minor scale marks.

Parameters:

tf  enable (TRUE) or disable (FALSE). Defaults to TRUE.

  void QwtPlot::enableLegend (bool enable, long curveKey = -1)

Enable or disable the legend.

Parameters:

tf  TRUE (enabled) or FALSE (disabled)

curveKey
    Key of a existing curve. If curveKey < 0 the legends for all curves will be updated.

See also:
QwtPlot::setAutoLegend() , QwtPlot::setLegendPos()

  void QwtPlot::enableOutline (bool tf)

Enables or disables outline drawing. When the outline feature is enabled, a shape will be drawn in the plotting region when the user presses or drags the mouse. It can be used to implement crosshairs, mark a selected region, etc.

Parameters:

tf  TRUE (enabled) or FALSE (disabled)

Warning:
An outline style has to be specified.

See also:
setOutlineStyle()

  bool QwtPlot::event (QEvent * e) [virtual]

Adds handling of QEvent::LayoutHint.

  const QPen & QwtPlot::gridMajPen () const

Returns:
pen of the major grid

See also:
QwtPlot::setGridMajPen, QwtPlot::gridMinPen

  const QPen & QwtPlot::gridMinPen () const

Returns:
pen of the minor grid

See also:
QwtPlot::setGridMinPen, QwtPlot::gridMajPen

  int QwtPlot::gridXAxis () const

Returns:
x-axis where the grid is attached to.

See also:
QwtPlot::setGridXAxis

  int QwtPlot::gridYAxis () const

Returns:
y-axis where the grid is attached to.

See also:
QwtPlot::setGridYAxis

  long QwtPlot::insertCurve (const QString & title, int xAxis = xBottom, int yAxis = yLeft)

Insert a new curve and return a unique key.

Parameters:

title
    title of the new curve

xAxis
    x axis to be attached. Defaults to xBottom.

yAxis
    y axis to be attached. Defaults to yLeft.

Returns:
The key of the new curve or 0 if no new key could be found or if no new curve could be allocated.

  long QwtPlot::insertCurve (QwtPlotCurve * curve)

Insert a curve.

Parameters:

key unique key

curve
    Curve

Returns:
The key of the new curve or 0 if no new key could be found or if no new curve could be allocated.

  long QwtPlot::insertLineMarker (const QString & label, int axis)

This function is a shortcut to insert a horizontal or vertical line marker, dependent on the specified axis.

Parameters:

label
    Label

axis
    Axis to be attached

Returns:
New key if the marker could be inserted, 0 if not.

  long QwtPlot::insertMarker (const QString & label = QString::null, int xAxis = xBottom, int yAxis = yLeft)

Insert a new marker.

Parameters:

label
    Label

xAxis
    X axis to be attached

yAxis
    Y axis to be attached

Returns:
New key if the marker could be inserted, 0 if not.

  long QwtPlot::insertMarker (QwtPlotMarker * marker)

Insert a new marker.

Parameters:

marker
    Marker

Returns:
New key if the marker could be inserted, 0 if not.

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

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

Parameters:

axis
    axis index

pos position

Warning:
The position can be an x or a y coordinate, depending on the specified axis.

  void QwtPlot::legendClicked (long key) [signal]

A signal which is emitted when the user has clicked on a legend item.

Parameters:

key Key of the curve corresponding to the selected legend item

  bool QwtPlot::legendEnabled (long curveKey) const

Parameters:

curveKey
    Curve key.

Returns:
TRUE if legend is enabled, otherwise FALSE

  const QFont QwtPlot::legendFont () const

Returns:
the font of the legend items

  int QwtPlot::legendFrameStyle () const

Returns:
the frame style of the legend

  int QwtPlot::legendPos () const

Returns:
position of the legend

See also:
QwtPlot::setLegendPos

  int QwtPlot::margin () const

Returns:
margin

  const QwtPlotMarker * QwtPlot::marker (long key) const

Find and return an existing marker.

Parameters:

key Key of the marker

Returns:
The marker for the given key or 0 if key is not valid.

  QwtPlotMarker * QwtPlot::marker (long key)

Find and return an existing marker.

Parameters:

key Key of the marker

Returns:
The marker for the given key or 0 if key is not valid.

  QFont QwtPlot::markerFont (long key) const

Returns:
the font of a marker

  QArray< long > QwtPlot::markerKeys () const

Returns:
an array containing the keys of all markers

  const QString & QwtPlot::markerLabel (long key) const

Returns:
a marker's label

Parameters:

key Marker key

  int QwtPlot::markerLabelAlign (long key) const

Returns:
a marker's label alignment

Parameters:

key Marker key

  QPen QwtPlot::markerLabelPen (long key) const

Returns:
the pen of a marker's label

Parameters:

key Marker key

  QPen QwtPlot::markerLinePen (long key) const

Returns:
a marker's line pen

Parameters:

key Marker key

  QwtMarker::LineStyle QwtPlot::markerLineStyle (long key) const

Returns:
a marker's line style

Parameters:

key Marker key

  void QwtPlot::markerPos (long key, double & mx, double & my) const

Get the position of a marker.

Parameters:

key Marker key

Return values:

mx

my  Marker position

  QwtSymbol QwtPlot::markerSymbol (long key) const

Returns:
a marker's symbol

Parameters:

key Marker key

  int QwtPlot::markerXAxis (long key) const

Returns:
the x axis to which a marker is attached

Parameters:

key Marker key

  int QwtPlot::markerYAxis (long key) const

Returns:
the y axis to which a marker is attached

Parameters:

key Marker key

  QSize QwtPlot::minimumSizeHint () const [virtual]

Return a minimum size hint.

  bool QwtPlot::outlineEnabled () const

Returns:
TRUE if the outline feature is enabled

  const QPen & QwtPlot::outlinePen () const

Returns:
the pen used to draw outlines

  Qwt::Shape QwtPlot::outlineStyle () const

Returns:
the outline style

See also:
setOutlineStyle()

  void QwtPlot::plotMouseMoved (const QMouseEvent & e) [signal]

A signal which is emitted when the mouse is moved in the plotting area.

Parameters:

e   Mouse event object, event coordinates referring to the plotting area

  void QwtPlot::plotMousePressed (const QMouseEvent & e) [signal]

A signal which is emitted when the mouse is pressed in the plotting area.

Parameters:

e   Mouse event object, event coordinates referring to the plotting area

  void QwtPlot::plotMouseReleased (const QMouseEvent & e) [signal]

A signal which is emitted when a mouse button has been released in the plotting area.

Parameters:

e   Mouse event object, event coordinates referring to the plotting area

  void QwtPlot::print (QPainter * painter, const QRect & plotRect, const QwtPlotPrintFilter & pfilter = QwtPlotPrintFilter()) const [virtual]

Paint the plot into a given rectangle. Paint the contents of a QwtPlot instance into a given rectangle.

Parameters:

painter
    Painter

plotRect
    Bounding rectangle

flags
    flags must be a bitwise OR of Qwt::PrintFlags values

pfilter
    Print filter

See also:
QwtPlotPrintFilter

  void QwtPlot::print (QPaintDevice & paintDev, const QwtPlotPrintFilter & pfilter = QwtPlotPrintFilter()) const

Print the plot to a QPaintDevice (QPrinter) This function prints the contents of a QwtPlot instance to QPaintDevice object. The size is derived from its device metrics.

Parameters:

paintDev
    device to paint on, often a printer

flags
    flags must be a bitwise OR of Qwt::PrintFlags values

pfilter
    print filter

See also:
QwtPlot::print , QwtPlotPrintFilter

  bool QwtPlot::removeCurve (long key)

remove the curve indexed by key.

Parameters:

key Key of the curve

  void QwtPlot::removeCurves ()

Remove all curves.

  bool QwtPlot::removeMarker (long key)

Remove the marker indexed by key.

Parameters:

key unique key

  void QwtPlot::removeMarkers ()

Remove all markers.

  void QwtPlot::replot () [virtual, slot]

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:
setAutoReplot()

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

Resize and update internal layout.

  void QwtPlot::setAutoLegend (bool tf)

Set or reset the autoLegend option If the autoLegend option is set, a item will be added to the legend whenever a curve is inserted.

 The autoLegend option is set to FALSE by default, which means that the user has to call enableLegend.

Parameters:

tf  TRUE or FALSE. Defaults to FALSE.

See also:
QwtPlot::enableLegend()

  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:

tf  TRUE or FALSE. Defaults to TRUE.

See also:
replot()

  void QwtPlot::setAxisAutoScale (int axis)

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:

axis
    axis index

See also:
QwtPlot::setAxisScale()

  void QwtPlot::setAxisFont (int axis, const QFont & f)

Change the font of an axis.

Parameters:

axis
    axis index

f   font

Warning:
This function changes the font of the tick labels, not of the axis title.

  void QwtPlot::setAxisLabelFormat (int axis, char f, int prec, int fieldwidth = 0)

Change the number format for the major scale of a selected axis.

Parameters:

axis
    axis index

f   format

prec
    precision

fieldwidth
    minimum fieldwidth

See also:
QString::sprintf in the Qt manual

  void QwtPlot::setAxisMargins (int axis, double mlo, double mhi)

Assign margins to a specified axis.

Parameters:

axis
    axis index

mlo margin at the lower end of the scale

mhi margin at the upper end of the scale

Warning:
If the scale is logarithmic, the margins are measured in decades

See also:
QwtAutoScale::setMargins

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

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

Parameters:

axis
    axis index

maxMajor
    maximum number of major steps

See also:
QwtAutoScale::setMaxMajor

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

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

Parameters:

axis
    axis index

maxMinor
    maximum number of minor steps

See also:
QwtAutoScale::setMaxMinor

  void QwtPlot::setAxisOptions (int axis, int opt)

Reset scale options and set specified options for a specified axis.

Parameters:

axis
    axis index

opt set of options

See also:
QwtAutoScale::setOptions

  void QwtPlot::setAxisReference (int axis, double value)

Set a reference value for a specified axis.

 The reference value is used by some autoscaling modes.

Parameters:

axis
    axis index

value
    reference value

See also:
QwtAutoScale::setReference, QwtPlot::setAxisOptions()

  void QwtPlot::setAxisScale (int axis, double min, double max, double step = 0)

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

Parameters:

axis
    axis index

min

max minimum and maximum of the scale

step
    Major step size. If step == 0, the step size is calculated automatically using the maxMajor setting.

See also:
QwtPlot::setAxisMaxMajor()

  void QwtPlot::setAxisScaleDraw (int axis, QwtScaleDraw * scaleDraw)

Set a scale draw.

Parameters:

axis
    axis index

scaleDraw
    object 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, QwtScale

  void QwtPlot::setAxisTitle (int axis, const QString & t)

Change the title of a specified axis.

Parameters:

axis
    axis index

t   axis title

  void QwtPlot::setAxisTitleAlignment (int axis, int align)

Change the title alignment of a selected axis.

Parameters:

axis
    axis index

align
    or'd Qt::Alignment flags.

See also:
QwtScale::setTitleAlignment

  void QwtPlot::setAxisTitleFont (int axis, const QFont & f)

Change the title font of a selected axis.

Parameters:

axis
    axis index

f   font

  void QwtPlot::setCanvasBackground (const QColor & c)

Change the background of the plotting area.

 Sets c to QColorGroup::Background of all colorgroups of the palette of the canvas. Using canvas()->setPalette() is a more powerful way to set these colors.

Parameters:

c   new background color

  void QwtPlot::setCanvasLineWidth (int w)

Change the border width of the plotting area Nothing else than canvas()->setLineWidth(w), left for compatibility only.

Parameters:

w   new border width

  bool QwtPlot::setCurveBaseline (long key, double ref)

Set the baseline for a specified curve.

 The baseline is needed for the curve style QwtCurve::Sticks,

Parameters:

key curve key

ref baseline offset from zero

See also:
QwtCurve::setBaseline

  bool QwtPlot::setCurveData (long key, double * xdat, double * ydat, int size)

Assign x and y values to a curve. In opposite to @QwtPlot::setCurveRawData@, this function makes a 'deep copy' of the data.

Parameters:

key curve key

xdat
    pointer to x values

ydat
    pointer to y values

size
    size of xdat and ydat

See also:
setCurveRawData(), QwtCurve::setData

  bool QwtPlot::setCurveOptions (long key, int opt)

Set the style options of a curve indexed by key.

Parameters:

key The curve's key

opt The type of the spline

Returns:
TRUE if the specified curve exists.

See also:
QwtCurve::setOptions for a detailed description of valid options.

  bool QwtPlot::setCurvePen (long key, const QPen & pen)

Assign a pen to a curve indexed by key.

Parameters:

key Key of the curve

pen new pen

Returns:
TRUE if the curve exists

  bool QwtPlot::setCurveRawData (long key, double * xdat, double * ydat, int size)

Attach a curve to the specified arrays without copying.

 This function does not copy the values of the specified arrays. Removing the curve will not delete the data.

Parameters:

key Key of the curve

xdat

ydat
    Pointers to x and y data

size
    size of ydat and ydat

Returns:
TRUE if the curve exists

Warning:
Don't delete dynamically allocated data while a curve is attached to them.

See also:
setCurveData(), QwtCurve::setRawData

  bool QwtPlot::setCurveSplineSize (long key, int s)

Set the number of interpolated points of a curve indexed by key.

Parameters:

key key of the curve

s   size of the spline

Returns:
TRUE if the curve exists

  bool QwtPlot::setCurveStyle (long key, int s, int options = 0)

Change a curve's style.

Parameters:

key Key of the curve

s   display style of the curve

options
    style options

Returns:
TRUE if the curve exists

See also:
QwtCurve::setStyle() for a detailed description of valid styles.

  bool QwtPlot::setCurveSymbol (long key, const QwtSymbol & s)

Assign a symbol to a curve indexed by key.

Parameters:

key Key of the curve

s   Returns:
    TRUE if the curve exists

  bool QwtPlot::setCurveTitle (long key, const QString & s)

Parameters:

key

s

  bool QwtPlot::setCurveXAxis (long key, int axis)

Attach a curve to an x axis.

Parameters:

key key of the curve

axis
    x axis to be attached

  bool QwtPlot::setCurveYAxis (long key, int axis)

Attach a curve to an y axis.

Parameters:

key key of the curve

axis
    y axis to be attached

  void QwtPlot::setGridMajPen (const QPen & p)

Change the pen for the major gridlines.

Parameters:

p   new pen

  void QwtPlot::setGridMinPen (const QPen & p)

Change the pen for the minor gridlines.

Parameters:

p   new pen

  void QwtPlot::setGridPen (const QPen & p)

Change the grid's pens for major and minor gridlines.

Parameters:

p   new pen

  void QwtPlot::setGridXAxis (int axis)

Attach the grid to an x axis.

Parameters:

axis
    x axis to be attached

  void QwtPlot::setGridYAxis (int axis)

Attach the grid to an y axis.

Parameters:

axis
    y axis to be attached

  void QwtPlot::setLegendFont (const QFont & f)

Change the font of the legend items.

Parameters:

fnew
    font

  void QwtPlot::setLegendFrameStyle (int st)

Change the legend's frame style.

Parameters:

stFrame
    Style. See Qt manual on QFrame.

  void QwtPlot::setLegendPos (int pos)

Specify the position of the legend within the widget.

Parameters:

pos The legend's position. Valid values are Qwt::Left, Qwt::Right, Qwt::Top, QwtBottom.

  void QwtPlot::setMargin (int margin)

Change the margin of the plot.

Parameters:

margin
    new margin

  bool QwtPlot::setMarkerFont (long key, const QFont & f)

Specify a font for a marker's label.

Parameters:

key Marker key

f   New font

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerLabel (long key, const QString & txt)

Assign a label to a marker.

Parameters:

key Marker key

txt Label text

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerLabelAlign (long key, int align)

Specify the alignment of a marker's label.

 The alignment determines the position of the label relative to the marker's position. The default setting is AlignCenter.

Parameters:

key Marker key

align
    Alignment: AlignLeft, AlignRight, AlignTop, AlignBottom, AlignHCenter, AlignVCenter, AlignCenter or a combination of them.

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerLabelPen (long key, const QPen & p)

Specify a pen for a marker's label.

Parameters:

key Marker key

p   Label pen

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerLinePen (long key, const QPen & p)

Specify a pen for a marker's line.

Parameters:

key Marker key

p   New pen

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerLineStyle (long key, QwtMarker::LineStyle st)

Specify the line style for a marker.

Parameters:

key Marker key

st  Line style: QwtMarker::HLine, QwtMarker::VLine, QwtMarker::NoLine or a combination of them.

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerPen (long key, const QPen & p)

Specify a pen for a marker's label.

Parameters:

key Marker key

p   New pen

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerPos (long key, double xval, double yval)

Change the position of a marker.

Parameters:

key Marker key

xval

yval
    Position of the marker in axis coordinates.

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerSymbol (long key, const QwtSymbol & s)

Assign a symbol to a specified marker.

Parameters:

key Marker key

s   new symbol

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerXAxis (long key, int axis)

Attach the marker to an x axis.

Returns:
TRUE if the specified marker exists.

  bool QwtPlot::setMarkerXPos (long key, double val)

Specify the X position of a marker.

Parameters:

key Marker key

val X position of the marker

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerYAxis (long key, int axis)

Attach the marker to a Y axis.

Parameters:

key Marker key

axis
    Axis to be attached

Returns:
TRUE if the specified marker exists

  bool QwtPlot::setMarkerYPos (long key, double val)

Specify the Y position of the marker.

Parameters:

key Marker key

val Y position of the marker

Returns:
TRUE if the specified marker exists

  void QwtPlot::setOutlinePen (const QPen & pn)

Specify a pen for the outline.

Parameters:

pn  new pen

  void QwtPlot::setOutlineStyle (Qwt::Shape os)

Specify the style of the outline.

 The outline style determines which kind of shape is drawn in the plotting region when the user presses a mouse button or drags the mouse. Valid Styles are:

Parameters:

os  Outline Style. Valid values are: Qwt::HLine, Qwt::VLine, Qwt::Cross, Qwt::Rect, Qwt::Ellipse

Qwt::Cros
    Cross hairs are drawn across the plotting area when the user presses a mouse button. The lines intersect at the point where the mouse was pressed and move with the mouse pointer.

Qwt::HLine, Qwt::VLine
    A horizontal or vertical line appears when the user presses a mouse button. This is useful for moving line markers.

Qwt::Rect
    A rectangle is displayed when the user drags the mouse. One corner is fixed at the point where the mouse was pressed, and the opposite corner moves with the mouse pointer. This can be used for selecting regions.

Qwt::Ellipse
    Similar to Qwt::Rect, but with an ellipse inside a bounding rectangle.

See also:
enableOutline()

  void QwtPlot::setTitle (const QString & t)

Change the plot's title.

Parameters:

t   new title

  void QwtPlot::setTitleFont (const QFont & f)

Change the title font.

Parameters:

f   new title font

  QSize QwtPlot::sizeHint () const [virtual]

Returns:
minimumSizeHint.

  QSizePolicy QwtPlot::sizePolicy () const [virtual]

Returns:
MinimumExpanding/MinimumExpanding.

  QString QwtPlot::title () const

Returns:
the plot's title

  QFont QwtPlot::titleFont () const

Returns:
the plot's title font

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

Transform a value into a coordinate in the plotting region.

Parameters:

axis
    axis index

value
    value

Returns:
X or y coordinate in the plotting region corresponding to the value.

  void QwtPlot::updateAxes () [protected]

Rebuild the scales and maps.

  void QwtPlot::updateLayout () [protected]

Adjust plot content to its current size.

See also:
QwtPlot::resizeEvent

AUTHOR

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