QwtPlotPicker

Section: Qwt User's Guide (3) Updated: 16 Nov 2004 Local index Up

NAME

QwtPlotPicker -

SYNOPSIS

Inherits QwtPicker.

Inherited by QwtPlotZoomer.

Detailed Description

QwtPlotPicker provides selections on a plot canvas.

QwtPlotPicker is a QwtPicker tailored for selections on a plot canvas. It is set to a x-Axis and y-Axis and translates all pixel coordinates into this coodinate system.

Warning:

: Calling QwtPlot::setAxisScale() while QwtPlot::autoReplot() is FALSE leaves the axis in an 'intermediate' state. In this case, to prevent buggy behaviour, your must call QwtPlot::replot() before calling QwtPlotPicker::scaleRect(), QwtPlotZoomer::scaleRect(), QwtPlotPicker::QwtPlotPicker() or QwtPlotZoomer::QwtPlotZoomer(). This quirk will be removed in a future release.

Definition at line 38 of file qwt_plot_picker.h.

Signals

void selected (const QwtDoublePoint &pos)

void selected (const QwtDoubleRect &rect)

void selected (const QwtArray< QwtDoublePoint > &pa)

void appended (const QwtDoublePoint &pos)

void moved (const QwtDoublePoint &pos)

Public Member Functions

QwtPlotPicker (QwtPlotCanvas *, const char *name=0)

QwtPlotPicker (int xAxis, int yAxis, QwtPlotCanvas *, const char *name=0)

QwtPlotPicker (int xAxis, int yAxis, int selectionFlags, RubberBand rubberBand, DisplayMode cursorLabelMode, QwtPlotCanvas *, const char *name=0)

virtual void setAxis (int xAxis, int yAxis)

int xAxis () const

int yAxis () const

QwtPlot * plot ()

const QwtPlot * plot () const

QwtPlotCanvas * canvas ()

const QwtPlotCanvas * canvas () const

Protected Member Functions

QwtDoubleRect scaleRect () const

QwtDoubleRect invTransform (const QRect &) const

QRect transform (const QwtDoubleRect &) const

QwtDoublePoint invTransform (const QPoint &) const

QPoint transform (const QwtDoublePoint &) const

virtual QString cursorLabel (const QPoint &) const

virtual QString cursorLabel (const QwtDoublePoint &) const

virtual void move (const QPoint &)

virtual void append (const QPoint &)

virtual bool end (bool ok=TRUE)

Constructor & Destructor Documentation

QwtPlotPicker::QwtPlotPicker (QwtPlotCanvas * canvas, const char * name = 0)

Create a plot picker.

The picker is set to those x- and y-axis of the plot that are enabled. If both or no x-axis are enabled, the picker is set to QwtPlot::xBottom. If both or no y-axis are enabled, it is set to QwtPlot::yLeft.

Parameters:

: canvas Plot canvas to observe, also the parent object
name Object name

Warning:

: Calling QwtPlot::setAxisScale() while QwtPlot::autoReplot() is FALSE leaves the axis in an 'intermediate' state. In this case, to prevent buggy behaviour, you must call QwtPlot::replot() before calling QwtPlotPicker(). This quirk will be removed in a future release.

See also:

: QwtPlot::autoReplot(), QwtPlot::replot(), QwtPlotPicker::scaleRect()

Definition at line 38 of file qwt_plot_picker.cpp.

References QwtPlot::axisEnabled(), plot(), setAxis(), xAxis(), and yAxis().

QwtPlotPicker::QwtPlotPicker (int xAxis, int yAxis, QwtPlotCanvas * canvas, const char * name = 0)

Create a plot picker

Parameters:

: xAxis Set the x axis of the picker
yAxis Set the y axis of the picker
canvas Plot canvas to observe, also the parent object
name Object name

Warning:

: Calling QwtPlot::setAxisScale() while QwtPlot::autoReplot() is FALSE leaves the axis in an 'intermediate' state. In this case, to prevent buggy behaviour, you must call QwtPlot::replot() before calling QwtPlotPicker(). This quirk will be removed in a future release.

See also:

: QwtPlot::autoReplot(), QwtPlot::replot(), QwtPlotPicker::scaleRect()

Definition at line 83 of file qwt_plot_picker.cpp.

QwtPlotPicker::QwtPlotPicker (int xAxis, int yAxis, int selectionFlags, RubberBand rubberBand, DisplayMode cursorLabelMode, QwtPlotCanvas * canvas, const char * name = 0)

Create a plot picker

Parameters:

: xAxis X axis of the picker
yAxis Y axis of the picker
selectionFlags Or´d value of SelectionType, RectSelectionType and SelectionMode
rubberBand Rubberband style
cursorLabelMode Cursor label mode
canvas Plot canvas to observe, also the parent object
name Object name

See also:

: QwtPicker, QwtPicker::setSelectionFlags(), QwtPicker::setRubberBand(), QwtPicker::setCursorLabelMode

Warning:

: Calling QwtPlot::setAxisScale() while QwtPlot::autoReplot() is FALSE leaves the axis in an 'intermediate' state. In this case, to prevent buggy behaviour, you must call QwtPlot::replot() before calling QwtPlotPicker(). This quirk will be removed in a future release.

See also:

: QwtPlot::autoReplot(), QwtPlot::replot(), QwtPlotPicker::scaleRect()

Definition at line 114 of file qwt_plot_picker.cpp.

Member Function Documentation

void QwtPlotPicker::append (const QPoint & pos) [protected, virtual]

Append a point to the selection and update rubberband and cursor label.

Parameters:

: pos Additional point

See also:

: isActive, begin(), end(), move(), appended()

Note:

: The appended(const QPoint &), appended(const QDoublePoint &) signals are emitted.

Reimplemented from QwtPicker.

Definition at line 261 of file qwt_plot_picker.cpp.

References QwtPicker::append(), appended(), and invTransform().

void QwtPlotPicker::appended (const QwtDoublePoint & pos) [signal]

A signal emitted when a point has been appended to the selection

Parameters:

: pos Position of the appended point.

See also:

: append(). moved()

Referenced by append().

const QwtPlotCanvas * QwtPlotPicker::canvas () const

Return Observed plot canvas.

Definition at line 134 of file qwt_plot_picker.cpp.

QwtPlotCanvas * QwtPlotPicker::canvas ()

Return observed plot canvas.

Definition at line 124 of file qwt_plot_picker.cpp.

References QwtPicker::parentWidget().

Referenced by plot().

QString QwtPlotPicker::cursorLabel (const QwtDoublePoint & pos) const [protected, virtual]

Translate a position into a position string.

In case of HLineRubberBand the label is the value of the y position, in case of VLineRubberBand the value of the x position. Otherwise the label contains x and y position separated by a ´, ´.

The format for the double to string conversion is '%.4f'.

Parameters:

: pos Position

Returns:

: Position string

Definition at line 238 of file qwt_plot_picker.cpp.

References QwtPicker::rubberBand(), QwtDoublePoint::x(), and QwtDoublePoint::y().

QString QwtPlotPicker::cursorLabel (const QPoint & pos) const [protected, virtual]

Translate a pixel position into a position string

Parameters:

: pos Position in pixel coordinates

Returns:

: Position string

Reimplemented from QwtPicker.

Definition at line 221 of file qwt_plot_picker.cpp.

References invTransform().

bool QwtPlotPicker::end (bool ok = TRUE) [protected, virtual]

Close a selection setting the state to inactive.

Parameters:

: ok If TRUE, complete the selection and emit selected signals otherwise discard the selection.

Returns:

: TRUE if the selection is accepted, FALSE otherwise

Reimplemented from QwtPicker.

Reimplemented in QwtPlotZoomer.

Definition at line 290 of file qwt_plot_picker.cpp.

References QwtPicker::end(), invTransform(), plot(), selected(), QwtPicker::selection(), and QwtPicker::selectionFlags().

Referenced by QwtPlotZoomer::end().

QwtDoublePoint QwtPlotPicker::invTransform (const QPoint & pos) const [protected]

Translate a point from pixel into plot coordinates

Returns:

: Point in plot coordinates

See also:

: QwtPlotPicker::transform()

Definition at line 385 of file qwt_plot_picker.cpp.

References QwtPlot::canvasMap(), QwtDiMap::invTransform(), and plot().

QwtDoubleRect QwtPlotPicker::invTransform (const QRect & rect) const [protected]

Translate a rectangle from pixel into plot coordinates

Returns:

: Rectangle in plot coordinates

See also:

: QwtPlotPicker::transform()

Definition at line 349 of file qwt_plot_picker.cpp.

References QwtPlot::canvasMap(), QwtDiMap::invTransform(), and plot().

Referenced by append(), cursorLabel(), QwtPlotZoomer::end(), end(), and move().

void QwtPlotPicker::move (const QPoint & pos) [protected, virtual]

Move the last point of the selection

Parameters:

: pos New position

See also:

: isActive, begin(), end(), append()

Note:

: The moved(const QPoint &), moved(const QDoublePoint &) signals are emitted.

Reimplemented from QwtPicker.

Definition at line 276 of file qwt_plot_picker.cpp.

References invTransform(), QwtPicker::move(), and moved().

void QwtPlotPicker::moved (const QwtDoublePoint & pos) [signal]

A signal emitted whenever the last appended point of the selection has been moved.

Parameters:

: pos Position of the moved last point of the selection.

See also:

: move(), appended()

Referenced by move().

const QwtPlot * QwtPlotPicker::plot () const

Return plot widget, containing the observed plot canvas.

Definition at line 154 of file qwt_plot_picker.cpp.

QwtPlot * QwtPlotPicker::plot ()

Return plot widget, containing the observed plot canvas.

Definition at line 140 of file qwt_plot_picker.cpp.

References canvas().

Referenced by QwtPlotZoomer::end(), end(), invTransform(), QwtPlotZoomer::minZoomSize(), QwtPlotPicker(), QwtPlotZoomer::rescale(), scaleRect(), setAxis(), QwtPlotZoomer::setZoomBase(), and transform().

QwtDoubleRect QwtPlotPicker::scaleRect () const [protected]

Return normalized bounding rect of the axes

Warning:

: Calling QwtPlot::setAxisScale() while QwtPlot::autoReplot() is FALSE leaves the axis in an 'intermediate' state. In this case, to prevent buggy behaviour, you must call QwtPlot::replot() before calling QwtPlotPicker::scaleRect(). This quirk will be removed in a future release.

See also:

: QwtPlot::autoReplot(), QwtPlot::replot().

Definition at line 170 of file qwt_plot_picker.cpp.

References QwtPlot::axisScale(), QwtScaleDiv::hBound(), QwtScaleDiv::lBound(), plot(), xAxis(), and yAxis().

Referenced by QwtPlotZoomer::rescale(), QwtPlotZoomer::setAxis(), and QwtPlotZoomer::setZoomBase().

void QwtPlotPicker::selected (const QwtArray< QwtDoublePoint > & pa) [signal]

A signal emitting the selected points, at the end of a selection.

Parameters:

: pa Selected points

void QwtPlotPicker::selected (const QwtDoubleRect & rect) [signal]

A signal emitted in case of selectionFlags() & RectSelection.

Parameters:

: rect Selected rectangle

void QwtPlotPicker::selected (const QwtDoublePoint & pos) [signal]

A signal emitted in case of selectionFlags() & PointSelection.

Parameters:

: pos Selected point

Referenced by end().

void QwtPlotPicker::setAxis (int xAxis, int yAxis) [virtual]

Set the x and y axes of the picker

Parameters:

: xAxis X axis
yAxis Y axis

Reimplemented in QwtPlotZoomer.

Definition at line 190 of file qwt_plot_picker.cpp.

References plot().

Referenced by QwtPlotPicker(), and QwtPlotZoomer::setAxis().

QPoint QwtPlotPicker::transform (const QwtDoublePoint & pos) const [protected]

Translate a point from plot into pixel coordinates

Returns:

: Point in pixel coordinates

See also:

: QwtPlotPicker::invTransform()

Definition at line 401 of file qwt_plot_picker.cpp.

References QwtPlot::canvasMap(), plot(), QwtDiMap::transform(), QwtDoublePoint::x(), and QwtDoublePoint::y().

QRect QwtPlotPicker::transform (const QwtDoubleRect & rect) const [protected]

Translate a rectangle from plot into pixel coordinates

Returns:

: Rectangle in pixel coordinates

See also:

: QwtPlotPicker::invTransform()

Definition at line 367 of file qwt_plot_picker.cpp.

References QwtPlot::canvasMap(), plot(), QwtDiMap::transform(), QwtDoubleRect::x1(), QwtDoubleRect::x2(), QwtDoubleRect::y1(), and QwtDoubleRect::y2().