mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-12-26 10:31:39 +08:00
67d23150f2
new: user-interaction tool that measures distances and angles when mouse is dragged, while mouse button is pressed) update: reworked error indicator base classes and styling settings update: improved boxplot styling with a separate full-featured pen for the whiskers
167 lines
8.9 KiB
Markdown
167 lines
8.9 KiB
Markdown
# Tutorial (JKQTPlotter): User-Interactions in JKQtPlotter {#JKQTPlotterUserInteraction}
|
|
|
|
## Basic Description
|
|
This project (see `./examples/test_user_interaction/`) demonstrates different types of user-interactions in JKQTPlotter.
|
|
|
|
It contains a simple plot with two graphs and provides several widgets that allow to bind different user interactions to different events:
|
|
|
|
|
|
|
|
|
|
## Inner Workings
|
|
|
|
The source code of the main application can be found in [`test_user_interaction.cpp`](https://github.com/jkriege2/JKQtPlotter/tree/master/examples/test_user_interaction/test_user_interaction.cpp).
|
|
|
|
The menu at the top of the window contains several of the QActions provided for user-interaction by JKQTBasePlotter:
|
|
```.cpp
|
|
// add some of the default QActions from the JKQTPlotter to the window menu
|
|
// Some of the are also available in the context menu and toolbar of the JKQTPlotter
|
|
// others are not
|
|
QMenu* menuPlot=menuBar()->addMenu("Plot-Menu");
|
|
menuPlot->addAction(plot->getPlotter()->getActionPrint());
|
|
QMenu* menuPlotS=menuPlot->addMenu("Save ...");
|
|
menuPlotS->addAction(plot->getPlotter()->getActionSaveData());
|
|
menuPlotS->addAction(plot->getPlotter()->getActionSavePDF()); // not available from JKQTPlotter by default
|
|
menuPlotS->addAction(plot->getPlotter()->getActionSavePlot());
|
|
QMenu* menuPlotZ=menuPlot->addMenu("Zoom ...");
|
|
menuPlotZ->addAction(plot->getPlotter()->getActionZoomAll());
|
|
menuPlotZ->addAction(plot->getPlotter()->getActionZoomIn());
|
|
menuPlotZ->addAction(plot->getPlotter()->getActionZoomOut());
|
|
```
|
|
|
|
The rest of the form contains several Qt widgets which switch diverse aspects of the plot style (log-axes, grid on/off ...) and allow to bind different actions to several defined events, e.g.
|
|
```.cpp
|
|
// add a QComboBox that allows to set the left mouse button action for the JKQTPlotter
|
|
cmbLeftNoModMouseAction=new QComboBox(this);
|
|
layForm->addRow("mouse action: left-click, no modifiers", cmbLeftNoModMouseAction);
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaPanPlotOnMove");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaPanPlotOnRelease");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaZoomByRectangle");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaDrawRectangleForEvent");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaDrawCircleForEvent");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaDrawEllipseForEvent");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaDrawLineForEvent");
|
|
cmbLeftNoModMouseAction->addItem("jkqtpmdaScribbleForEvents");
|
|
cmbLeftNoModMouseAction->addItem("NoMouseAction");
|
|
cmbLeftNoModMouseAction->setCurrentIndex(2);
|
|
connect(cmbLeftNoModMouseAction, SIGNAL(currentIndexChanged(int)), this, SLOT(setLeftMouseAction(int)));
|
|
setLeftMouseAction(cmbLeftNoModMouseAction->currentIndex());
|
|
|
|
// ......
|
|
|
|
void TestUserInteraction::setLeftMouseAction(int index)
|
|
{
|
|
if (index==cmbLeftNoModMouseAction->count()-1) plot->deregisterMouseDragAction(Qt::LeftButton, Qt::NoModifier);
|
|
else plot->registerMouseDragAction(Qt::LeftButton, Qt::NoModifier, static_cast<JKQTPMouseDragActions>(index));
|
|
}
|
|
```
|
|
|
|
As you can see, this QComboBox registers one of the available actions to the event of a left-button single mouse click without having modifiers pressed at the same time. The slot that actually reconfigures the JKQTPlotter uses the methods JKQTPlotter::deregisterMouseDragAction() and JKQTPlotter::registerMouseDragAction() to achieve this effect.
|
|
|
|
|
|
|
|
## Available User-Interactions
|
|
|
|
You can play around with this example to find out about different types of user interactions. SOm of them are illustrated with animations below.
|
|
|
|
### Switching Graph Visibility via Context Menu
|
|
|
|
the default context menu contains a sub-menu that allows to switch every graph and and off:
|
|
|
|
|
|
|
|
|
|
### Toolbar at the top of the Plot
|
|
Each JKQTPlotter contains a toolbar that is by default invisible and appears, when the mouse moves over a designated area at the top of the plot:
|
|
|
|
|
|
|
|
You can also use the checkboxes "enable toolbar" to disable this toolbar alltogether and "toolbar 'always on'" to switch the vanishing feature off and make it visible all the time.
|
|
|
|
### Mouse Position Display
|
|
|
|
The JKQTPlotter contains a small text display for the current mouse position (in plot coordinates) at the top of the graph:
|
|
|
|
|
|
|
|
### Drag the Plot Viewport
|
|
You can move the viewport of the graph using the mouse ("jkqtpmdaPanPlotOnMove"-action). If you drag inside the plot window, you can move in both directions, if you drag over one of the coordinate axes, you can change the range of this axis only:
|
|
|
|
|
|
|
|
### Zooming with the Mouse
|
|
|
|
There are several options to zoom, using the mouse:
|
|
* using the mouse wheel
|
|
* with double-click actions jkqtpdcaClickZoomsOut, jkqtpdcaClickZoomsIn
|
|
* using the context menu (or the toolbar)<br>
|
|
|
|
|
|
Again these actions are limited to a single axis, if the mouse is above that axis (and not inside the actual plot rectangle).
|
|
|
|
### Ruler/Measurement Tool
|
|
|
|
JKQTPlotter provides a pre-built ruler tool that measures x- and y-distance between the start and end point, as well as the length of the connecting line and the angle of that line.<br>
|
|
|
|
|
|
|
|
|
|
### Data ToolTip Tool
|
|
|
|
JKQTPlotter provides a pre-built tool that, while the mouse button is pressed and the cursor is dragged over the plot, finds data points (of most graphs) near the mouse and displays their coordinates (and errors) inside a small tooltip:<br>
|
|
|
|
|
|
|
|
|
|
### Drawing Geometrical Forms
|
|
|
|
You can also use the mouse to draw various geometricals forms. When you finish drawing, a single event is emitted for that form, which contains its size and position:
|
|
|
|
#### Lines
|
|
|
|
|
|
#### Rectangles
|
|
|
|
|
|
#### Circles
|
|
|
|
|
|
#### Ellipses
|
|
|
|
|
|
### Context Menus
|
|
|
|
#### Standard Context Menu
|
|
JKQTPlotter contains a standard context menu, which is shown if `plot->setContextMenuMode(jkqtpcmmStandardContextMenu);` was set.
|
|
It contains several standard ways of interacting with the plot, e.g. save to file, copy to clipboard, print, switch graph visibilities, ...
|
|
|
|
|
|
|
|
In addition JKQTPlotter provides several ways to customize this menu:
|
|
* You can add additional actions to the JKQTPlotter, by calling `JKQTPlotter::addAction()` (i.e. using the default Qt mechanism)
|
|
and/or by adding actions to the internal JKQTBasePlotter, using `JKQTBasePlotter::registerAdditionalAction()`
|
|
* You can modify the menu, when it is displayed, by connecting a slot to the signal `JKQTPlotter::contextMenuOPened(x,y,menu)`:
|
|
```.cpp
|
|
connect(plot, SIGNAL(contextMenuOpened(double, double, QMenu*)), this, SLOT(contextMenuOpened(double, double, QMenu*)));
|
|
|
|
// ...
|
|
|
|
void TestUserInteraction::contextMenuOpened(double x, double y, QMenu *contextMenu)
|
|
{
|
|
contextMenu->addSeparator();
|
|
QAction* act=contextMenu->addMenu(QString("contextMenuOpened(x=%1, y=%2)").arg(x).arg(y))->addAction("user-added action");
|
|
connect(act, &QAction::triggered, [x,y]() { QMessageBox::warning(nullptr, tr("Plot Context Menu"),
|
|
tr("Context Menu was opened at x/y=%1/%2!").arg(x).arg(y),
|
|
QMessageBox::Ok,
|
|
QMessageBox::Ok); });
|
|
labMouseAction->setText(QString("contextMenuOpened(x=%1, y=%2)").arg(x).arg(y));
|
|
}
|
|
```
|
|
|
|
#### Special Context Menu
|
|
In addition to the standard context menu, JKQTPlotter can also be configures to display a special, user-defined context menu.
|
|
To do so, call `plot->setContextMenuMode(jkqtpcmmSpecialContextMenu);` and set your menu, by calling `plot->setSpecialContextMenu(menu)`.
|
|
You can also combine the special menu and the standard menu, by calling `plot->setContextMenuMode(jkqtpcmmStandardAndSpecialContextMenu);`.
|
|
|
|
|