QLegend Class
Die Klasse „QLegend“ zeigt die Legende eines Diagramms an. Mehr...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Ö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) |
Ausführliche Beschreibung
Eine Legende ist ein grafisches Objekt, das die Legende eines Diagramms anzeigt. Der Status der Legende wird von ` QChart ` aktualisiert, wenn sich die Reihen ändern. Standardmäßig ist die Legende an das Diagramm angeheftet, kann jedoch abgekoppelt werden, um sie vom Diagrammlayout unabhängig zu machen. Legendenobjekte können nicht erstellt oder gelöscht werden, es kann jedoch über die Klasse ` QChart ` auf sie verwiesen werden.
Siehe auch „ QChart “.
Dokumentation zu Mitgliedstypen
enum QLegend::MarkerShape
Diese Enumeration beschreibt die Form, die beim Rendern von Legendenmarkierungen verwendet wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | Für das Symbol wird die von ` QLegend ` festgelegte Standardform 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 richtet sich nach der Schriftgröße. |
QLegend::MarkerShapeCircle | 2 | Es werden kreisförmige Markierungen verwendet. Die Größe der Markierung richtet sich nach der Schriftgröße. |
QLegend::MarkerShapeRotatedRectangle | 4 | Es werden gedrehte rechteckige Markierungen verwendet. Die Größe der Markierung richtet sich nach der Schriftgröße. |
QLegend::MarkerShapeTriangle | 5 | Es werden dreieckige Marker verwendet. Die Größe der Marker richtet sich nach der Schriftgröße. |
QLegend::MarkerShapeStar | 6 | Es werden sternförmige Markierungen verwendet. Die Größe der Markierung richtet sich nach der Schriftgröße. |
QLegend::MarkerShapePentagon | 7 | Es werden fünfeckige Markierungen verwendet. Die Größe der Markierung richtet sich nach der Schriftgröße. |
QLegend::MarkerShapeFromSeries | 3 | Die Markierungsform richtet sich nach der Reihe. Bei einer Streudiagrammreihe sieht die Legendenmarkierung wie ein Streupunkt aus und hat dieselbe Größe wie der Punkt. Bei einer Linien- oder Spline-Reihe sieht die Legendenmarkierung wie ein kleines Segment der Linie aus. Bei anderen Diagrammtypen werden rechteckige Markierungen angezeigt. Wenn für eine Reihe ein „ lightMarker “ festgelegt ist, wird der „ lightMarker “ angezeigt, dessen Größe sich nach der Markierungsgröße der Reihe richtet. |
Siehe auch „ markerShape “.
Dokumentation zu den Eigenschaften
alignment : Qt::Alignment
Wie die Legende im Diagramm ausgerichtet ist.
Mögliche Werte sind „ Qt::AlignTop “, „ Qt::AlignBottom “, „ Qt::AlignLeft “ und „ Qt::AlignRight “. 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 legt fest, ob der Hintergrund der Legende sichtbar ist.
Zugriffsfunktionen:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Benachrichtigungssignal:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Diese Eigenschaft legt die Linienfarbe der Legende fest.
Zugriffsfunktionen:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged(QColor color) |
color : QColor
Diese Eigenschaft legt die Hintergrundfarbe (Pinsel) der Legende fest.
Wenn Sie die Farbe der Legende ändern, wird der Stil des Legendenpinsels auf „ Qt::SolidPattern “ gesetzt.
Zugriffsfunktionen:
| QColor | color() |
| void | setColor(QColor color) |
Notifier-Signal:
| void | colorChanged(QColor color) |
font : QFont
Diese Eigenschaft legt die Schriftart der Markierungen fest, die in der Legende verwendet werden.
Zugriffsfunktionen:
| QFont | font() const |
| void | setFont(const QFont &font) |
Benachrichtigungssignal:
| 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) |
Notifier-Signal:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
Die Standardform der Legendenmarkierungen. Der Standardwert lautet „ MarkerShapeRectangle “.
Zugriffsfunktionen:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Benachrichtigungssignal:
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
Diese Eigenschaft legt fest, ob die Markierungen in der Legende in umgekehrter Reihenfolge angezeigt werden.
Diese Eigenschaft ist standardmäßig auf „ false “ gesetzt.
Zugriffsfunktionen:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Benachrichtigungssignal:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Diese Eigenschaft legt fest, ob Tooltips angezeigt werden, wenn der Text abgeschnitten ist.
Diese Eigenschaft ist standardmäßig auf „ false “ gesetzt.
Zugriffsfunktionen:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Benachrichtigungssignal:
| void | showToolTipsChanged(bool showToolTips) |
Dokumentation der Member-Funktionen
[virtual noexcept] QLegend::~QLegend()
Löscht das Legendenobjekt. Die Legende gehört immer zu einem QChart, daher sollte eine Anwendung diese Funktion niemals aufrufen.
void QLegend::attachToChart()
Fügt die Legende zu einem Diagramm hinzu. Das Diagramm kann das Layout der Legende anpassen.
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Dieses Signal wird ausgelöst, wenn die Legende an das Diagramm „ attached “ angefügt oder davon getrennt wird.
Diese Funktion wurde in Qt 6.2 eingeführt.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit des Legendenhintergrunds auf „ visible “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ backgroundVisible “.
[signal] void QLegend::borderColorChanged(QColor color)
Dieses Signal wird ausgelöst, wenn sich die Rahmenfarbe des Legendenhintergrunds auf „ color “ ändert.
Hinweis: Notifier -Signal 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 ausgelöst, wenn sich die Farbe des Legendenhintergrunds in „ color “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ color “.
void QLegend::detachFromChart()
Entfernt die Legende aus dem Diagramm. Das Diagramm passt das Layout der Legende nicht mehr an.
[signal] void QLegend::fontChanged(QFont font)
Dieses Signal wird ausgelöst, wenn sich die Schriftart der Markierungen in der Legende auf „ font “ ändert.
Hinweis: Notifier -Signal 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 Hintergrunds der Legende 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 abgekoppelt 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 wurde.
Siehe auch „ setLabelBrush()“.
[signal] void QLegend::labelColorChanged(QColor color)
Dieses Signal wird ausgelöst, wenn sich die Farbe des Pinsels, mit dem die Legendenbeschriftungen gezeichnet werden, in „ color “ ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelColor “.
[signal] void QLegend::markerShapeChanged(QLegend::MarkerShape shape)
Dieses Signal wird ausgelöst, wenn sich die Form der Legendenmarkierungen auf „ shape “ ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ markerShape “.
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 sollen.
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 ausgelöst, wenn die umgekehrte Reihenfolge der Marker in der Legende auf „ reverseMarkers “ geändert wird.
Hinweis: Notifier -Signal für die Eigenschaft „ reverseMarkers “.
void QLegend::setBackgroundVisible(bool visible = true)
Legt die Sichtbarkeit des Legendenhintergrunds auf „ visible “ fest.
Hinweis: Setter -Funktion für die Eigenschaft ` backgroundVisible`.
Siehe auch „ isBackgroundVisible()“.
void QLegend::setBrush(const QBrush &brush)
Legt die „ brush “ fest, die zum Zeichnen des Hintergrunds der Legende verwendet wird.
Siehe auch brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Wenn „ interactive “ auf „ true “ gesetzt ist und die Legende gelöst ist, kann die Legende ähnlich wie ein Fenster mit der Maus verschoben und in der Größe angepasst werden.
Die Legende wird automatisch an einem Rand des Diagramms angeheftet, wenn man sie über diesen Rand hinauszieht. Durch Doppelklicken auf eine angeheftete Legende wird diese wieder gelöst. Dies ist standardmäßig „ false “.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch ` QLegend::isInteractive()`.
void QLegend::setLabelBrush(const QBrush &brush)
Legt den Pinsel fest, der zum Zeichnen der Legendenbeschriftungen verwendet wird: „ brush “.
Siehe auch labelBrush().
void QLegend::setPen(const QPen &pen)
Legt das „ pen “ fest, das zum Zeichnen der Legendenränder verwendet wird.
Siehe auch pen().
void QLegend::setShowToolTips(bool show)
Wenn „ show “ auf „ true “ gesetzt ist, wird ein Tooltip angezeigt, sobald der Mauszeiger über die Legendenbeschriftungen bewegt wird, sofern die Beschriftung selbst gekürzt dargestellt wird. Dies ist standardmäßig „ false “.
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 diese gekürzt sind.
Hinweis: Getter -Funktion für die Eigenschaft „showToolTips“.
Siehe auch „ setShowToolTips()“.
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Dieses Signal wird ausgelöst, wenn die Sichtbarkeit von Tooltips auf „ showToolTips “ geändert wird.
Hinweis: Notifier -Signal für die Eigenschaft „ showToolTips “.
© 2026 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.
