---

QwtPlot Class Reference

A 2-D plotting widget. More...

#include <qwt_plot.h>

List of all members.

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

---