qwtplotpicker(3)
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(). - 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().
Author
- Generated automatically by Doxygen for Qwt User's Guide from the source
code.