QwtPlotPicker(3)

📦
version 6.3.0 · 6 versions
, in alpine 3.24

🎀 QwtPlotPicker — the plot-canvas picker manual, bestie 💅

Manual page: QwtPlotPicker(3) — from the Library Functions Manual. This is the part where we vibe-check the picker that does selections on a plot canvas. No cap.

✨ NAME ✨

QwtPlotPicker — QwtPlotPicker provides selections on a plot canvas. That’s literally the whole name-section energy. 🫶

🌸 SYNOPSIS 🌸

#include <qwt_plot_picker.h>
  • Inherits QwtPicker.
  • Inherited by QwtPlotZoomer.

📣 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 🧚

Where the original gives no description, I’m not inventing lore — just handing you the exact signature, periodt. 💅

  • QwtPlotPicker (QWidget *canvas) — Create a plot picker.
  • virtual ~QwtPlotPicker () — Destructor.
  • QwtPlotPicker (QwtAxisId xAxisId, QwtAxisId yAxisId, QWidget *)
  • QwtPlotPicker (QwtAxisId xAxisId, QwtAxisId yAxisId, RubberBand rubberBand, DisplayMode trackerMode, QWidget *)
  • virtual void setAxes (QwtAxisId xAxisId, QwtAxisId yAxisId)
  • QwtAxisId xAxis () const — Return x axis.
  • QwtAxisId yAxis () const — Return y axis.
  • QwtPlot * plot ()
  • const QwtPlot * plot () 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 QwtPickerMachine * stateMachine () const
  • QwtPickerMachine * stateMachine ()
  • void setRubberBand (RubberBand)
  • RubberBand rubberBand () const
  • void setTrackerMode (DisplayMode) — Set the display mode of the tracker.
  • DisplayMode trackerMode () const
  • void setResizeMode (ResizeMode) — Set the resize mode.
  • 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 *) override — Event filter.
  • 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 trackerMask () 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 key, Qt::KeyboardModifiers modifiers=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.
  • bool keyMatch (KeyPatternCode, const QKeyEvent *) const — Compare a key event with an event pattern.

🔒 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 override
  • virtual QwtText trackerTextF (const QPointF &) const — Translate a position into a position string.
  • virtual void move (const QPoint &) override
  • virtual void append (const QPoint &) override
  • virtual bool end (bool ok=true) override

🧵 Protected Member Functions inherited from QwtPicker 🧵

  • virtual QPolygon adjustedPoints (const QPolygon &) const — Map the pickedPoints() into a selection().
  • virtual void transition (const QEvent *)
  • virtual void begin ()
  • virtual void remove ()
  • virtual bool accept (QPolygon &) const — Validate and fix up the selection.
  • 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 QwtWidgetOverlay * rubberBandOverlay () const
  • const QwtWidgetOverlay * trackerOverlay () const
  • const QPolygon & pickedPoints () const
  • QRect trackerRect (const QSize &) const

🪄 Protected Member Functions inherited from QwtEventPattern 🪄

  • virtual bool mouseMatch (const MousePattern &, const QMouseEvent *) const — Compare a mouse event with an event pattern.
  • virtual bool keyMatch (const KeyPattern &, const QKeyEvent *) const — Compare a key event with an event pattern.

🎁 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.
  • enum ResizeMode { Stretch, KeepSize }

⭐ Public Types inherited from QwtEventPattern ⭐

  • enum MousePatternCode { MouseSelect1, MouseSelect2, MouseSelect3, MouseSelect4, MouseSelect5, MouseSelect6, MousePatternCount } — Symbolic mouse input codes.
  • enum KeyPatternCode { KeySelect1, KeySelect2, KeyAbort, KeyLeft, KeyRight, KeyUp, KeyDown, KeyRedo, KeyUndo, KeyHome, KeyPatternCount } — Symbolic keyboard input codes.

🎀 Public Slots inherited from QwtPicker 🎀

  • void setEnabled (bool) — En/disable the picker.

💖 Detailed Description 💖

QwtPlotPicker provides selections on a plot canvas. That’s the main-character sentence, okay? 💅

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. It’s giving “plot canvas translator,” lowkey iconic. 🦋

Definition at line 33 of file qwt_plot_picker.h.

👑 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 QwtAxis::XBottom. If both or no y-axis are enabled, it is set to QwtAxis::YLeft. Slay. ✨

Parameters:

  • canvas — Plot canvas to observe, also the parent object

See also: QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()

Definition at line 43 of file qwt_plot_picker.cpp.

💀 QwtPlotPicker::~QwtPlotPicker () [virtual]

Destructor.

Definition at line 108 of file qwt_plot_picker.cpp.

🦋 QwtPlotPicker::QwtPlotPicker (QwtAxisId xAxisId, QwtAxisId yAxisId, QWidget * canvas) [explicit]

Create a plot picker.

Parameters:

  • xAxisId — X axis of the picker
  • yAxisId — Y axis of the picker
  • canvas — Plot canvas to observe, also the parent object

See also: QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()

Definition at line 76 of file qwt_plot_picker.cpp.

🌸 QwtPlotPicker::QwtPlotPicker (QwtAxisId xAxisId, QwtAxisId yAxisId, RubberBand rubberBand, DisplayMode trackerMode, QWidget * canvas) [explicit]

Create a plot picker.

Parameters:

  • xAxisId — X axis of the picker
  • yAxisId — Y axis of the picker
  • rubberBand — Rubber band style
  • trackerMode — Tracker mode
  • canvas — Plot canvas to observe, also the parent object

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

See also: QwtPlot::autoReplot(), QwtPlot::replot(), scaleRect()

Definition at line 98 of file qwt_plot_picker.cpp.

💅 MEMBER FUNCTION DOCUMENTATION 💅

okay bestie, this is the part where we meet every single function one by one. no skipping, no "you get the idea" — we're doing all of them 💖

🌸 void QwtPlotPicker::append (const QPoint & pos) — [override], [protected], [virtual]

Appends a point to the selection and updates the rubber band and the tracker. like, the selection grows by one point and everything redraws to match ✨

  • Parameters
    • pos — the additional point
  • See also — isActive, begin(), end(), move(), appended()
Note — the appended(const QPoint &) and appended(const QDoublePoint &) signals get emitted. no cap, both of them 🫶

Reimplemented from QwtPicker.

Definition at line 251 of file qwt_plot_picker.cpp.

🎀 void QwtPlotPicker::appended (const QPointF & pos) — [signal]

A signal that fires when a point has been appended to the selection 💫

  • Parameters
    • pos — position of the appended point
  • See also — append(), moved()

🦋 QWidget * QwtPlotPicker::canvas ()

  • Returns — the observed plot canvas

Definition at line 114 of file qwt_plot_picker.cpp.

🦋 const QWidget * QwtPlotPicker::canvas () const

  • Returns — the observed plot canvas

Definition at line 120 of file qwt_plot_picker.cpp.

(yes bestie, there's a const version too — same answer, different vibes 💅)

⭐ bool QwtPlotPicker::end (bool ok = true) — [override], [protected], [virtual]

Closes a selection and sets the state to inactive. the selection era is over, periodt ✨

  • Parameters
    • ok — if true, complete the selection and emit the selected signals; otherwise discard the selection
  • Returns — true if the selection has been accepted, false otherwise

Reimplemented from QwtPicker.

Reimplemented in QwtPlotZoomer.

Definition at line 280 of file qwt_plot_picker.cpp.

🔥 QPointF QwtPlotPicker::invTransform (const QPoint & pos) const — [protected]

Translates a point from pixel into plot coordinates. glow-up for your numbers ✨

  • Returns — point in plot coordinates
  • See also — transform()

Definition at line 367 of file qwt_plot_picker.cpp.

🔥 QRectF QwtPlotPicker::invTransform (const QRect & rect) const — [protected]

Translates a rectangle from pixel into plot coordinates 🎀

  • Returns — rectangle in plot coordinates
  • See also — transform()

Definition at line 341 of file qwt_plot_picker.cpp.

🌈 void QwtPlotPicker::move (const QPoint & pos) — [override], [protected], [virtual]

Moves the last point of the selection. main character energy for that one little point 👑

  • Parameters
    • pos — new position
  • See also — isActive, begin(), end(), append()
Note — the moved(const QPoint &) and moved(const QDoublePoint &) signals are emitted. both. yes. 💀

Reimplemented from QwtPicker.

Definition at line 266 of file qwt_plot_picker.cpp.

💜 void QwtPlotPicker::moved (const QPointF & pos) — [signal]

A signal that fires 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()

🧚 QwtPlot * QwtPlotPicker::plot ()

  • Returns — plot widget, containing the observed plot canvas

Definition at line 126 of file qwt_plot_picker.cpp.

🧚 const QwtPlot * QwtPlotPicker::plot () const

  • Returns — plot widget, containing the observed plot canvas

Definition at line 136 of file qwt_plot_picker.cpp.

🌸 QRectF QwtPlotPicker::scaleRect () const — [protected]

  • Returns — normalized bounding rectangle of the axes
  • See also — QwtPlot::autoReplot(), QwtPlot::replot().

Definition at line 149 of file qwt_plot_picker.cpp.

🍓 void QwtPlotPicker::selected (const QPointF & pos) — [signal]

A signal emitted in case of QwtPickerMachine::PointSelection 🎯

  • Parameters
    • pos — selected point

🍓 void QwtPlotPicker::selected (const QRectF & rect) — [signal]

A signal emitted in case of QwtPickerMachine::RectSelection 🔲

  • Parameters
    • rect — selected rectangle

🍓 void QwtPlotPicker::selected (const QVector< QPointF > & pa) — [signal]

A signal emitting the selected points, at the end of a selection — the finale, the grand reveal 👑

  • Parameters
    • pa — selected points

🌟 void QwtPlotPicker::setAxes (QwtAxisId xAxisId, QwtAxisId yAxisId) — [virtual]

Sets the x and y axes of the picker. matchmaker behavior for axes fr fr 💘

  • Parameters
    • xAxisId — X axis
    • yAxisId — Y axis

Reimplemented in QwtPlotZoomer.

Definition at line 172 of file qwt_plot_picker.cpp.

✨ QwtText QwtPlotPicker::trackerText (const QPoint & pos) const — [override], [protected], [virtual]

Translates a pixel position into a position string 🎀

  • Parameters
    • pos — position in pixel coordinates
  • Returns — position string

Reimplemented from QwtPicker.

Definition at line 203 of file qwt_plot_picker.cpp.

✨ QwtText QwtPlotPicker::trackerTextF (const QPointF & pos) const — [protected], [virtual]

Translates a position into a position string. so:

  • in case of HLineRubberBand, the label is the value of the y position
  • in case of VLineRubberBand, the label is the value of the x position
  • otherwise, the label contains the x and y position separated by a ','

The format for the double-to-string conversion is "%.4f" — that's %.4f, bestie, four decimals, don't @ me 💅

  • Parameters
    • pos — position
  • Returns — position string

Definition at line 223 of file qwt_plot_picker.cpp.

🦋 QPoint QwtPlotPicker::transform (const QPointF & pos) const — [protected]

Translates a point from plot into pixel coordinates 🎯

  • Returns — point in pixel coordinates
  • See also — invTransform()

Definition at line 383 of file qwt_plot_picker.cpp.

🦋 QRect QwtPlotPicker::transform (const QRectF & rect) const — [protected]

Translates a rectangle from plot into pixel coordinates 🌈

  • Returns — rectangle in pixel coordinates
  • See also — invTransform()

Definition at line 354 of file qwt_plot_picker.cpp.

👑 QwtAxisId QwtPlotPicker::xAxis () const

Returns the x axis. that's it, that's the function ✨

Definition at line 186 of file qwt_plot_picker.cpp.

👑 QwtAxisId QwtPlotPicker::yAxis () const

Returns the y axis. the vertical one, iconic behavior 💜

Definition at line 192 of file qwt_plot_picker.cpp.

🌸 AUTHOR 🌸

Generated automatically by Doxygen for Qwt User's Guide from the source code. yes, a robot wrote it, and honestly? it ate 🤖✨

and that's a wrap on QwtPlotPicker(3), bestie 🫶 this whole page came to you from the Qwt User's Guide, generated by Doxygen for the Qwt User's Guide, and it's the version dated with the Qwt User's Guide header — so if anything here ever looks off, blame the date stamp at the bottom, not me 💖 mwah, go pick some points 💅

📦 where this page comes from