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

# QwtPlotPicker Class Reference

Inheritance diagram for QwtPlotPicker:

[legend]
Collaboration diagram for QwtPlotPicker:

[legend]
List of all members.

## 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().

int QwtPlotPicker::xAxis | ( |  | ) | const

| Return x axis. Definition at line 204 of file qwt_plot_picker.cpp. Referenced by QwtPlotZoomer::minZoomSize(), QwtPlotPicker(), QwtPlotZoomer::rescale(), scaleRect(), and QwtPlotZoomer::setAxis().

int QwtPlotPicker::yAxis | ( |  | ) | const

| Return y axis. Definition at line 210 of file qwt_plot_picker.cpp. Referenced by QwtPlotZoomer::minZoomSize(), QwtPlotPicker(), QwtPlotZoomer::rescale(), scaleRect(), and QwtPlotZoomer::setAxis().