En esta página

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 `.

Captura de pantalla en la que solo se ven las leyendas de un gráfico de barras que aparece borroso

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.

ConstanteValorDescripción
QLegend::MarkerShapeDefault0Se utiliza para el marcador la forma predeterminada determinada por QLegend. Este valor solo es compatible con elementos QLegendMarker individuales.
QLegend::MarkerShapeRectangle1Se utilizan marcadores rectangulares. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapeCircle2Se utilizan marcadores circulares. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapeRotatedRectangle4Se utilizan marcadores con forma de rectángulo girado. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapeTriangle5Se utilizan marcadores triangulares. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapeStar6Se utilizan marcadores en forma de estrella. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapePentagon7Se utilizan marcadores con forma de pentágono. El tamaño del marcador viene determinado por el tamaño de la fuente.
QLegend::MarkerShapeFromSeries3La 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.