Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

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
QwtPlotCanvascanvas ()
const QwtPlotCanvascanvas () 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)
QwtPlotCurvecurve (long key)
const QwtPlotCurvecurve (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 QwtScaleDivaxisScale (int axis) const
const QwtScaleDrawaxisScaleDraw (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)
QwtPlotMarkermarker (long key)
const QwtPlotMarkermarker (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
QwtPlotCanvasd_canvas
QwtScaled_scale [axisCnt]
QwtLegendd_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


Generated on Tue May 28 15:30:59 2002 for Qwt User's Guide by doxygen1.2.13.1 written by Dimitri van Heesch, © 1997-2001