QGIS/external/qwt-6.3.0/qwt_picker.cpp
Juergen E. Fischer 33fc476d89 * replace external qwtpolar with qwt 6.3
* require qwt >=6.2 (and fallback to internal 6.3 if system's qwt doesn't suffice)
* debian doesn't have qwt for Qt6 and won't have it for trixie
2025-07-23 07:11:51 +10:00

1612 lines
40 KiB
C++

/******************************************************************************
* Qwt Widget Library
* Copyright (C) 1997 Josef Wilgen
* Copyright (C) 2002 Uwe Rathmann
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the Qwt License, Version 1.0
*****************************************************************************/
#include "qwt_picker.h"
#include "qwt_picker_machine.h"
#include "qwt_painter.h"
#include "qwt_math.h"
#include "qwt_widget_overlay.h"
#include "qwt_text.h"
#include <qevent.h>
#include <qpainter.h>
#include <qpainterpath.h>
#include <qcursor.h>
#include <qpointer.h>
#include <qmath.h>
static inline QRegion qwtMaskRegion( const QRect& r, int penWidth )
{
const int pw = qMax( penWidth, 1 );
const int pw2 = penWidth / 2;
int x1 = r.left() - pw2;
int x2 = r.right() + 1 + pw2 + ( pw % 2 );
int y1 = r.top() - pw2;
int y2 = r.bottom() + 1 + pw2 + ( pw % 2 );
QRegion region;
region += QRect( x1, y1, x2 - x1, pw );
region += QRect( x1, y1, pw, y2 - y1 );
region += QRect( x1, y2 - pw, x2 - x1, pw );
region += QRect( x2 - pw, y1, pw, y2 - y1 );
return region;
}
static inline QRegion qwtMaskRegion( const QLine& l, int penWidth )
{
const int pw = qMax( penWidth, 1 );
const int pw2 = penWidth / 2;
QRegion region;
if ( l.x1() == l.x2() )
{
region += QRect( l.x1() - pw2, l.y1(),
pw, l.y2() ).normalized();
}
else if ( l.y1() == l.y2() )
{
region += QRect( l.x1(), l.y1() - pw2,
l.x2(), pw ).normalized();
}
return region;
}
namespace
{
class Rubberband QWT_FINAL : public QwtWidgetOverlay
{
public:
Rubberband( QwtPicker* picker, QWidget* parent )
: QwtWidgetOverlay( parent )
, m_picker( picker )
{
setMaskMode( QwtWidgetOverlay::MaskHint );
}
protected:
virtual void drawOverlay( QPainter* painter ) const QWT_OVERRIDE
{
painter->setPen( m_picker->rubberBandPen() );
m_picker->drawRubberBand( painter );
}
virtual QRegion maskHint() const QWT_OVERRIDE
{
return m_picker->rubberBandMask();
}
QwtPicker* m_picker;
};
class Tracker QWT_FINAL : public QwtWidgetOverlay
{
public:
Tracker( QwtPicker* picker, QWidget* parent )
: QwtWidgetOverlay( parent )
, m_picker( picker )
{
setMaskMode( QwtWidgetOverlay::MaskHint );
}
protected:
virtual void drawOverlay( QPainter* painter ) const QWT_OVERRIDE
{
painter->setPen( m_picker->trackerPen() );
m_picker->drawTracker( painter );
}
virtual QRegion maskHint() const QWT_OVERRIDE
{
return m_picker->trackerMask();
}
QwtPicker* m_picker;
};
}
class QwtPicker::PrivateData
{
public:
PrivateData():
enabled( false ),
stateMachine( NULL ),
resizeMode( QwtPicker::Stretch ),
rubberBand( QwtPicker::NoRubberBand ),
trackerMode( QwtPicker::AlwaysOff ),
isActive( false ),
trackerPosition( -1, -1 ),
mouseTracking( false ),
openGL( false )
{
}
bool enabled;
QwtPickerMachine* stateMachine;
QwtPicker::ResizeMode resizeMode;
QwtPicker::RubberBand rubberBand;
QPen rubberBandPen;
QwtPicker::DisplayMode trackerMode;
QPen trackerPen;
QFont trackerFont;
QPolygon pickedPoints;
bool isActive;
QPoint trackerPosition;
bool mouseTracking; // used to save previous value
QPointer< Rubberband > rubberBandOverlay;
QPointer< Tracker > trackerOverlay;
bool openGL;
};
/*!
Constructor
Creates an picker that is enabled, but without a state machine.
rubber band and tracker are disabled.
\param parent Parent widget, that will be observed
*/
QwtPicker::QwtPicker( QWidget* parent ):
QObject( parent )
{
init( parent, NoRubberBand, AlwaysOff );
}
/*!
Constructor
\param rubberBand Rubber band style
\param trackerMode Tracker mode
\param parent Parent widget, that will be observed
*/
QwtPicker::QwtPicker( RubberBand rubberBand,
DisplayMode trackerMode, QWidget* parent ):
QObject( parent )
{
init( parent, rubberBand, trackerMode );
}
//! Destructor
QwtPicker::~QwtPicker()
{
setMouseTracking( false );
delete m_data->stateMachine;
delete m_data->rubberBandOverlay;
delete m_data->trackerOverlay;
delete m_data;
}
//! Initialize the picker - used by the constructors
void QwtPicker::init( QWidget* parent,
RubberBand rubberBand, DisplayMode trackerMode )
{
m_data = new PrivateData;
m_data->rubberBand = rubberBand;
if ( parent )
{
if ( parent->focusPolicy() == Qt::NoFocus )
parent->setFocusPolicy( Qt::WheelFocus );
m_data->openGL = parent->inherits( "QGLWidget" );
m_data->trackerFont = parent->font();
m_data->mouseTracking = parent->hasMouseTracking();
setEnabled( true );
}
setTrackerMode( trackerMode );
}
/*!
Set a state machine and delete the previous one
\param stateMachine State machine
\sa stateMachine()
*/
void QwtPicker::setStateMachine( QwtPickerMachine* stateMachine )
{
if ( m_data->stateMachine != stateMachine )
{
reset();
delete m_data->stateMachine;
m_data->stateMachine = stateMachine;
if ( m_data->stateMachine )
m_data->stateMachine->reset();
}
}
/*!
\return Assigned state machine
\sa setStateMachine()
*/
QwtPickerMachine* QwtPicker::stateMachine()
{
return m_data->stateMachine;
}
/*!
\return Assigned state machine
\sa setStateMachine()
*/
const QwtPickerMachine* QwtPicker::stateMachine() const
{
return m_data->stateMachine;
}
//! Return the parent widget, where the selection happens
QWidget* QwtPicker::parentWidget()
{
QObject* obj = parent();
if ( obj && obj->isWidgetType() )
return static_cast< QWidget* >( obj );
return NULL;
}
//! Return the parent widget, where the selection happens
const QWidget* QwtPicker::parentWidget() const
{
QObject* obj = parent();
if ( obj && obj->isWidgetType() )
return static_cast< const QWidget* >( obj );
return NULL;
}
/*!
Set the rubber band style
\param rubberBand Rubber band style
The default value is NoRubberBand.
\sa rubberBand(), RubberBand, setRubberBandPen()
*/
void QwtPicker::setRubberBand( RubberBand rubberBand )
{
m_data->rubberBand = rubberBand;
}
/*!
\return Rubber band style
\sa setRubberBand(), RubberBand, rubberBandPen()
*/
QwtPicker::RubberBand QwtPicker::rubberBand() const
{
return m_data->rubberBand;
}
/*!
\brief Set the display mode of the tracker.
A tracker displays information about current position of
the cursor as a string. The display mode controls
if the tracker has to be displayed whenever the observed
widget has focus and cursor (AlwaysOn), never (AlwaysOff), or
only when the selection is active (ActiveOnly).
\param mode Tracker display mode
\warning In case of AlwaysOn, mouseTracking will be enabled
for the observed widget.
\sa trackerMode(), DisplayMode
*/
void QwtPicker::setTrackerMode( DisplayMode mode )
{
if ( m_data->trackerMode != mode )
{
m_data->trackerMode = mode;
setMouseTracking( m_data->trackerMode == AlwaysOn );
}
}
/*!
\return Tracker display mode
\sa setTrackerMode(), DisplayMode
*/
QwtPicker::DisplayMode QwtPicker::trackerMode() const
{
return m_data->trackerMode;
}
/*!
\brief Set the resize mode.
The resize mode controls what to do with the selected points of an active
selection when the observed widget is resized.
Stretch means the points are scaled according to the new
size, KeepSize means the points remain unchanged.
The default mode is Stretch.
\param mode Resize mode
\sa resizeMode(), ResizeMode
*/
void QwtPicker::setResizeMode( ResizeMode mode )
{
m_data->resizeMode = mode;
}
/*!
\return Resize mode
\sa setResizeMode(), ResizeMode
*/
QwtPicker::ResizeMode QwtPicker::resizeMode() const
{
return m_data->resizeMode;
}
/*!
\brief En/disable the picker
When enabled is true an event filter is installed for
the observed widget, otherwise the event filter is removed.
\param enabled true or false
\sa isEnabled(), eventFilter()
*/
void QwtPicker::setEnabled( bool enabled )
{
if ( m_data->enabled != enabled )
{
m_data->enabled = enabled;
QWidget* w = parentWidget();
if ( w )
{
if ( enabled )
w->installEventFilter( this );
else
w->removeEventFilter( this );
}
updateDisplay();
}
}
/*!
\return true when enabled, false otherwise
\sa setEnabled(), eventFilter()
*/
bool QwtPicker::isEnabled() const
{
return m_data->enabled;
}
/*!
Set the font for the tracker
\param font Tracker font
\sa trackerFont(), setTrackerMode(), setTrackerPen()
*/
void QwtPicker::setTrackerFont( const QFont& font )
{
if ( font != m_data->trackerFont )
{
m_data->trackerFont = font;
updateDisplay();
}
}
/*!
\return Tracker font
\sa setTrackerFont(), trackerMode(), trackerPen()
*/
QFont QwtPicker::trackerFont() const
{
return m_data->trackerFont;
}
/*!
Set the pen for the tracker
\param pen Tracker pen
\sa trackerPen(), setTrackerMode(), setTrackerFont()
*/
void QwtPicker::setTrackerPen( const QPen& pen )
{
if ( pen != m_data->trackerPen )
{
m_data->trackerPen = pen;
updateDisplay();
}
}
/*!
\return Tracker pen
\sa setTrackerPen(), trackerMode(), trackerFont()
*/
QPen QwtPicker::trackerPen() const
{
return m_data->trackerPen;
}
/*!
Set the pen for the rubberband
\param pen Rubber band pen
\sa rubberBandPen(), setRubberBand()
*/
void QwtPicker::setRubberBandPen( const QPen& pen )
{
if ( pen != m_data->rubberBandPen )
{
m_data->rubberBandPen = pen;
updateDisplay();
}
}
/*!
\return Rubber band pen
\sa setRubberBandPen(), rubberBand()
*/
QPen QwtPicker::rubberBandPen() const
{
return m_data->rubberBandPen;
}
/*!
\brief Return the label for a position
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 string conversion is "%d".
\param pos Position
\return Converted position as string
*/
QwtText QwtPicker::trackerText( const QPoint& pos ) const
{
QString label;
switch ( rubberBand() )
{
case HLineRubberBand:
label = QString::number( pos.y() );
break;
case VLineRubberBand:
label = QString::number( pos.x() );
break;
default:
label = QString::number( pos.x() ) + ", " + QString::number( pos.y() );
}
return label;
}
/*!
Calculate the mask for the tracker overlay
\return Region with one rectangle: trackerRect( trackerFont() );
\sa QWidget::setMask(), trackerRect()
*/
QRegion QwtPicker::trackerMask() const
{
return trackerRect( m_data->trackerFont );
}
/*!
Calculate the mask for the rubber band overlay
\return Region for the mask
\sa QWidget::setMask()
*/
QRegion QwtPicker::rubberBandMask() const
{
QRegion mask;
if ( !isActive() || rubberBand() == NoRubberBand ||
rubberBandPen().style() == Qt::NoPen )
{
return mask;
}
const QPolygon pa = adjustedPoints( m_data->pickedPoints );
QwtPickerMachine::SelectionType selectionType =
QwtPickerMachine::NoSelection;
if ( m_data->stateMachine )
selectionType = m_data->stateMachine->selectionType();
const int pw = qCeil( rubberBandPen().widthF()
* QwtPainter::devicePixelRatio( parentWidget() ) );
switch ( selectionType )
{
case QwtPickerMachine::NoSelection:
case QwtPickerMachine::PointSelection:
{
if ( pa.count() < 1 )
return mask;
const QPoint pos = pa[0];
const QRect pRect = pickArea().boundingRect().toRect();
switch ( rubberBand() )
{
case VLineRubberBand:
{
mask += qwtMaskRegion( QLine( pos.x(), pRect.top(),
pos.x(), pRect.bottom() ), pw );
break;
}
case HLineRubberBand:
{
mask += qwtMaskRegion( QLine( pRect.left(), pos.y(),
pRect.right(), pos.y() ), pw );
break;
}
case CrossRubberBand:
{
mask += qwtMaskRegion( QLine( pos.x(), pRect.top(),
pos.x(), pRect.bottom() ), pw );
mask += qwtMaskRegion( QLine( pRect.left(), pos.y(),
pRect.right(), pos.y() ), pw );
break;
}
default:
break;
}
break;
}
case QwtPickerMachine::RectSelection:
{
if ( pa.count() < 2 )
return mask;
switch ( rubberBand() )
{
case RectRubberBand:
{
const QRect r = QRect( pa.first(), pa.last() );
mask = qwtMaskRegion( r.normalized(), pw );
break;
}
case EllipseRubberBand:
{
const QRect r = QRect( pa.first(), pa.last() );
mask += r.adjusted( -pw, -pw, pw, pw );
break;
}
default:
break;
}
break;
}
case QwtPickerMachine::PolygonSelection:
{
if ( pw <= 1 )
{
// because of the join style we better
// return a mask for a pen width <= 1 only
const int off = 2 * pw;
const QRect r = pa.boundingRect();
mask += r.adjusted( -off, -off, off, off );
}
break;
}
default:
break;
}
return mask;
}
/*!
Draw a rubber band, depending on rubberBand()
\param painter Painter, initialized with a clip region
\sa rubberBand(), RubberBand
*/
void QwtPicker::drawRubberBand( QPainter* painter ) const
{
if ( !isActive() || rubberBand() == NoRubberBand ||
rubberBandPen().style() == Qt::NoPen )
{
return;
}
const QPolygon pa = adjustedPoints( m_data->pickedPoints );
QwtPickerMachine::SelectionType selectionType =
QwtPickerMachine::NoSelection;
if ( m_data->stateMachine )
selectionType = m_data->stateMachine->selectionType();
switch ( selectionType )
{
case QwtPickerMachine::NoSelection:
case QwtPickerMachine::PointSelection:
{
if ( pa.count() < 1 )
return;
const QPoint pos = pa[0];
const QRect pRect = pickArea().boundingRect().toRect();
switch ( rubberBand() )
{
case VLineRubberBand:
{
QwtPainter::drawLine( painter, pos.x(),
pRect.top(), pos.x(), pRect.bottom() );
break;
}
case HLineRubberBand:
{
QwtPainter::drawLine( painter, pRect.left(),
pos.y(), pRect.right(), pos.y() );
break;
}
case CrossRubberBand:
{
QwtPainter::drawLine( painter, pos.x(),
pRect.top(), pos.x(), pRect.bottom() );
QwtPainter::drawLine( painter, pRect.left(),
pos.y(), pRect.right(), pos.y() );
break;
}
default:
break;
}
break;
}
case QwtPickerMachine::RectSelection:
{
if ( pa.count() < 2 )
return;
const QRect rect = QRect( pa.first(), pa.last() ).normalized();
switch ( rubberBand() )
{
case EllipseRubberBand:
{
QwtPainter::drawEllipse( painter, rect );
break;
}
case RectRubberBand:
{
QwtPainter::drawRect( painter, rect );
break;
}
default:
break;
}
break;
}
case QwtPickerMachine::PolygonSelection:
{
if ( rubberBand() == PolygonRubberBand )
painter->drawPolyline( pa );
break;
}
default:
break;
}
}
/*!
Draw the tracker
\param painter Painter
\sa trackerRect(), trackerText()
*/
void QwtPicker::drawTracker( QPainter* painter ) const
{
const QRect textRect = trackerRect( painter->font() );
if ( !textRect.isEmpty() )
{
const QwtText label = trackerText( m_data->trackerPosition );
if ( !label.isEmpty() )
label.draw( painter, textRect );
}
}
/*!
\brief Map the pickedPoints() into a selection()
adjustedPoints() maps the points, that have been collected on
the parentWidget() into a selection(). The default implementation
simply returns the points unmodified.
The reason, why a selection() differs from the picked points
depends on the application requirements. F.e. :
- A rectangular selection might need to have a specific aspect ratio only.
- A selection could accept non intersecting polygons only.
- ...
The example below is for a rectangular selection, where the first
point is the center of the selected rectangle.
\par Example
\code
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;
}
\endcode
\param points Selected points
\return Selected points unmodified
*/
QPolygon QwtPicker::adjustedPoints( const QPolygon& points ) const
{
return points;
}
/*!
\return Selected points
\sa pickedPoints(), adjustedPoints()
*/
QPolygon QwtPicker::selection() const
{
return adjustedPoints( m_data->pickedPoints );
}
//! \return Current position of the tracker
QPoint QwtPicker::trackerPosition() const
{
return m_data->trackerPosition;
}
/*!
Calculate the bounding rectangle for the tracker text
from the current position of the tracker
\param font Font of the tracker text
\return Bounding rectangle of the tracker text
\sa trackerPosition()
*/
QRect QwtPicker::trackerRect( const QFont& font ) const
{
if ( trackerMode() == AlwaysOff ||
( trackerMode() == ActiveOnly && !isActive() ) )
{
return QRect();
}
if ( m_data->trackerPosition.x() < 0 || m_data->trackerPosition.y() < 0 )
return QRect();
QwtText text = trackerText( m_data->trackerPosition );
if ( text.isEmpty() )
return QRect();
const QSizeF textSize = text.textSize( font );
const int w = qwtCeil( textSize.width() );
const int h = qwtCeil( textSize.height() );
return trackerRect( QSize( w, h ) );
}
/*!
Calculate the geometry of the tracker that is needed to display
information of a specific size at the tracker position
\param size Size
\return Bounding rectangle of the tracker
\sa trackerPosition()
*/
QRect QwtPicker::trackerRect( const QSize& size ) const
{
const QPoint& pos = m_data->trackerPosition;
QRect infoRect( 0, 0, size.width(), size.height() );
int alignment = 0;
if ( isActive() && m_data->pickedPoints.count() > 1
&& rubberBand() != NoRubberBand )
{
const QPoint last =
m_data->pickedPoints[ m_data->pickedPoints.count() - 2 ];
alignment |= ( pos.x() >= last.x() ) ? Qt::AlignRight : Qt::AlignLeft;
alignment |= ( pos.y() > last.y() ) ? Qt::AlignBottom : Qt::AlignTop;
}
else
{
alignment = Qt::AlignTop | Qt::AlignRight;
}
const int margin = 5;
int x = pos.x();
if ( alignment & Qt::AlignLeft )
x -= infoRect.width() + margin;
else if ( alignment & Qt::AlignRight )
x += margin;
int y = pos.y();
if ( alignment & Qt::AlignBottom )
y += margin;
else if ( alignment & Qt::AlignTop )
y -= infoRect.height() + margin;
infoRect.moveTopLeft( QPoint( x, y ) );
const QRect pickRect = pickArea().boundingRect().toRect();
int right = qMin( infoRect.right(), pickRect.right() - margin );
int bottom = qMin( infoRect.bottom(), pickRect.bottom() - margin );
infoRect.moveBottomRight( QPoint( right, bottom ) );
int left = qMax( infoRect.left(), pickRect.left() + margin );
int top = qMax( infoRect.top(), pickRect.top() + margin );
infoRect.moveTopLeft( QPoint( left, top ) );
return infoRect;
}
/*!
\brief Event filter
When isEnabled() is true all events of the observed widget are filtered.
Mouse and keyboard events are translated into widgetMouse- and widgetKey-
and widgetWheel-events. Paint and Resize events are handled to keep
rubber band and tracker up to date.
\param object Object to be filtered
\param event Event
\return Always false.
\sa widgetEnterEvent(), widgetLeaveEvent(),
widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent(),
QObject::installEventFilter(), QObject::event()
*/
bool QwtPicker::eventFilter( QObject* object, QEvent* event )
{
if ( object && object == parentWidget() )
{
switch ( event->type() )
{
case QEvent::Resize:
{
const QResizeEvent* re = static_cast< QResizeEvent* >( event );
/*
Adding/deleting additional event filters inside of an event filter
is not safe dues to the implementation in Qt ( changing a list while iterating ).
So we create the overlays in a way, that they don't install en event filter
( parent set to NULL ) and do the resizing here.
*/
if ( m_data->trackerOverlay )
m_data->trackerOverlay->resize( re->size() );
if ( m_data->rubberBandOverlay )
m_data->rubberBandOverlay->resize( re->size() );
if ( m_data->resizeMode == Stretch )
stretchSelection( re->oldSize(), re->size() );
updateDisplay();
break;
}
case QEvent::Enter:
{
widgetEnterEvent( event );
break;
}
case QEvent::Leave:
{
widgetLeaveEvent( event );
break;
}
case QEvent::MouseButtonPress:
{
widgetMousePressEvent( static_cast< QMouseEvent* >( event ) );
break;
}
case QEvent::MouseButtonRelease:
{
widgetMouseReleaseEvent( static_cast< QMouseEvent* >( event ) );
break;
}
case QEvent::MouseButtonDblClick:
{
widgetMouseDoubleClickEvent( static_cast< QMouseEvent* >( event ) );
break;
}
case QEvent::MouseMove:
{
widgetMouseMoveEvent( static_cast< QMouseEvent* >( event ) );
break;
}
case QEvent::KeyPress:
{
widgetKeyPressEvent( static_cast< QKeyEvent* >( event ) );
break;
}
case QEvent::KeyRelease:
{
widgetKeyReleaseEvent( static_cast< QKeyEvent* >( event ) );
break;
}
case QEvent::Wheel:
{
widgetWheelEvent( static_cast< QWheelEvent* >( event ) );
break;
}
default:
break;
}
}
return false;
}
/*!
Handle a mouse press event for the observed widget.
\param mouseEvent Mouse event
\sa eventFilter(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetMousePressEvent( QMouseEvent* mouseEvent )
{
transition( mouseEvent );
}
/*!
Handle a mouse move event for the observed widget.
\param mouseEvent Mouse event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetMouseMoveEvent( QMouseEvent* mouseEvent )
{
if ( pickArea().contains( mouseEvent->pos() ) )
m_data->trackerPosition = mouseEvent->pos();
else
m_data->trackerPosition = QPoint( -1, -1 );
if ( !isActive() )
updateDisplay();
transition( mouseEvent );
}
/*!
Handle a enter event for the observed widget.
\param event Qt event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetEnterEvent( QEvent* event )
{
transition( event );
}
/*!
Handle a leave event for the observed widget.
\param event Qt event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetLeaveEvent( QEvent* event )
{
transition( event );
m_data->trackerPosition = QPoint( -1, -1 );
if ( !isActive() )
updateDisplay();
}
/*!
Handle a mouse release event for the observed widget.
\param mouseEvent Mouse event
\sa eventFilter(), widgetMousePressEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetMouseReleaseEvent( QMouseEvent* mouseEvent )
{
transition( mouseEvent );
}
/*!
Handle mouse double click event for the observed widget.
\param mouseEvent Mouse event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetMouseDoubleClickEvent( QMouseEvent* mouseEvent )
{
transition( mouseEvent );
}
/*!
Handle a wheel event for the observed widget.
Move the last point of the selection in case of isActive() == true
\param wheelEvent Wheel event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetKeyPressEvent(), widgetKeyReleaseEvent()
*/
void QwtPicker::widgetWheelEvent( QWheelEvent* wheelEvent )
{
#if QT_VERSION < 0x050e00
const QPoint wheelPos = wheelEvent->pos();
#else
const QPoint wheelPos = wheelEvent->position().toPoint();
#endif
if ( pickArea().contains( wheelPos ) )
m_data->trackerPosition = wheelPos;
else
m_data->trackerPosition = QPoint( -1, -1 );
updateDisplay();
transition( wheelEvent );
}
/*!
Handle a key press event for the observed widget.
Selections can be completely done by the keyboard. The arrow keys
move the cursor, the abort key aborts a selection. All other keys
are handled by the current state machine.
\param keyEvent Key event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyReleaseEvent(), stateMachine(),
QwtEventPattern::KeyPatternCode
*/
void QwtPicker::widgetKeyPressEvent( QKeyEvent* keyEvent )
{
int dx = 0;
int dy = 0;
int offset = 1;
if ( keyEvent->isAutoRepeat() )
offset = 5;
if ( keyMatch( KeyLeft, keyEvent ) )
dx = -offset;
else if ( keyMatch( KeyRight, keyEvent ) )
dx = offset;
else if ( keyMatch( KeyUp, keyEvent ) )
dy = -offset;
else if ( keyMatch( KeyDown, keyEvent ) )
dy = offset;
else if ( keyMatch( KeyAbort, keyEvent ) )
{
reset();
}
else
transition( keyEvent );
if ( dx != 0 || dy != 0 )
{
const QRect rect = pickArea().boundingRect().toRect();
const QPoint pos = parentWidget()->mapFromGlobal( QCursor::pos() );
int x = pos.x() + dx;
x = qMax( rect.left(), x );
x = qMin( rect.right(), x );
int y = pos.y() + dy;
y = qMax( rect.top(), y );
y = qMin( rect.bottom(), y );
QCursor::setPos( parentWidget()->mapToGlobal( QPoint( x, y ) ) );
}
}
/*!
Handle a key release event for the observed widget.
Passes the event to the state machine.
\param keyEvent Key event
\sa eventFilter(), widgetMousePressEvent(), widgetMouseReleaseEvent(),
widgetMouseDoubleClickEvent(), widgetMouseMoveEvent(),
widgetWheelEvent(), widgetKeyPressEvent(), stateMachine()
*/
void QwtPicker::widgetKeyReleaseEvent( QKeyEvent* keyEvent )
{
transition( keyEvent );
}
/*!
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() ).
\param event Event
*/
void QwtPicker::transition( const QEvent* event )
{
if ( !m_data->stateMachine )
return;
const QList< QwtPickerMachine::Command > commandList =
m_data->stateMachine->transition( *this, event );
QPoint pos;
switch ( event->type() )
{
case QEvent::MouseButtonDblClick:
case QEvent::MouseButtonPress:
case QEvent::MouseButtonRelease:
case QEvent::MouseMove:
{
const QMouseEvent* me =
static_cast< const QMouseEvent* >( event );
pos = me->pos();
break;
}
default:
pos = parentWidget()->mapFromGlobal( QCursor::pos() );
}
for ( int i = 0; i < commandList.count(); i++ )
{
switch ( commandList[i] )
{
case QwtPickerMachine::Begin:
{
begin();
break;
}
case QwtPickerMachine::Append:
{
append( pos );
break;
}
case QwtPickerMachine::Move:
{
move( pos );
break;
}
case QwtPickerMachine::Remove:
{
remove();
break;
}
case QwtPickerMachine::End:
{
end();
break;
}
}
}
}
/*!
Open a selection setting the state to active
\sa isActive(), end(), append(), move()
*/
void QwtPicker::begin()
{
if ( m_data->isActive )
return;
m_data->pickedPoints.clear();
m_data->isActive = true;
Q_EMIT activated( true );
if ( trackerMode() != AlwaysOff )
{
if ( m_data->trackerPosition.x() < 0 || m_data->trackerPosition.y() < 0 )
{
QWidget* w = parentWidget();
if ( w )
m_data->trackerPosition = w->mapFromGlobal( QCursor::pos() );
}
}
updateDisplay();
setMouseTracking( true );
}
/*!
\brief Close a selection setting the state to inactive.
The selection is validated and maybe fixed by accept().
\param ok If true, complete the selection and emit a selected signal
otherwise discard the selection.
\return true if the selection is accepted, false otherwise
\sa isActive(), begin(), append(), move(), selected(), accept()
*/
bool QwtPicker::end( bool ok )
{
if ( m_data->isActive )
{
setMouseTracking( false );
m_data->isActive = false;
Q_EMIT activated( false );
if ( trackerMode() == ActiveOnly )
m_data->trackerPosition = QPoint( -1, -1 );
if ( ok )
ok = accept( m_data->pickedPoints );
if ( ok )
Q_EMIT selected( m_data->pickedPoints );
else
m_data->pickedPoints.clear();
updateDisplay();
}
else
ok = false;
return ok;
}
/*!
Reset the state machine and terminate ( end(false) ) the selection
*/
void QwtPicker::reset()
{
if ( m_data->stateMachine )
m_data->stateMachine->reset();
if ( isActive() )
end( false );
}
/*!
Append a point to the selection and update rubber band and tracker.
The appended() signal is emitted.
\param pos Additional point
\sa isActive(), begin(), end(), move(), appended()
*/
void QwtPicker::append( const QPoint& pos )
{
if ( m_data->isActive )
{
m_data->pickedPoints += pos;
updateDisplay();
Q_EMIT appended( pos );
}
}
/*!
Move the last point of the selection
The moved() signal is emitted.
\param pos New position
\sa isActive(), begin(), end(), append()
*/
void QwtPicker::move( const QPoint& pos )
{
if ( m_data->isActive && !m_data->pickedPoints.isEmpty() )
{
QPoint& point = m_data->pickedPoints.last();
if ( point != pos )
{
point = pos;
updateDisplay();
Q_EMIT moved( pos );
}
}
}
/*!
Remove the last point of the selection
The removed() signal is emitted.
\sa isActive(), begin(), end(), append(), move()
*/
void QwtPicker::remove()
{
if ( m_data->isActive && !m_data->pickedPoints.isEmpty() )
{
#if QT_VERSION >= 0x050100
const QPoint pos = m_data->pickedPoints.takeLast();
#else
const QPoint pos = m_data->pickedPoints.last();
m_data->pickedPoints.resize( m_data->pickedPoints.count() - 1 );
#endif
updateDisplay();
Q_EMIT removed( pos );
}
}
/*!
\brief Validate and fix up the selection
Accepts all selections unmodified
\param selection Selection to validate and fix up
\return true, when accepted, false otherwise
*/
bool QwtPicker::accept( QPolygon& selection ) const
{
Q_UNUSED( selection );
return true;
}
/*!
A picker is active between begin() and end().
\return true if the selection is active.
*/
bool QwtPicker::isActive() const
{
return m_data->isActive;
}
/*!
Return the points, that have been collected so far. The selection()
is calculated from the pickedPoints() in adjustedPoints().
\return Picked points
*/
const QPolygon& QwtPicker::pickedPoints() const
{
return m_data->pickedPoints;
}
/*!
Scale the selection by the ratios of oldSize and newSize
The changed() signal is emitted.
\param oldSize Previous size
\param newSize Current size
\sa ResizeMode, setResizeMode(), resizeMode()
*/
void QwtPicker::stretchSelection( const QSize& oldSize, const QSize& newSize )
{
if ( oldSize.isEmpty() )
{
// avoid division by zero. But scaling for small sizes also
// doesn't make much sense, because of rounding losses. TODO ...
return;
}
const double xRatio = double( newSize.width() ) / double( oldSize.width() );
const double yRatio = double( newSize.height() ) / double( oldSize.height() );
for ( int i = 0; i < m_data->pickedPoints.count(); i++ )
{
QPoint& p = m_data->pickedPoints[i];
p.setX( qRound( p.x() * xRatio ) );
p.setY( qRound( p.y() * yRatio ) );
Q_EMIT changed( m_data->pickedPoints );
}
}
/*!
Set mouse tracking for the observed widget.
In case of enable is true, the previous value
is saved, that is restored when enable is false.
\warning Even when enable is false, mouse tracking might be restored
to true. When mouseTracking for the observed widget
has been changed directly by QWidget::setMouseTracking
while mouse tracking has been set to true, this value can't
be restored.
*/
void QwtPicker::setMouseTracking( bool enable )
{
QWidget* widget = parentWidget();
if ( !widget )
return;
if ( enable )
{
m_data->mouseTracking = widget->hasMouseTracking();
widget->setMouseTracking( true );
}
else
{
widget->setMouseTracking( m_data->mouseTracking );
}
}
/*!
Find the area of the observed widget, where selection might happen.
\return parentWidget()->contentsRect()
*/
QPainterPath QwtPicker::pickArea() const
{
QPainterPath path;
const QWidget* widget = parentWidget();
if ( widget )
path.addRect( widget->contentsRect() );
return path;
}
//! Update the state of rubber band and tracker label
void QwtPicker::updateDisplay()
{
QWidget* w = parentWidget();
bool showRubberband = false;
bool showTracker = false;
if ( w && w->isVisible() && m_data->enabled )
{
if ( rubberBand() != NoRubberBand && isActive() &&
rubberBandPen().style() != Qt::NoPen )
{
showRubberband = true;
}
if ( trackerMode() == AlwaysOn ||
( trackerMode() == ActiveOnly && isActive() ) )
{
if ( trackerPen() != Qt::NoPen
&& !trackerRect( QFont() ).isEmpty() )
{
showTracker = true;
}
}
}
QPointer< Rubberband >& rw = m_data->rubberBandOverlay;
if ( showRubberband )
{
if ( rw.isNull() )
{
rw = new Rubberband( this, NULL ); // NULL -> no extra event filter
rw->setObjectName( "PickerRubberBand" );
rw->setParent( w );
rw->resize( w->size() );
}
if ( m_data->rubberBand <= RectRubberBand )
rw->setMaskMode( QwtWidgetOverlay::MaskHint );
else
rw->setMaskMode( QwtWidgetOverlay::AlphaMask );
rw->updateOverlay();
}
else
{
if ( m_data->openGL )
{
// Qt 4.8 crashes for a delete
if ( !rw.isNull() )
{
rw->hide();
rw->deleteLater();
rw = NULL;
}
}
else
{
delete rw;
}
}
QPointer< Tracker >& tw = m_data->trackerOverlay;
if ( showTracker )
{
if ( tw.isNull() )
{
tw = new Tracker( this, NULL ); // NULL -> no extra event filter
tw->setObjectName( "PickerTracker" );
tw->setParent( w );
tw->resize( w->size() );
}
tw->setFont( m_data->trackerFont );
tw->updateOverlay();
}
else
{
if ( m_data->openGL )
{
// Qt 4.8 crashes for a delete
if ( !tw.isNull() )
{
tw->hide();
tw->deleteLater();
tw = NULL;
}
}
else
{
delete tw;
}
}
}
//! \return Overlay displaying the rubber band
const QwtWidgetOverlay* QwtPicker::rubberBandOverlay() const
{
return m_data->rubberBandOverlay;
}
//! \return Overlay displaying the tracker text
const QwtWidgetOverlay* QwtPicker::trackerOverlay() const
{
return m_data->trackerOverlay;
}
#include "moc_qwt_picker.cpp"