QwtPlotZoomer - Man Page

enum DisplayMode { AlwaysOff, AlwaysOn, ActiveOnly }
enum KeyPatternCode { KeySelect1, KeySelect2, KeyAbort, KeyLeft, KeyRight, KeyUp, KeyDown, KeyRedo, KeyUndo, KeyHome, KeyPatternCount }
enum MousePatternCode { MouseSelect1, MouseSelect2, MouseSelect3, MouseSelect4, MouseSelect5, MouseSelect6, MousePatternCount }
enum RectSelectionType { CornerToCorner =  64, CenterToCorner =  128, CenterToRadius =  256 }
enum ResizeMode { Stretch, KeepSize }
enum RubberBand { NoRubberBand =  0, HLineRubberBand, VLineRubberBand, CrossRubberBand, RectRubberBand, EllipseRubberBand, PolygonRubberBand, UserRubberBand =  100 }
enum SelectionMode { ClickSelection =  1024, DragSelection =  2048 }
enum SelectionType { NoSelection =  0, PointSelection =  1, RectSelection =  2, PolygonSelection =  4 }

virtual void move (double x, double y)
void moveBy (double x, double y)
virtual void zoom (const QwtDoubleRect &)
virtual void zoom (int up)

void appended (const QwtDoublePoint &pos)
void appended (const QPoint &pos)
void changed (const QwtPolygon &pa)
void moved (const QPoint &pos)
void moved (const QwtDoublePoint &pos)
void selected (const QwtDoubleRect &rect)
void selected (const QwtDoublePoint &pos)
void selected (const QwtArray< QwtDoublePoint > &pa)
void selected (const QwtPolygon &pa)
void zoomed (const QwtDoubleRect &rect)

QwtPlotCanvas * canvas ()
const QwtPlotCanvas * canvas () const
virtual void drawRubberBand (QPainter *) const
virtual void drawTracker (QPainter *) const
virtual bool eventFilter (QObject *, QEvent *)
void initKeyPattern ()
void initMousePattern (int numButtons)
bool isActive () const
bool isEnabled () const
bool keyMatch (uint pattern, const QKeyEvent *) const
const QwtArray< KeyPattern > & keyPattern () const
QwtArray< KeyPattern > & keyPattern ()
int maxStackDepth () const
bool mouseMatch (uint pattern, const QMouseEvent *) const
const QwtArray< MousePattern > & mousePattern () const
QwtArray< MousePattern > & mousePattern ()
QWidget * parentWidget ()
const QWidget * parentWidget () const
virtual QRect pickRect () const
const QwtPlot * plot () const
QwtPlot * plot ()
QwtPlotZoomer (QwtPlotCanvas *, bool doReplot=true)
QwtPlotZoomer (int xAxis, int yAxis, QwtPlotCanvas *, bool doReplot=true)
QwtPlotZoomer (int xAxis, int yAxis, int selectionFlags, DisplayMode trackerMode, QwtPlotCanvas *, bool doReplot=true)
ResizeMode resizeMode () const
RubberBand rubberBand () const
QPen rubberBandPen () const
const QwtPolygon & selection () const
int selectionFlags () const
virtual void setAxis (int xAxis, int yAxis)
virtual void setEnabled (bool)
void setKeyPattern (uint pattern, int key, int state=Qt::NoButton)
void setKeyPattern (const QwtArray< KeyPattern > &)
void setMaxStackDepth (int)
void setMousePattern (const QwtArray< MousePattern > &)
void setMousePattern (uint pattern, int button, int state=Qt::NoButton)
virtual void setResizeMode (ResizeMode)
virtual void setRubberBand (RubberBand)
virtual void setRubberBandPen (const QPen &)
virtual void setSelectionFlags (int)
virtual void setTrackerFont (const QFont &)
virtual void setTrackerMode (DisplayMode)
virtual void setTrackerPen (const QPen &)
virtual void setZoomBase (bool doReplot=true)
virtual void setZoomBase (const QwtDoubleRect &)
void setZoomStack (const QStack< QwtDoubleRect > &, int zoomRectIndex=-1)
QFont trackerFont () const
DisplayMode trackerMode () const
QPen trackerPen () const
QPoint trackerPosition () const
QRect trackerRect (const QFont &) const
int xAxis () const
int yAxis () const
QwtDoubleRect zoomBase () const
QwtDoubleRect zoomRect () const
uint zoomRectIndex () const
const QStack< QwtDoubleRect > & zoomStack () const

virtual bool accept (QwtPolygon &) const
virtual void append (const QPoint &)
virtual void begin ()
virtual bool end (bool ok=true)
QwtDoubleRect invTransform (const QRect &) const
QwtDoublePoint invTransform (const QPoint &) const
virtual bool keyMatch (const KeyPattern &, const QKeyEvent *) const
virtual QwtDoubleSize minZoomSize () const
virtual bool mouseMatch (const MousePattern &, const QMouseEvent *) const
virtual void move (const QPoint &)
virtual void rescale ()
virtual void reset ()
const QWidget * rubberBandWidget () const
QwtDoubleRect scaleRect () const
virtual QwtPickerMachine * stateMachine (int) const
virtual void stretchSelection (const QSize &oldSize, const QSize &newSize)
virtual QwtText trackerText (const QwtDoublePoint &) const
virtual QwtText trackerText (const QPoint &) const
const QWidget * trackerWidget () const
QRect transform (const QwtDoubleRect &) const
QPoint transform (const QwtDoublePoint &) const
virtual void transition (const QEvent *)
virtual void updateDisplay ()
virtual void widgetKeyPressEvent (QKeyEvent *)
virtual void widgetKeyReleaseEvent (QKeyEvent *)
virtual void widgetLeaveEvent (QEvent *)
virtual void widgetMouseDoubleClickEvent (QMouseEvent *)
virtual void widgetMouseMoveEvent (QMouseEvent *)
virtual void widgetMousePressEvent (QMouseEvent *)
virtual void widgetMouseReleaseEvent (QMouseEvent *)
virtual void widgetWheelEvent (QWheelEvent *)

AlwaysOff
Display never.

• AlwaysOn
  Display always.
• ActiveOnly
  Display only when the selection is active.

See also:

Symbolic keyboard input codes. Default initialization:

• KeySelect1
  Qt::Key_Return
• KeySelect2
  Qt::Key_Space
• KeyAbort
  Qt::Key_Escape
• KeyLeft
  Qt::Key_Left
• KeyRight
  Qt::Key_Right
• KeyUp
  Qt::Key_Up
• KeyDown
  Qt::Key_Down
• KeyUndo
  Qt::Key_Minus
• KeyRedo
  Qt::Key_Plus
• KeyHome
  Qt::Key_Escape

Symbolic mouse input codes. The default initialization for 3 button mice is:

• MouseSelect1
  Qt::LeftButton
• MouseSelect2
  Qt::RightButton
• MouseSelect3
  Qt::MidButton
• MouseSelect4
  Qt::LeftButton + Qt::ShiftButton
• MouseSelect5
  Qt::RightButton + Qt::ShiftButton
• MouseSelect6
  Qt::MidButton + Qt::ShiftButton

The default initialization for 2 button mice is:

• MouseSelect1
  Qt::LeftButton
• MouseSelect2
  Qt::RightButton
• MouseSelect3
  Qt::LeftButton + Qt::AltButton
• MouseSelect4
  Qt::LeftButton + Qt::ShiftButton
• MouseSelect5
  Qt::RightButton + Qt::ShiftButton
• MouseSelect6
  Qt::LeftButton + Qt::AltButton + Qt::ShiftButton

The default initialization for 1 button mice is:

• MouseSelect1
  Qt::LeftButton
• MouseSelect2
  Qt::LeftButton + Qt::ControlButton
• MouseSelect3
  Qt::LeftButton + Qt::AltButton
• MouseSelect4
  Qt::LeftButton + Qt::ShiftButton
• MouseSelect5
  Qt::LeftButton + Qt::ControlButton + Qt::ShiftButton
• MouseSelect6
  Qt::LeftButton + Qt::AltButton + Qt::ShiftButton

See also:

Selection subtype for RectSelection This enum type describes the type of rectangle selections. It can be or'd with QwtPicker::RectSelectionType and QwtPicker::SelectionMode and passed to QwtPicker::setSelectionFlags().

• CornerToCorner
  The first and the second selected point are the corners of the rectangle.
• CenterToCorner
  The first point is the center, the second a corner of the rectangle.
• CenterToRadius
  The first point is the center of a quadrat, calculated by the maximum of the x- and y-distance.

The default value is CornerToCorner.

See also:

• Stretch
  All points are scaled according to the new size,
• KeepSize
  All points remain unchanged.

The default value is Stretch.

See also:

• NoRubberBand
  No rubberband.
• HLineRubberBand & PointSelection
  A horizontal line.
• VLineRubberBand & PointSelection
  A vertical line.
• CrossRubberBand & PointSelection
  A horizontal and a vertical line.
• RectRubberBand & RectSelection
  A rectangle.
• EllipseRubberBand & RectSelection
  An ellipse.
• PolygonRubberBand &PolygonSelection
  A polygon.
• UserRubberBand
  Values >= UserRubberBand can be used to define additional rubber bands.

The default value is NoRubberBand.

See also:

The default value is ClickSelection.

See also:

• NoSelection
  Selection is disabled. Note this is different to the disabled state, as you might have a tracker.
• PointSelection
  Select a single point.
• RectSelection
  Select a rectangle.
• PolygonSelection
  Select a polygon.

The default value is NoSelection.

See also:

Create a zoomer for a plot canvas. The zoomer is set to those x- and y-axis of the parent plot of the canvas 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.

The selectionFlags() are set to QwtPicker::RectSelection | QwtPicker::ClickSelection, the tracker mode to QwtPicker::ActiveOnly.

Parameters:

canvas Plot canvas to observe, also the parent object
doReplot Call replot for the attached plot before initializing the zoomer with its scales. This might be necessary, when the plot is in a state with pending scale changes.

See also:

QwtPlot::autoReplot(), QwtPlot::replot(), setZoomBase()

Create a zoomer for a plot canvas. The selectionFlags() are set to QwtPicker::RectSelection | QwtPicker::ClickSelection, the tracker mode to QwtPicker::ActiveOnly.

Parameters:

xAxis X axis of the zoomer
yAxis Y axis of the zoomer
canvas Plot canvas to observe, also the parent object
doReplot Call replot for the attached plot before initializing the zoomer with its scales. This might be necessary, when the plot is in a state with pending scale changes.

See also:

QwtPlot::autoReplot(), QwtPlot::replot(), setZoomBase()

Parameters:

xAxis X axis of the zoomer
yAxis Y axis of the zoomer
selectionFlags Or'd value of QwtPicker::RectSelectionType and QwtPicker::SelectionMode. QwtPicker::RectSelection will be auto added.
trackerMode Tracker mode
canvas Plot canvas to observe, also the parent object
doReplot Call replot for the attached plot before initializing the zoomer with its scales. This might be necessary, when the plot is in a state with pending scale changes.

See also:

QwtPicker, QwtPicker::setSelectionFlags(), QwtPicker::setRubberBand(), QwtPicker::setTrackerMode()

QwtPlot::autoReplot(), QwtPlot::replot(), setZoomBase()

Check and correct a selected rectangle. Reject rectangles with a hight or width < 2, otherwise expand the selected rectangle to a minimum size of 11x11 and accept it.

Returns:

true If rect is accepted, or has been changed to a accepted rectangle.

Reimplemented from QwtPicker.

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.

Parameters:

pos Position of the appended point.

See also:

append(). moved()

Parameters:

pos Position of the appended point.

See also:

append(). moved()

See also:

Reimplemented from QwtPicker.

Return observed plot canvas.

Return Observed plot canvas.

Parameters:

pa Changed selection

See also:

stretchSelection()

Parameters:

painter Painter, initialized with clip rect

See also:

rubberBand(), RubberBand, selectionFlags()

Parameters:

painter Painter

See also:

trackerRect(), trackerText()

See also:

Reimplemented from QwtPlotPicker.

Event filter. When isEnabled() == 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 rubberband and tracker up to date.

See also:

See also:

Parameters:

numButtons Number of mouse buttons ( <= 3 )

See also:

MousePatternCode

Returns:

Rectangle in plot coordinates

See also:

QwtPlotPicker::transform()

Returns:

Point in plot coordinates

See also:

QwtPlotPicker::transform()

Returns:

true if the selection is active.

See also:

Compare a key event with an event pattern. A key event matches the pattern when both have the same key value and in the state value the same key flags (Qt::KeyButtonMask) are set.

Parameters:

pattern Index of the event pattern
e Key event

Returns:

true if matches

See also:

mouseMatch()

Compare a key event with an event pattern. A key event matches the pattern when both have the same key value and in the state value the same key flags (Qt::KeyButtonMask) are set.

Parameters:

pattern Key event pattern
e Key event

Returns:

true if matches

See also:

mouseMatch()

Return key patterns.

Return Key patterns.

See also:

Limit zooming by a minimum rectangle. Returns:

Compare a mouse event with an event pattern. A mouse event matches the pattern when both have the same button value and in the state value the same key flags(Qt::KeyButtonMask) are set.

Parameters:

pattern Index of the event pattern
e Mouse event

Returns:

true if matches

See also:

keyMatch()

Compare a mouse event with an event pattern. A mouse event matches the pattern when both have the same button value and in the state value the same key flags(Qt::KeyButtonMask) are set.

Parameters:

pattern Mouse event pattern
e Mouse event

Returns:

true if matches

See also:

keyMatch()

Return ,ouse patterns.

Return mouse patterns.

Parameters:

pos New position

See also:

isActive, begin(), end(), append()

Note:

The moved(const QPoint &), moved(const QDoublePoint &) signals are emitted.

Reimplemented from QwtPicker.

Parameters:

x X value
y Y value

See also:

QwtDoubleRect::move()

Note:

The changed rectangle is limited by the zoom base

Parameters:

dx X offset
dy Y offset

Note:

The changed rectangle is limited by the zoom base

Parameters:

pos Position of the moved last point of the selection.

See also:

move(), appended()

Parameters:

pos Position of the moved last point of the selection.

See also:

move(), appended()

Return the parent widget, where the selection happens.

Return the parent widget, where the selection happens.

Returns:

QFrame::contentsRect() if it is a QFrame, QWidget::rect() otherwise.

Return plot widget, containing the observed plot canvas.

Return plot widget, containing the observed plot canvas.

Note:

Initiates QwtPlot::replot

See also:

See also:

See also:

See also:

Parameters:

pa Selected points

Parameters:

pa Selected points

Parameters:

pos Selected point

Parameters:

rect Selected rectangle

Return Selected points.

See also:

Parameters:

xAxis X axis
yAxis Y axis

Reimplemented from QwtPlotPicker.

En/disable the picker. When enabled is true an event filter is installed for the observed widget, otherwise the event filter is removed.

Parameters:

enabled true or false

See also:

isEnabled(), eventFilter()

Change the key event patterns.

Parameters:

pattern Index of the pattern
key Key
state State

See also:

QKeyEvent

Limit the number of recursive zoom operations to depth. A value of -1 set the depth to unlimited, 0 disables zooming. If the current zoom rectangle is below depth, the plot is unzoomed.

Parameters:

depth Maximum for the stack depth

See also:

maxStackDepth()

Note:

depth doesn't include the zoom base, so zoomStack().count() might be maxStackDepth() + 1.

Change the mouse event patterns.

Parameters:

pattern Index of the pattern
button Button
state State

See also:

QMouseEvent

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.

Parameters:

mode Resize mode

See also:

resizeMode(), ResizeMode

Parameters:

rubberBand Rubberband style The default value is NoRubberBand.

See also:

rubberBand(), RubberBand, setRubberBandPen()

Parameters:

pen Rubberband pen

See also:

rubberBandPen(), setRubberBand()

Parameters:

flags Or'd value of QwtPicker::RectSelectionType and QwtPicker::SelectionMode. The default value is QwtPicker::RectSelection & QwtPicker::ClickSelection.

See also:

selectionFlags(), SelectionType, RectSelectionType, SelectionMode

Note:

QwtPicker::RectSelection will be auto added.

Reimplemented from QwtPicker.

Parameters:

font Tracker font

See also:

trackerFont(), setTrackerMode(), setTrackerPen()

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

Parameters:

mode Tracker display mode

Warning:

In case of AlwaysOn, mouseTracking will be enabled for the observed widget.

See also:

trackerMode(), DisplayMode

Parameters:

pen Tracker pen

See also:

trackerPen(), setTrackerMode(), setTrackerFont()

Parameters:

doReplot Call replot for the attached plot before initializing the zoomer with its scales. This might be necessary, when the plot is in a state with pending scale changes.

See also:

zoomBase(), scaleRect() QwtPlot::autoReplot(), QwtPlot::replot().

Set the initial size of the zoomer. base is united with the current scaleRect() and the zoom stack is reinitalized with it as zoom base. plot is zoomed to scaleRect().

Parameters:

base Zoom base

See also:

zoomBase(), scaleRect()

Assign a zoom stack. In combination with other types of navigation it might be useful to modify to manipulate the complete zoom stack.

Parameters:

zoomStack New zoom stack
zoomRectIndex Index of the current position of zoom stack. In case of -1 the current position is at the top of the stack.

Note:

The zoomed signal might be emitted.

See also:

zoomStack(), zoomRectIndex()

• PointSelection | ClickSelection
  QwtPickerClickPointMachine()
• PointSelection | DragSelection
  QwtPickerDragPointMachine()
• RectSelection | ClickSelection
  QwtPickerClickRectMachine()
• RectSelection | DragSelection
  QwtPickerDragRectMachine()
• PolygonSelection
  QwtPickerPolygonMachine()

See also:

Parameters:

oldSize Previous size
newSize Current size

See also:

ResizeMode, setResizeMode(), resizeMode()

See also:

See also:

See also:

Parameters:

font Font of the tracker text

Returns:

Bounding rectangle of the tracker text

See also:

trackerPosition()

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

Parameters:

pos Position in pixel coordinates

Returns:

Position string

Reimplemented from QwtPicker.

Returns:

Point in pixel coordinates

See also:

QwtPlotPicker::invTransform()

Returns:

Rectangle in pixel coordinates

See also:

QwtPlotPicker::invTransform()

Parameters:

e Event

Update the state of rubberband and tracker label.

Changes the current position on the stack, but doesn't pop any rectangle.

Note:

The keys codes can be changed, using QwtEventPattern::setKeyPattern: 3, 4, 5

Reimplemented from QwtPicker.

Passes the event to the state machine.

See also:

See also:

Empty implementation, does nothing.

See also:

Move the last point of the selection in case of isActive() == true

See also:

Begin and/or end a selection depending on the selection flags.

See also:

Changes the current position on the stack, but doesn't pop any rectangle.

Note:

The mouse events can be changed, using QwtEventPattern::setMousePattern: 2, 1

Reimplemented from QwtPicker.

Move the last point of the selection in case of isActive() == true

See also:

Return x axis.

Return y axis.

Zoom in or out. Activate a rectangle on the zoom stack with an offset relative to the current position. Negative values of offest will zoom out, positive zoom in. A value of 0 zooms out to the zoom base.

Parameters:

offset Offset relative to the current position of the zoom stack.

Note:

The zoomed signal is emitted.

See also:

zoomRectIndex()

Zoom in. Clears all rectangles above the current position of the zoom stack and pushs the intersection of zoomRect() and the normalized rect on it.

Note:

If the maximal stack depth is reached, zoom is ignored.

The zoomed signal is emitted.

See also:

Parameters:

rect Current zoom rectangle.

See also:

See also: