QLegend Class
Die Klasse QLegend zeigt die Legende eines Diagramms an. Mehr...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
Öffentliche Typen
| enum | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, …, MarkerShapeFromSeries } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QLegend() |
| Qt::Alignment | alignment() const |
| void | attachToChart() |
| QColor | borderColor() |
| QBrush | brush() const |
| QColor | color() |
| void | detachFromChart() |
| QFont | font() const |
| bool | isAttachedToChart() |
| bool | isBackgroundVisible() const |
(since 6.2) bool | isInteractive() const |
| QBrush | labelBrush() const |
| QColor | labelColor() const |
| QLegend::MarkerShape | markerShape() const |
| QList<QLegendMarker *> | markers(QAbstractSeries *series = nullptr) const |
| QPen | pen() const |
| bool | reverseMarkers() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setBackgroundVisible(bool visible = true) |
| void | setBorderColor(QColor color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setFont(const QFont &font) |
(since 6.2) void | setInteractive(bool interactive) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setMarkerShape(QLegend::MarkerShape shape) |
| void | setPen(const QPen &pen) |
| void | setReverseMarkers(bool reverseMarkers = true) |
| void | setShowToolTips(bool show) |
| bool | showToolTips() const |
Signale
(since 6.2) void | attachedToChartChanged(bool attached) |
| void | backgroundVisibleChanged(bool visible) |
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | fontChanged(QFont font) |
| void | labelColorChanged(QColor color) |
| void | markerShapeChanged(QLegend::MarkerShape shape) |
| void | reverseMarkersChanged(bool reverseMarkers) |
| void | showToolTipsChanged(bool showToolTips) |
Detaillierte Beschreibung
Eine Legende ist ein grafisches Objekt, das die Legende eines Diagramms anzeigt. Der Status der Legende wird von QChart aktualisiert, wenn sich Serien ändern. Standardmäßig ist die Legende an das Diagramm angehängt, sie kann jedoch abgetrennt werden, um sie vom Diagrammlayout unabhängig zu machen. Legendenobjekte können nicht erstellt oder gelöscht werden, aber sie können über die Klasse QChart referenziert werden.
Siehe auch QChart.
Dokumentation der Mitgliedstypen
enum QLegend::MarkerShape
Diese Aufzählung beschreibt die Form, die beim Rendern von Legendenmarkierungselementen verwendet wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | Die von QLegend festgelegte Standardform wird für die Markierung verwendet. Dieser Wert wird nur für einzelne QLegendMarker Elemente unterstützt. |
QLegend::MarkerShapeRectangle | 1 | Es werden rechteckige Markierungen verwendet. Die Größe der Markierung wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapeCircle | 2 | Es werden runde Markierungen verwendet. Die Größe der Markierung wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapeRotatedRectangle | 4 | Es werden gedrehte rechteckige Markierungen verwendet. Die Größe der Markierung wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapeTriangle | 5 | Es werden dreieckige Markierungen verwendet. Die Größe der Markierung wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapeStar | 6 | Es werden sternförmige Marker verwendet. Die Größe der Marker wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapePentagon | 7 | Es werden fünfeckige Marker verwendet. Die Markergröße wird durch die Schriftgröße bestimmt. |
QLegend::MarkerShapeFromSeries | 3 | Die Form der Marker wird durch die Serie bestimmt. Bei einer Streuungsreihe sieht die Legendenmarkierung wie ein Streuungspunkt aus und hat die gleiche Größe wie der Punkt. Bei einer Linien- oder Spline-Reihe sieht die Legendenmarkierung wie ein kleines Segment der Linie aus. Für andere Reihentypen werden rechteckige Markierungen angezeigt. Wenn für eine Reihe eine lightMarker angegeben ist, wird die lightMarker angezeigt und ihre Größe wird durch die Größe der Reihenmarkierung bestimmt. |
Siehe auch markerShape.
Dokumentation der Eigenschaften
alignment : Qt::Alignment
Wie die Legende auf das Diagramm ausgerichtet ist.
Kann Qt::AlignTop, Qt::AlignBottom, Qt::AlignLeft, Qt::AlignRight sein. Wenn Sie mehr als ein Flag setzen, ist das Ergebnis undefiniert.
Zugriffsfunktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Diese Eigenschaft gibt an, ob der Hintergrund der Legende sichtbar ist.
Zugriffsfunktionen:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Melder-Signal:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Diese Eigenschaft enthält die Linienfarbe der Legende.
Zugriffsfunktionen:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged(QColor color) |
color : QColor
Diese Eigenschaft enthält die Hintergrundfarbe (Pinsel) der Legende.
Wenn Sie die Farbe der Legende ändern, wird der Stil des Legendenpinsels auf Qt::SolidPattern gesetzt.
Zugriffsfunktionen:
| QColor | color() |
| void | setColor(QColor color) |
Benachrichtigungssignal:
| void | colorChanged(QColor color) |
font : QFont
Diese Eigenschaft enthält die Schriftart der in der Legende verwendeten Markierungen.
Zugriffsfunktionen:
| QFont | font() const |
| void | setFont(const QFont &font) |
Melder-Signal:
| void | fontChanged(QFont font) |
labelColor : QColor
Diese Eigenschaft enthält die Farbe des Pinsels, der zum Zeichnen von Beschriftungen verwendet wird.
Zugriffsfunktionen:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Benachrichtigungssignal:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
Die Standardform der Legendenmarkierungen. Der Standardwert ist MarkerShapeRectangle.
Zugriffsfunktionen:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Melder-Signal:
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
Diese Eigenschaft legt fest, ob die Markierungen in der Legende in umgekehrter Reihenfolge angezeigt werden sollen.
Diese Eigenschaft ist standardmäßig false.
Zugriffsfunktionen:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Melder-Signal:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Diese Eigenschaft legt fest, ob Tooltips angezeigt werden, wenn der Text abgeschnitten ist.
Diese Eigenschaft ist standardmäßig false.
Zugriffsfunktionen:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Benachrichtigungssignal:
| void | showToolTipsChanged(bool showToolTips) |
Member Function Dokumentation
[virtual noexcept] QLegend::~QLegend()
Zerstört das Legendenobjekt. Die Legende ist immer im Besitz einer QChart, so dass eine Anwendung diese Funktion niemals aufrufen sollte.
void QLegend::attachToChart()
Hängt die Legende an ein Diagramm an. Das Diagramm kann das Layout der Legende anpassen.
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Dieses Signal wird ausgegeben, wenn die Legende attached an das Diagramm angehängt oder von ihm abgetrennt wird.
Diese Funktion wurde in Qt 6.2 eingeführt.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Dieses Signal wird ausgegeben, wenn die Sichtbarkeit des Legendenhintergrunds auf visible wechselt.
Hinweis: Benachrichtigungssignal für die Eigenschaft backgroundVisible.
[signal] void QLegend::borderColorChanged(QColor color)
Dieses Signal wird ausgegeben, wenn die Rahmenfarbe des Legendenhintergrunds auf color wechselt.
Hinweis: Benachrichtigungssignal für die Eigenschaft borderColor.
QBrush QLegend::brush() const
Gibt den von der Legende verwendeten Pinsel zurück.
Siehe auch setBrush().
[signal] void QLegend::colorChanged(QColor color)
Dieses Signal wird ausgegeben, wenn die Farbe des Legendenhintergrunds auf color wechselt.
Hinweis: Benachrichtigungssignal für die Eigenschaft color.
void QLegend::detachFromChart()
Entfernt die Legende vom Diagramm. Das Diagramm wird das Layout der Legende nicht mehr anpassen.
[signal] void QLegend::fontChanged(QFont font)
Dieses Signal wird ausgegeben, wenn sich die Schriftart der Marker der Legende auf font ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft font.
bool QLegend::isAttachedToChart()
Gibt true zurück, wenn die Legende an ein Diagramm angehängt ist.
bool QLegend::isBackgroundVisible() const
Gibt die Sichtbarkeit des Legendenhintergrunds zurück.
Hinweis: Getter-Funktion für die Eigenschaft backgroundVisible.
[since 6.2] bool QLegend::isInteractive() const
Gibt zurück, ob die Legende mit der Maus gezogen oder in der Größe verändert werden kann, wenn sie abgetrennt ist.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch QLegend::setInteractive().
QBrush QLegend::labelBrush() const
Gibt den Pinsel zurück, der zum Zeichnen von Beschriftungen verwendet wird.
Siehe auch setLabelBrush().
[signal] void QLegend::labelColorChanged(QColor color)
Dieses Signal wird ausgegeben, wenn die Farbe des Pinsels, mit dem die Beschriftungen der Legende gezeichnet werden, auf color wechselt.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelColor.
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Gibt die Liste der Markierungen in der Legende zurück. Die Liste kann gefiltert werden, indem die series angegeben wird, für die die Markierungen zurückgegeben werden.
QPen QLegend::pen() const
Gibt den von der Legende verwendeten Stift zurück.
Siehe auch setPen().
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Dieses Signal wird ausgegeben, wenn die Verwendung der umgekehrten Reihenfolge für die Markierungen in der Legende auf reverseMarkers geändert wird.
Hinweis: Benachrichtigungssignal für die Eigenschaft reverseMarkers.
void QLegend::setBackgroundVisible(bool visible = true)
Setzt die Sichtbarkeit des Legendenhintergrunds auf visible.
Hinweis: Setter-Funktion für die Eigenschaft backgroundVisible.
Siehe auch isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Legt die brush fest, die verwendet wird, um den Hintergrund der Legende zu zeichnen.
Siehe auch brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Wenn interactive true ist und die Legende abgetrennt ist, kann die Legende ähnlich wie ein Fenster mit der Maus verschoben und in der Größe verändert werden.
Die Legende wird automatisch an einen Rand des Diagramms angehängt, wenn Sie sie von diesem Rand wegziehen. Ein Doppelklick auf eine angehängte Legende löst diese wieder ab. Standardmäßig ist dies false.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch QLegend::isInteractive().
void QLegend::setLabelBrush(const QBrush &brush)
Setzt den Pinsel zum Zeichnen der Legendenbeschriftungen auf brush.
Siehe auch labelBrush().
void QLegend::setPen(const QPen &pen)
Legt die pen fest, die zum Zeichnen der Legendenränder verwendet wird.
Siehe auch pen().
void QLegend::setShowToolTips(bool show)
Wenn show auf true steht, zeigen die Legendenbeschriftungen einen Tooltip an, wenn der Mauszeiger über sie bewegt wird, wenn die Beschriftung selbst ausgeblendet ist. Dies ist false standardmäßig.
Hinweis: Setter-Funktion für die Eigenschaft showToolTips.
Siehe auch showToolTips().
bool QLegend::showToolTips() const
Gibt zurück, ob die Tooltips für die Legendenbeschriftungen angezeigt werden, wenn sie ausgeblendet sind.
Hinweis: Getter-Funktion für die Eigenschaft showToolTips.
Siehe auch setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Dieses Signal wird ausgegeben, wenn die Sichtbarkeit von Tooltips auf showToolTips geändert wird.
Hinweis: Benachrichtigungssignal für die Eigenschaft showToolTips.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
