HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r2219:bcb41ad786cc

documented legendmarker example. removed unnecessary casting from example

sauimone -

r2219:bcb41ad786cc

parent child

Context file:

r2219:bcb41ad786cc

Collapse all files

doc/images/examples_legendmarkers.png created 644 binary 0 0

NO CONTENT: new file 100644, binary diff hidden

doc/src/examples-legendmarkers.qdoc created 644 +41 0

@@ -0,0 +1,41
	1	/*!
	2	\example examples/legendmarkers
	3	\title LegendMarkers Example
	4	\subtitle
	5
	6	The example shows how to make use of legend markers. In this example we create an application which uses QLegendMarker clicked signal to show/hide corresponding series
	7	in chart.
	8
	9	\image examples_legendmarkers.png
	10
	11	Our application has buttons for adding or removing series in chart and button to connect or disconnect legend markers clicked signal to our handler. In the image above,
	12	we have connected the markers and clicked on one of them.
	13
	14	\snippet ../examples/legendmarkers/mainwidget.cpp 1
	15
	16	Here we connect the markers in legend to our handler. To avoid conncecting same marker more than once, we first disconnect it.
	17
	18	\snippet ../examples/legendmarkers/mainwidget.cpp 2
	19
	20	Here we disconnect all markers from our handler.
	21
	22	\snippet ../examples/legendmarkers/mainwidget.cpp 3
	23
	24	In our handler we first cast the sender of event to QLegendMarker.
	25
	26	\snippet ../examples/legendmarkers/mainwidget.cpp 4
	27
	28	Then we check the type of marker. This is needed if we want to access the detailed methods of the marker and cast it to correct type.
	29	If all we need is the pointer to QAbstractSeries, the casting isn't necessary. In case of pie or bar series, we may need the pointer to related QPieSlice or QBarSet.
	30
	31	\snippet ../examples/legendmarkers/mainwidget.cpp 5
	32
	33	We want to toggle the visibility of the series, when marker is clicked. To do so, we get the pointer to related series from marker and toggle its visibility.
	34	Because the legend marker follows the visibility of the series by default, we also set the marked back to visible. If we don't do that, the marker will be
	35	invisible in legend and we can't click on it anymore.
	36
	37	\snippet ../examples/legendmarkers/mainwidget.cpp 6
	38
	39	Instead of making marker invisible when series is hidden, we dim the color of the marker. Here we do it by modifying the color of the laberBrush.
	40
	41	*/

doc/src/examples.qdoc +2 0

                     <tr>
                         <td><a href="examples-zoomlinechart.html">Zoom Line</a></td>
+                        <td><a href="examples-legendmarkers.html">Legend Markers</a></td>
                     </tr>
                     <tr>
                         <td><a href="examples-zoomlinechart.html"><img src="images/examples_zoomlinechart1.png" width="300" alt="Zoom Line" /></a></td>
+                        <td><a href="examples-legendmarkers.html"><img src="images/examples_legendmarkers.png" width="300" alt="Legend Markers" /></a></td>
                     </tr>
                 </table>

examples/legendmarkers/mainwidget.cpp +4 -4

                 Q_ASSERT(marker);
             //![3]
             //![4]
                 switch (marker->type())
             //![4]
             //![6]
                     // Dim the marker, if series is not visible
-                    QXYLegendMarker *xymarker = qobject_cast<QXYLegendMarker *> (marker);
+                    QBrush labelBrush = marker->labelBrush();
-                    QColor color = xymarker->labelBrush().color();
+                    QColor color = labelBrush.color();
                     if (marker->series()->isVisible()) {
                         color.setAlphaF(1.0);
                         color.setAlphaF(0.5);
                     }
-                    xymarker->setLabelBrush(QBrush(color));
+                    labelBrush.setColor(color);
+                    marker->setLabelBrush(labelBrush);
             //![6]
                     break;
                     }

General Comments 0

Write
Preview

You need to be logged in to leave comments. Login now

No TODOs yet

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages