QwtPlotSeriesDataPickerGroup Class Reference

Group manager for synchronizing multiple QwtPlotSeriesDataPicker instances across plot widgets. More...

#include <qwt_plot_series_data_picker_group.h>

Inheritance diagram for QwtPlotSeriesDataPickerGroup:

Classes
class	PrivateData

Public Slots
void	onPickerMove (const QPoint &pos)
void	onPickerActivated (bool on)
void	onPickerDestroy (QObject *obj)
void	onPickerClicked (QwtPlotSeriesDataPicker *picker, const QPoint &pos)
	Handles click signal from a picker, syncs other pickers, then emits group's clicked signal.
void	onPickerDoubleClicked (QwtPlotSeriesDataPicker *picker, const QPoint &pos)
	Handles double-click signal from a picker, syncs other pickers, then emits group's doubleClicked signal.

Signals
void	clicked (QwtPlotSeriesDataPicker *picker, const QPoint &pos)
	Emitted when a picker in the group is clicked.
void	doubleClicked (QwtPlotSeriesDataPicker *picker, const QPoint &pos)
	Emitted when a picker in the group is double-clicked.

Public Member Functions
	QwtPlotSeriesDataPickerGroup (QObject *par=nullptr)
	Constructor.
	~QwtPlotSeriesDataPickerGroup () override
	Destructor.
void	addPicker (QwtPlotSeriesDataPicker *pick)
	Add a picker to the group.
void	removePicker (QwtPlotSeriesDataPicker *pick)
	Remove a picker from the group.
QList< QwtPlotSeriesDataPicker * >	pickers () const
	Get all pickers in the group.
void	setEnabled (bool on)
	Set enabled state.
bool	isEnabled () const
	Check if enabled.

Detailed Description

Group manager for synchronizing multiple QwtPlotSeriesDataPicker instances across plot widgets.

This class enables coordinated interaction among multiple plot pickers, currently implementing synchronized X-axis proportional positioning. When a user moves the mouse over one plot within a subplot arrangement, the active picker displays its Y-value while all other pickers in the same group automatically position themselves at equivalent X-axis proportional locations on their respective plots, creating a unified cross-plot data inspection experience.

Key features:

• Automatic synchronization of picker positions based on X-axis proportion
• Dynamic membership management (add/remove pickers at runtime)
• Automatic cleanup when pickers are destroyed
• Activation state synchronization across the group

Note

Currently supports only X-axis proportional synchronization; Y-axis values are displayed independently per plot based on local data at the synchronized X position.

Constructor & Destructor Documentation

QwtPlotSeriesDataPickerGroup()

QwtPlotSeriesDataPickerGroup::QwtPlotSeriesDataPickerGroup

(

QObject *

par = nullptr

)

Constructor.

Parameters

[in]

par

Parent object

Destructor

Member Function Documentation

addPicker()

void QwtPlotSeriesDataPickerGroup::addPicker

(

QwtPlotSeriesDataPicker *

pick

)

Add a picker to the group.

Adds a picker to the synchronization group.

Parameters

pick	Pointer to QwtPlotSeriesDataPicker instance to be added to the group

Note

The picker must belong to a QwtPlot with properly configured axes. Adding a null pointer or a picker already in the group has no effect. The group does not take ownership of the picker.

Warning

Pickers from plots with significantly different X-axis scales may show positioning artifacts due to proportional mapping limitations.

clicked

void QwtPlotSeriesDataPickerGroup::clicked ( QwtPlotSeriesDataPicker *  picker, const QPoint &  pos  )

signal

Emitted when a picker in the group is clicked.

Parameters

picker	The picker that was clicked
pos	The click position in picker's canvas coordinates

doubleClicked

void QwtPlotSeriesDataPickerGroup::doubleClicked ( QwtPlotSeriesDataPicker *  picker, const QPoint &  pos  )

signal

Emitted when a picker in the group is double-clicked.

Parameters

picker	The picker that was double-clicked
pos	The double-click position in picker's canvas coordinates

isEnabled()

bool QwtPlotSeriesDataPickerGroup::isEnabled

(

)

const

Check if enabled.

Check if synchronization is enabled.

Returns

True if enabled

See also

setEnabled()

onPickerClicked

void QwtPlotSeriesDataPickerGroup::onPickerClicked ( QwtPlotSeriesDataPicker *  picker, const QPoint &  pos  )

slot

Handles click signal from a picker, syncs other pickers, then emits group's clicked signal.

Parameters

picker	The picker that emitted the click signal
pos	The click position

onPickerDoubleClicked

void QwtPlotSeriesDataPickerGroup::onPickerDoubleClicked ( QwtPlotSeriesDataPicker *  picker, const QPoint &  pos  )

slot

Handles double-click signal from a picker, syncs other pickers, then emits group's doubleClicked signal.

Parameters

picker	The picker that emitted the double-click signal
pos	The double-click position

pickers()

QList< QwtPlotSeriesDataPicker * > QwtPlotSeriesDataPickerGroup::pickers

(

)

const

Get all pickers in the group.

Returns the list of all pickers currently in the group.

Returns

QList containing pointers to all managed QwtPlotSeriesDataPicker instances

Note

The returned list is a copy; modifications to it do not affect the internal group state. Use addPicker() to modify group membership.

removePicker()

void QwtPlotSeriesDataPickerGroup::removePicker

(

QwtPlotSeriesDataPicker *

pick

)

Remove a picker from the group.

Parameters

[in]

pick

Pointer to QwtPlotSeriesDataPicker instance to be removed from the group

Note

If the picker is not in the group, this function has no effect.

setEnabled()

void QwtPlotSeriesDataPickerGroup::setEnabled

(

bool

on

)

Set enabled state.

When disabled, picker synchronization will not occur.

Parameters

[in]

on

Enable/disable synchronization

See also

isEnabled()

---

The documentation for this class was generated from the following files:

• /home/runner/work/QWT/QWT/src/plot/qwt_plot_series_data_picker_group.h
• /home/runner/work/QWT/QWT/src/plot/qwt_plot_series_data_picker_group.cpp