Qwt User's Guide  6.1.0
 All Classes Functions Variables Typedefs Enumerations Enumerator Pages
Signals | Public Member Functions | Protected Member Functions | List of all members
QwtPlotPicker Class Reference

QwtPlotPicker provides selections on a plot canvas. More...

#include <qwt_plot_picker.h>

Inheritance diagram for QwtPlotPicker:
Inheritance graph
[legend]

Signals

void selected (const QPointF &pos)
 
void selected (const QRectF &rect)
 
void selected (const QVector< QPointF > &pa)
 
void appended (const QPointF &pos)
 
void moved (const QPointF &pos)
 
- Signals inherited from QwtPicker
void activated (bool on)
 
void selected (const QPolygon &polygon)
 
void appended (const QPoint &pos)
 
void moved (const QPoint &pos)
 
void removed (const QPoint &pos)
 
void changed (const QPolygon &selection)
 

Public Member Functions

 QwtPlotPicker (QWidget *canvas)
 Create a plot picker. More...
 
virtual ~QwtPlotPicker ()
 Destructor.
 
 QwtPlotPicker (int xAxis, int yAxis, QWidget *)
 
 QwtPlotPicker (int xAxis, int yAxis, RubberBand rubberBand, DisplayMode trackerMode, QWidget *)
 
virtual void setAxis (int xAxis, int yAxis)
 
int xAxis () const
 Return x axis.
 
int yAxis () const
 Return y axis.
 
QwtPlotplot ()
 
const QwtPlotplot () const
 
QWidget * canvas ()
 
const QWidget * canvas () const
 
- Public Member Functions inherited from QwtPicker
 QwtPicker (QWidget *parent)
 
 QwtPicker (RubberBand rubberBand, DisplayMode trackerMode, QWidget *)
 
virtual ~QwtPicker ()
 Destructor.
 
void setStateMachine (QwtPickerMachine *)
 
const QwtPickerMachinestateMachine () const
 
QwtPickerMachinestateMachine ()
 
void setRubberBand (RubberBand)
 
RubberBand rubberBand () const
 
void setTrackerMode (DisplayMode)
 Set the display mode of the tracker. More...
 
DisplayMode trackerMode () const
 
void setResizeMode (ResizeMode)
 Set the resize mode. More...
 
ResizeMode resizeMode () const
 
void setRubberBandPen (const QPen &)
 
QPen rubberBandPen () const
 
void setTrackerPen (const QPen &)
 
QPen trackerPen () const
 
void setTrackerFont (const QFont &)
 
QFont trackerFont () const
 
bool isEnabled () const
 
bool isActive () const
 
virtual bool eventFilter (QObject *, QEvent *)
 Event filter. More...
 
QWidget * parentWidget ()
 Return the parent widget, where the selection happens.
 
const QWidget * parentWidget () const
 Return the parent widget, where the selection happens.
 
virtual QPainterPath pickArea () const
 
virtual void drawRubberBand (QPainter *) const
 
virtual void drawTracker (QPainter *) const
 
virtual QRegion rubberBandMask () const
 
QPoint trackerPosition () const
 
virtual QRect trackerRect (const QFont &) const
 
QPolygon selection () const
 
- Public Member Functions inherited from QwtEventPattern
 QwtEventPattern ()
 
virtual ~QwtEventPattern ()
 Destructor.
 
void initMousePattern (int numButtons)
 
void initKeyPattern ()
 
void setMousePattern (MousePatternCode, Qt::MouseButton button, Qt::KeyboardModifiers=Qt::NoModifier)
 
void setKeyPattern (KeyPatternCode, int keyCode, Qt::KeyboardModifiers modifierCodes=Qt::NoModifier)
 
void setMousePattern (const QVector< MousePattern > &)
 Change the mouse event patterns.
 
void setKeyPattern (const QVector< KeyPattern > &)
 Change the key event patterns.
 
const QVector< MousePattern > & mousePattern () const
 
const QVector< KeyPattern > & keyPattern () const
 
QVector< MousePattern > & mousePattern ()
 
QVector< KeyPattern > & keyPattern ()
 
bool mouseMatch (MousePatternCode, const QMouseEvent *) const
 Compare a mouse event with an event pattern. More...
 
bool keyMatch (KeyPatternCode, const QKeyEvent *) const
 Compare a key event with an event pattern. More...
 

Protected Member Functions

QRectF scaleRect () const
 
QRectF invTransform (const QRect &) const
 
QRect transform (const QRectF &) const
 
QPointF invTransform (const QPoint &) const
 
QPoint transform (const QPointF &) const
 
virtual QwtText trackerText (const QPoint &) const
 
virtual QwtText trackerTextF (const QPointF &) const
 Translate a position into a position string. More...
 
virtual void move (const QPoint &)
 
virtual void append (const QPoint &)
 
virtual bool end (bool ok=true)
 
- Protected Member Functions inherited from QwtPicker
virtual QPolygon adjustedPoints (const QPolygon &) const
 Map the pickedPoints() into a selection() More...
 
virtual void transition (const QEvent *)
 
virtual void begin ()
 
virtual void remove ()
 
virtual bool accept (QPolygon &) const
 Validate and fix up the selection. More...
 
virtual void reset ()
 
virtual void widgetMousePressEvent (QMouseEvent *)
 
virtual void widgetMouseReleaseEvent (QMouseEvent *)
 
virtual void widgetMouseDoubleClickEvent (QMouseEvent *)
 
virtual void widgetMouseMoveEvent (QMouseEvent *)
 
virtual void widgetWheelEvent (QWheelEvent *)
 
virtual void widgetKeyPressEvent (QKeyEvent *)
 
virtual void widgetKeyReleaseEvent (QKeyEvent *)
 
virtual void widgetEnterEvent (QEvent *)
 
virtual void widgetLeaveEvent (QEvent *)
 
virtual void stretchSelection (const QSize &oldSize, const QSize &newSize)
 
virtual void updateDisplay ()
 Update the state of rubber band and tracker label.
 
const QwtWidgetOverlayrubberBandOverlay () const
 
const QwtWidgetOverlaytrackerOverlay () const
 
const QPolygon & pickedPoints () const
 
- Protected Member Functions inherited from QwtEventPattern
virtual bool mouseMatch (const MousePattern &, const QMouseEvent *) const
 Compare a mouse event with an event pattern. More...
 
virtual bool keyMatch (const KeyPattern &, const QKeyEvent *) const
 Compare a key event with an event pattern. More...
 

Additional Inherited Members

- Public Types inherited from QwtPicker
enum  RubberBand {
  NoRubberBand = 0, HLineRubberBand, VLineRubberBand, CrossRubberBand,
  RectRubberBand, EllipseRubberBand, PolygonRubberBand, UserRubberBand = 100
}
 
enum  DisplayMode { AlwaysOff, AlwaysOn, ActiveOnly }
 Display mode. More...
 
enum  ResizeMode { Stretch, KeepSize }
 
- Public Slots inherited from QwtPicker
void setEnabled (bool)
 En/disable the picker. More...
 

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 coordinate system.

Constructor & Destructor Documentation

QwtPlotPicker::QwtPlotPicker ( QWidget *  canvas)
explicit

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
canvasPlot canvas to observe, also the parent object
See Also
QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()
QwtPlotPicker::QwtPlotPicker ( int  xAxis,
int  yAxis,
QWidget *  canvas 
)
explicit

Create a plot picker

Parameters
xAxisSet the x axis of the picker
yAxisSet the y axis of the picker
canvasPlot canvas to observe, also the parent object
See Also
QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()
QwtPlotPicker::QwtPlotPicker ( int  xAxis,
int  yAxis,
RubberBand  rubberBand,
DisplayMode  trackerMode,
QWidget *  canvas 
)
explicit

Create a plot picker

Parameters
xAxisX axis of the picker
yAxisY axis of the picker
rubberBandRubber band style
trackerModeTracker mode
canvasPlot canvas to observe, also the parent object
See Also
QwtPicker, QwtPicker::setSelectionFlags(), QwtPicker::setRubberBand(), QwtPicker::setTrackerMode
QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()

Member Function Documentation

void QwtPlotPicker::append ( const QPoint &  pos)
protectedvirtual

Append a point to the selection and update rubber band and tracker.

Parameters
posAdditional point
See Also
isActive, begin(), end(), move(), appended()
Note
The appended(const QPoint &), appended(const QDoublePoint &) signals are emitted.

Reimplemented from QwtPicker.

void QwtPlotPicker::appended ( const QPointF &  pos)
signal

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

Parameters
posPosition of the appended point.
See Also
append(). moved()
QWidget * QwtPlotPicker::canvas ( )
Returns
Observed plot canvas
const QWidget * QwtPlotPicker::canvas ( ) const
Returns
Observed plot canvas
bool QwtPlotPicker::end ( bool  ok = true)
protectedvirtual

Close a selection setting the state to inactive.

Parameters
okIf true, complete the selection and emit selected signals otherwise discard the selection.
Returns
True if the selection has been accepted, false otherwise

Reimplemented from QwtPicker.

Reimplemented in QwtPlotZoomer.

QRectF QwtPlotPicker::invTransform ( const QRect &  rect) const
protected

Translate a rectangle from pixel into plot coordinates

Returns
Rectangle in plot coordinates
See Also
transform()
QPointF QwtPlotPicker::invTransform ( const QPoint &  pos) const
protected

Translate a point from pixel into plot coordinates

Returns
Point in plot coordinates
See Also
transform()
void QwtPlotPicker::move ( const QPoint &  pos)
protectedvirtual

Move the last point of the selection

Parameters
posNew position
See Also
isActive, begin(), end(), append()
Note
The moved(const QPoint &), moved(const QDoublePoint &) signals are emitted.

Reimplemented from QwtPicker.

void QwtPlotPicker::moved ( const QPointF &  pos)
signal

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

Parameters
posPosition of the moved last point of the selection.
See Also
move(), appended()
QwtPlot * QwtPlotPicker::plot ( )
Returns
Plot widget, containing the observed plot canvas
const QwtPlot * QwtPlotPicker::plot ( ) const
Returns
Plot widget, containing the observed plot canvas
QRectF QwtPlotPicker::scaleRect ( ) const
protected
Returns
Normalized bounding rectangle of the axes
See Also
QwtPlot::autoReplot(), QwtPlot::replot().
void QwtPlotPicker::selected ( const QPointF &  pos)
signal

A signal emitted in case of QwtPickerMachine::PointSelection.

Parameters
posSelected point
void QwtPlotPicker::selected ( const QRectF &  rect)
signal

A signal emitted in case of QwtPickerMachine::RectSelection.

Parameters
rectSelected rectangle
void QwtPlotPicker::selected ( const QVector< QPointF > &  pa)
signal

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

Parameters
paSelected points
void QwtPlotPicker::setAxis ( int  xAxis,
int  yAxis 
)
virtual

Set the x and y axes of the picker

Parameters
xAxisX axis
yAxisY axis

Reimplemented in QwtPlotZoomer.

QwtText QwtPlotPicker::trackerText ( const QPoint &  pos) const
protectedvirtual

Translate a pixel position into a position string

Parameters
posPosition in pixel coordinates
Returns
Position string

Reimplemented from QwtPicker.

QwtText QwtPlotPicker::trackerTextF ( const QPointF &  pos) const
protectedvirtual

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
posPosition
Returns
Position string
QRect QwtPlotPicker::transform ( const QRectF &  rect) const
protected

Translate a rectangle from plot into pixel coordinates

Returns
Rectangle in pixel coordinates
See Also
invTransform()
QPoint QwtPlotPicker::transform ( const QPointF &  pos) const
protected

Translate a point from plot into pixel coordinates

Returns
Point in pixel coordinates
See Also
invTransform()