NAME¶

SYNOPSIS¶

Public Types¶

Public Slots¶

Signals¶

Public Member Functions¶

Protected Member Functions¶

Detailed Description¶

•

Nothing

 

QwtPickerTrackerMachine

•

Single points

 

QwtPickerClickPointMachine, QwtPickerDragPointMachine

•

Rectangles

 

QwtPickerClickRectMachine, QwtPickerDragRectMachine

•

Polygons

 

QwtPickerPolygonMachine

#include <qwt_picker.h>
#include <qwt_picker_machine.h>

QwtPicker *picker = new QwtPicker(widget);
picker->setStateMachine(new QwtPickerDragRectMachine);
picker->setTrackerMode(QwtPicker::ActiveOnly);
picker->setRubberBand(QwtPicker::RectRubberBand); 

•

begin()

 

Activate/Initialize the selection.

•

append()

 

Add a new point

•

move()

 

Change the position of the last point.

•

remove()

 

Remove the last point.

•

end()

 

Terminate the selection and call accept to validate the picked points.

Member Enumeration Documentation¶

enum QwtPicker::DisplayMode¶

AlwaysOff

Display never.

AlwaysOn

Display always.

ActiveOnly

Display only when the selection is active.

enum QwtPicker::ResizeMode Controls what to do with the selected points of an active selection when the observed widget is resized.¶

Stretch

All points are scaled according to the new size,.

KeepSize

All points remain unchanged.

enum QwtPicker::RubberBand Rubberband style¶

NoRubberBand

No rubberband.

HLineRubberBand

A horizontal line ( only for QwtPicker::PointSelection )

VLineRubberBand

A vertical line ( only for QwtPicker::PointSelection )

CrossRubberBand

A crosshair ( only for QwtPicker::PointSelection )

RectRubberBand

A rectangle ( only for QwtPicker::RectSelection )

EllipseRubberBand

An ellipse ( only for QwtPicker::RectSelection )

PolygonRubberBand

A polygon ( only for QwtPicker::&PolygonSelection )

UserRubberBand

Values >= UserRubberBand can be used to define additional rubber bands.

Constructor & Destructor Documentation¶

QwtPicker::QwtPicker (QWidget *parent) [explicit] Constructor¶

QwtPicker::QwtPicker (RubberBandrubberBand, DisplayModetrackerMode, QWidget *parent) [explicit] Constructor¶

QwtPicker::~QwtPicker () [virtual]¶

Member Function Documentation¶

bool QwtPicker::accept (QPolygon &selection) const [protected, virtual]¶

void QwtPicker::activated (boolon) [signal] A signal indicating, when the picker has been activated. Together with setEnabled() it can be used to implement selections with more than one picker.¶

QPolygon QwtPicker::adjustedPoints (const QPolygon &points) const [protected, virtual]¶

•

A rectangular selection might need to have a specific aspect ratio only.

 

 

•

A selection could accept non intersecting polygons only.

 

 

•

 

 

QPolygon MyPicker::adjustedPoints(const QPolygon &points) const
{
    QPolygon adjusted;
    if ( points.size() == 2 )
    {
        const int width = qAbs(points[1].x() - points[0].x());
        const int height = qAbs(points[1].y() - points[0].y());

        QRect rect(0, 0, 2 * width, 2 * height);
        rect.moveCenter(points[0]);

        adjusted += rect.topLeft();
        adjusted += rect.bottomRight();
    }
    return adjusted;
}

void QwtPicker::append (const QPoint &pos) [protected, virtual] Append a point to the selection and update rubberband and tracker. The appended() signal is emitted.¶

void QwtPicker::appended (const QPoint &pos) [signal] A signal emitted when a point has been appended to the selection¶

void QwtPicker::begin () [protected, virtual] Open a selection setting the state to active¶

void QwtPicker::changed (const QPolygon &selection) [signal] A signal emitted when the active selection has been changed. This might happen when the observed widget is resized.¶

void QwtPicker::drawRubberBand (QPainter *painter) const [virtual] Draw a rubberband, depending on rubberBand()¶

void QwtPicker::drawTracker (QPainter *painter) const [virtual] Draw the tracker¶

bool QwtPicker::end (boolok = true) [protected, virtual]¶

bool QwtPicker::eventFilter (QObject *o, QEvent *e) [virtual]¶

bool QwtPicker::isActive () const A picker is active between begin() and end().¶

bool QwtPicker::isEnabled () const Returns:¶

void QwtPicker::move (const QPoint &pos) [protected, virtual] Move the last point of the selection The moved() signal is emitted.¶

void QwtPicker::moved (const QPoint &pos) [signal] A signal emitted whenever the last appended point of the selection has been moved.¶

QWidget * QwtPicker::parentWidget ()¶

const QWidget * QwtPicker::parentWidget () const¶

const QPolygon & QwtPicker::pickedPoints () const [protected] Return the points, that have been collected so far. The selection() is calculated from the pickedPoints() in adjustedPoints().¶

QRect QwtPicker::pickRect () const [virtual] Find the area of the observed widget, where selection might happen.¶

void QwtPicker::remove () [protected, virtual] Remove the last point of the selection The removed() signal is emitted.¶

void QwtPicker::removed (const QPoint &pos) [signal] A signal emitted whenever the last appended point of the selection has been removed.¶

void QwtPicker::reset () [protected, virtual] Reset the state machine and terminate (end(false)) the selection¶

QwtPicker::ResizeMode QwtPicker::resizeMode () const Returns:¶

QwtPicker::RubberBand QwtPicker::rubberBand () const Returns:¶

QPen QwtPicker::rubberBandPen () const Returns:¶

const QWidget * QwtPicker::rubberBandWidget () const [protected] Returns:¶

void QwtPicker::selected (const QPolygon &polygon) [signal] A signal emitting the selected points, at the end of a selection.¶

QPolygon QwtPicker::selection () const Returns:¶

void QwtPicker::setEnabled (boolenabled) [slot]¶

void QwtPicker::setResizeMode (ResizeModemode)¶

void QwtPicker::setRubberBand (RubberBandrubberBand) Set the rubberband style¶

void QwtPicker::setRubberBandPen (const QPen &pen) Set the pen for the rubberband¶

void QwtPicker::setStateMachine (QwtPickerMachine *stateMachine) Set a state machine and delete the previous one¶

void QwtPicker::setTrackerFont (const QFont &font) Set the font for the tracker¶

void QwtPicker::setTrackerMode (DisplayModemode)¶

void QwtPicker::setTrackerPen (const QPen &pen) Set the pen for the tracker¶

const QwtPickerMachine * QwtPicker::stateMachine () const Returns:¶

QwtPickerMachine * QwtPicker::stateMachine () Returns:¶

void QwtPicker::stretchSelection (const QSize &oldSize, const QSize &newSize) [protected, virtual] Scale the selection by the ratios of oldSize and newSize The changed() signal is emitted.¶

QFont QwtPicker::trackerFont () const Returns:¶

QwtPicker::DisplayMode QwtPicker::trackerMode () const Returns:¶

QPen QwtPicker::trackerPen () const Returns:¶

QPoint QwtPicker::trackerPosition () const Returns:¶

QRect QwtPicker::trackerRect (const QFont &font) const [virtual] Calculate the bounding rectangle for the tracker text from the current position of the tracker¶

QwtText QwtPicker::trackerText (const QPoint &pos) const [virtual]¶

const QWidget * QwtPicker::trackerWidget () const [protected] Returns:¶

void QwtPicker::transition (const QEvent *e) [protected, virtual] Passes an event to the state machine and executes the resulting commands. Append and Move commands use the current position of the cursor (QCursor::pos()).¶

void QwtPicker::updateDisplay () [protected, virtual]¶

void QwtPicker::widgetEnterEvent (QEvent *event) [protected, virtual] Handle a enter event for the observed widget.¶

void QwtPicker::widgetKeyPressEvent (QKeyEvent *ke) [protected, virtual] Handle a key press event for the observed widget.¶

void QwtPicker::widgetKeyReleaseEvent (QKeyEvent *ke) [protected, virtual] Handle a key release event for the observed widget.¶

void QwtPicker::widgetLeaveEvent (QEvent *event) [protected, virtual] Handle a leave event for the observed widget.¶

void QwtPicker::widgetMouseDoubleClickEvent (QMouseEvent *me) [protected, virtual] Handle mouse double click event for the observed widget.¶

void QwtPicker::widgetMouseMoveEvent (QMouseEvent *e) [protected, virtual] Handle a mouse move event for the observed widget.¶

void QwtPicker::widgetMousePressEvent (QMouseEvent *e) [protected, virtual] Handle a mouse press event for the observed widget.¶

void QwtPicker::widgetMouseReleaseEvent (QMouseEvent *e) [protected, virtual] Handle a mouse relase event for the observed widget.¶

void QwtPicker::widgetWheelEvent (QWheelEvent *e) [protected, virtual] Handle a wheel event for the observed widget.¶

Author¶