QLegend Class
La clase QLegend muestra la leyenda de un gráfico. Más información...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
| Status: | Deprecated |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Tipos públicos
| enum | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, …, MarkerShapeFromSeries } |
Propiedades
|
|
Funciones públicas
| 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 |
Señales
(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) |
Descripción detallada
Una leyenda es un objeto gráfico que muestra la leyenda de un gráfico. El estado de la leyenda se actualiza mediante ` QChart ` cuando cambian las series. Por defecto, la leyenda está vinculada al gráfico, pero se puede desvincular para que sea independiente del diseño del gráfico. Los objetos de leyenda no se pueden crear ni eliminar, pero se puede hacer referencia a ellos a través de la clase ` QChart `.

Véase también QChart.
Documentación sobre los tipos de miembros
enum QLegend::MarkerShape
Esta enumeración describe la forma que se utiliza al representar los elementos de los marcadores de la leyenda.
| Constante | Valor | Descripción |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | Se utiliza para el marcador la forma predeterminada determinada por QLegend. Este valor solo es compatible con elementos QLegendMarker individuales. |
QLegend::MarkerShapeRectangle | 1 | Se utilizan marcadores rectangulares. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapeCircle | 2 | Se utilizan marcadores circulares. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapeRotatedRectangle | 4 | Se utilizan marcadores con forma de rectángulo girado. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapeTriangle | 5 | Se utilizan marcadores triangulares. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapeStar | 6 | Se utilizan marcadores en forma de estrella. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapePentagon | 7 | Se utilizan marcadores con forma de pentágono. El tamaño del marcador viene determinado por el tamaño de la fuente. |
QLegend::MarkerShapeFromSeries | 3 | La forma del marcador viene determinada por la serie. En el caso de una serie de puntos dispersos, el marcador de la leyenda tiene el aspecto de un punto disperso y es del mismo tamaño que este. En el caso de una serie de líneas o splines, el marcador de la leyenda tiene el aspecto de un pequeño segmento de la línea. Para otros tipos de series, se muestran marcadores rectangulares. Si se especifica un « lightMarker » para una serie, se mostrará el « lightMarker » y su tamaño vendrá determinado por el tamaño del marcador de la serie. |
Véase también « markerShape ».
Documentación de propiedades
alignment : Qt::Alignment
Cómo se alinea la leyenda con el gráfico.
Puede ser « Qt::AlignTop », « Qt::AlignBottom », « Qt::AlignLeft » o « Qt::AlignRight ». Si se establece más de un indicador, el resultado es indefinido.
Funciones de acceso:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Esta propiedad determina si el fondo de la leyenda está visible.
Funciones de acceso:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Señal de notificación:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Esta propiedad define el color de las líneas de la leyenda.
Funciones de acceso:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Señal de notificación:
| void | borderColorChanged(QColor color) |
color : QColor
Esta propiedad establece el color de fondo (del pincel) de la leyenda.
Si cambias el color de la leyenda, el estilo del pincel de la leyenda se establece en « Qt::SolidPattern ».
Funciones de acceso:
| QColor | color() |
| void | setColor(QColor color) |
Señal de notificación:
| void | colorChanged(QColor color) |
font : QFont
Esta propiedad especifica la fuente de los marcadores que utiliza la leyenda.
Funciones de acceso:
| QFont | font() const |
| void | setFont(const QFont &font) |
Señal de notificación:
| void | fontChanged(QFont font) |
labelColor : QColor
Esta propiedad determina el color del pincel utilizado para dibujar las etiquetas.
Funciones de acceso:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Señal de notificación:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
La forma predeterminada de los marcadores de la leyenda. El valor predeterminado es « MarkerShapeRectangle ».
Funciones de acceso:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Señal de notificación:
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
Esta propiedad indica si se utiliza el orden inverso para los marcadores de la leyenda.
Esta propiedad está configurad false e de forma predeterminada.
Funciones de acceso:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Señal de notificación:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Esta propiedad determina si se muestran las descripciones emergentes cuando el texto aparece truncado.
Esta propiedad está e false ada de forma predeterminada.
Funciones de acceso:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Señal del notificador:
| void | showToolTipsChanged(bool showToolTips) |
Documentación de funciones de miembro
[virtual noexcept] QLegend::~QLegend()
Elimina el objeto «legend». La leyenda siempre pertenece a un QChart, por lo que una aplicación nunca debería llamar a esta función.
void QLegend::attachToChart()
Añade la leyenda a un gráfico. El gráfico puede ajustar el diseño de la leyenda.
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Esta señal se emite cuando la leyenda se acop attached a al gráfico o se desacopla de él.
Esta función se introdujo en Qt 6.2.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Esta señal se emite cuando la visibilidad del fondo de la leyenda cambia a « visible ».
Nota: Señalde Notifier para la propiedad « backgroundVisible ».
[signal] void QLegend::borderColorChanged(QColor color)
Esta señal se emite cuando el color del borde del fondo de la leyenda cambia a color.
Nota: Señalde notificación para la propiedad borderColor.
QBrush QLegend::brush() const
Devuelve el pincel utilizado por la leyenda.
Véase también setBrush().
[signal] void QLegend::colorChanged(QColor color)
Esta señal se emite cuando el color del fondo de la leyenda cambia a color.
Nota: Señalde notificador para la propiedad color.
void QLegend::detachFromChart()
Separa la leyenda del gráfico. El gráfico ya no ajustará la disposición de la leyenda.
[signal] void QLegend::fontChanged(QFont font)
Esta señal se emite cuando la fuente de los marcadores de la leyenda cambia a font.
Nota: Señalde notificación para la propiedad « font ».
bool QLegend::isAttachedToChart()
Devuelve « true » si la leyenda está vinculada a un gráfico.
bool QLegend::isBackgroundVisible() const
Devuelve la visibilidad del fondo de la leyenda.
Nota: Funcióngetter para la propiedad « backgroundVisible ».
[since 6.2] bool QLegend::isInteractive() const
Devuelve si la leyenda se puede arrastrar o cambiar de tamaño con el ratón cuando está separada.
Esta función se introdujo en Qt 6.2.
Véase también QLegend::setInteractive().
QBrush QLegend::labelBrush() const
Devuelve el pincel utilizado para dibujar las etiquetas.
Véase también ` setLabelBrush()`.
[signal] void QLegend::labelColorChanged(QColor color)
Esta señal se emite cuando el color del pincel utilizado para dibujar las etiquetas de la leyenda cambia a color.
Nota: Señalde notificación para la propiedad « labelColor ».
[signal] void QLegend::markerShapeChanged(QLegend::MarkerShape shape)
Esta señal se emite cuando la forma de los marcadores de la leyenda cambia a shape.
Nota: Señalde notificación para la propiedad « markerShape ».
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Devuelve la lista de marcadores de la leyenda. La lista se puede filtrar especificando el « series » para el que se devuelven los marcadores.
QPen QLegend::pen() const
Devuelve el lápiz utilizado por la leyenda.
Véase también ` setPen()`.
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Esta señal se emite cuando se cambia el orden inverso de los marcadores de la leyenda a « reverseMarkers ».
Nota: Señalde notificación para la propiedad « reverseMarkers ».
void QLegend::setBackgroundVisible(bool visible = true)
Establece la visibilidad del fondo de la leyenda en « visible ».
Nota: Funciónde configuración para la propiedad backgroundVisible.
Véase también ` isBackgroundVisible()`.
void QLegend::setBrush(const QBrush &brush)
Establece el objeto ` brush ` que se utiliza para dibujar el fondo de la leyenda.
Véase también brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Cuando interactive es true y la leyenda está separada, es posible moverla y cambiar su tamaño con el ratón, de forma similar a como se hace con una ventana.
La leyenda se acoplará automáticamente a un borde del gráfico al arrastrarla fuera de dicho borde. Al hacer doble clic en una leyenda acoplada, esta se desacoplará. Este es el valor predeterminado de ` false `.
Esta función se introdujo en Qt 6.2.
Véase también QLegend::isInteractive().
void QLegend::setLabelBrush(const QBrush &brush)
Establece el pincel utilizado para dibujar las etiquetas de la leyenda en « brush ».
Véase también labelBrush().
void QLegend::setPen(const QPen &pen)
Establece el objeto « pen » que se utiliza para dibujar los bordes de la leyenda.
Véase también pen().
void QLegend::setShowToolTips(bool show)
Cuando ` show ` es ` true`, las etiquetas de la leyenda mostrarán una información emergente al pasar el ratón por encima de ellas si la propia etiqueta se muestra abreviada. El valor predeterminado es ` false `.
Nota: Funciónde asignación para la propiedad showToolTips.
Véase también showToolTips().
bool QLegend::showToolTips() const
Devuelve si se muestran las descripciones emergentes de las etiquetas de la leyenda cuando estas están abreviadas.
Nota: Funcióngetter para la propiedad showToolTips.
Véase también setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Esta señal se emite cuando la visibilidad de las descripciones emergentes cambia a « showToolTips ».
Nota: Señalde notificación para la propiedad « 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.