En esta página

QLegendMarker Class

La clase QLegendMarker es un objeto abstracto que se puede utilizar para acceder a los marcadores de una leyenda. Más información...

Header: #include <QLegendMarker>
Inherits: QObject
Inherited By:

QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker, QPieLegendMarker, and QXYLegendMarker

Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum LegendMarkerType { LegendMarkerTypeArea, LegendMarkerTypeBar, LegendMarkerTypePie, LegendMarkerTypeXY, LegendMarkerTypeBoxPlot, LegendMarkerTypeCandlestick }

Propiedades

Funciones públicas

virtual ~QLegendMarker()
QBrush brush() const
QFont font() const
bool isVisible() const
QString label() const
QBrush labelBrush() const
QPen pen() const
virtual QAbstractSeries *series() = 0
void setBrush(const QBrush &brush)
void setFont(const QFont &font)
void setLabel(const QString &label)
void setLabelBrush(const QBrush &brush)
void setPen(const QPen &pen)
void setShape(QLegend::MarkerShape shape)
void setVisible(bool visible)
QLegend::MarkerShape shape() const
virtual QLegendMarker::LegendMarkerType type() = 0

Señales

void brushChanged()
void clicked()
void fontChanged()
void hovered(bool status)
void labelBrushChanged()
void labelChanged()
void penChanged()
void shapeChanged()
void visibleChanged()

Descripción detallada

Un marcador de leyenda consta de un icono y una etiqueta. El color del icono se corresponde con el color utilizado para dibujar una serie, y la etiqueta muestra el nombre de la serie (o la etiqueta del sector, en el caso de una serie de gráficos circulares, o del conjunto de barras, en el caso de una serie de gráficos de barras). Un marcador de leyenda siempre está relacionado con una serie, un sector o un conjunto de barras.

Gráfico de barras porcentuales con una leyenda debajo en la que se identifican los cinco conjuntos de barras por colores

Véase también QLegend.

Documentación sobre tipos de miembros

enum QLegendMarker::LegendMarkerType

El tipo del objeto marcador de leyenda.

ConstanteValorDescripción
QLegendMarker::LegendMarkerTypeArea0Un marcador de leyenda para una serie de área.
QLegendMarker::LegendMarkerTypeBar1Un marcador de leyenda para un conjunto de barras.
QLegendMarker::LegendMarkerTypePie2Un marcador de leyenda para un sector circular.
QLegendMarker::LegendMarkerTypeXY3Un marcador de leyenda para una serie de líneas, splines o puntos dispersos.
QLegendMarker::LegendMarkerTypeBoxPlot4Un marcador de leyenda para una serie de diagramas de caja.
QLegendMarker::LegendMarkerTypeCandlestick5Un marcador de leyenda para una serie de velas japonesas.

Documentación de propiedades

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar el icono.

Funciones de acceso:

QBrush brush() const
void setBrush(const QBrush &brush)

Señal de notificación:

void brushChanged()

font : QFont

Esta propiedad contiene la fuente de la etiqueta.

Funciones de acceso:

QFont font() const
void setFont(const QFont &font)

Señal de notificación:

void fontChanged()

label : QString

Esta propiedad contiene el texto que aparece en la leyenda de un marcador de leyenda.

Funciones de acceso:

QString label() const
void setLabel(const QString &label)

Señal de notificación:

void labelChanged()

labelBrush : QBrush

Esta propiedad contiene el pincel de la etiqueta.

Funciones de acceso:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Señal de notificación:

pen : QPen

Esta propiedad contiene el lápiz utilizado para dibujar el contorno del icono.

Funciones de acceso:

QPen pen() const
void setPen(const QPen &pen)

Señal de notificación:

void penChanged()

shape : QLegend::MarkerShape

La forma del marcador de leyenda. El valor predeterminado es « QLegend::MarkerShapeDefault », lo que indica que la forma viene determinada por la propiedad « QLegend::markerShape ».

Funciones de acceso:

QLegend::MarkerShape shape() const
void setShape(QLegend::MarkerShape shape)

Señal de notificación:

void shapeChanged()

visible : bool

Esta propiedad determina la visibilidad del marcador de la leyenda.

La visibilidad afecta tanto a la etiqueta del marcador de la leyenda como al icono.

Funciones de acceso:

bool isVisible() const
void setVisible(bool visible)

Señal de notificación:

Documentación de las funciones de miembro

[virtual noexcept] QLegendMarker::~QLegendMarker()

Elimina el marcador de leyenda.

QBrush QLegendMarker::brush() const

Devuelve el pincel utilizado para rellenar el icono.

Nota: Funcióngetter para la propiedad brush.

Véase también setBrush().

[signal] void QLegendMarker::brushChanged()

Esta señal se emite cuando cambia el pincel del marcador de leyenda.

Nota: Señalde notificación para la propiedad « brush ».

[signal] void QLegendMarker::clicked()

Esta señal se emite al hacer clic en el marcador de la leyenda.

QFont QLegendMarker::font() const

Devuelve la fuente de la etiqueta.

Nota: Funcióngetter para la propiedad «font».

Véase también setFont().

[signal] void QLegendMarker::fontChanged()

Esta señal se emite cuando cambia la fuente (etiqueta) del marcador de la leyenda.

Nota: Señalde notificación para la propiedad « font ».

[signal] void QLegendMarker::hovered(bool status)

Esta señal se emite cuando se pasa el ratón por encima del marcador de la leyenda. Cuando el ratón se desplaza sobre el marcador, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

bool QLegendMarker::isVisible() const

Devuelve la visibilidad del marcador.

Nota: Funcióngetter para la propiedad « visible ».

QString QLegendMarker::label() const

Devuelve la etiqueta del marcador.

Nota: Funcióngetter para la propiedad «label».

Véase también setLabel().

QBrush QLegendMarker::labelBrush() const

Devuelve el pincel que se utiliza para dibujar la etiqueta.

Nota: Funcióngetter para la propiedad labelBrush.

Véase también setLabelBrush().

[signal] void QLegendMarker::labelBrushChanged()

Esta señal se emite cuando cambia el pincel de etiqueta del marcador de la leyenda.

Nota: Señalde notificador para la propiedad « labelBrush ».

[signal] void QLegendMarker::labelChanged()

Esta señal se emite cuando ha cambiado la etiqueta del marcador de la leyenda.

Nota: Señalde notificación para la propiedad « label ».

QPen QLegendMarker::pen() const

Devuelve el lápiz utilizado para dibujar el contorno del icono.

Nota: Funcióngetter para la propiedad pen.

Véase también ` setPen()`.

[signal] void QLegendMarker::penChanged()

Esta señal se emite cuando cambia el trazo del marcador de la leyenda.

Nota: Señalde notificación para la propiedad « pen ».

[pure virtual] QAbstractSeries *QLegendMarker::series()

Devuelve un puntero a la serie asociada a este marcador de leyenda. Un marcador de leyenda siempre está asociado a una serie.

void QLegendMarker::setBrush(const QBrush &brush)

Establece el pincel utilizado para rellenar el icono en « brush ».

Nota: Al cambiar el color de la serie, también cambia el color del icono.

Nota: Funciónde asignación para la propiedad brush.

Véase también ` brush()`.

void QLegendMarker::setFont(const QFont &font)

Establece la fuente de la etiqueta en « font ».

Nota: Funciónde asignación para la propiedad font.

Véase también ` font()`.

void QLegendMarker::setLabel(const QString &label)

Establece la etiqueta del marcador como « label ».

Nota: Al cambiar el nombre de una serie, también cambia la etiqueta de su marcador.

Nota: Funciónde asignación para la propiedad label.

Véase también ` label()`.

void QLegendMarker::setLabelBrush(const QBrush &brush)

Establece el pincel utilizado para dibujar la etiqueta en « brush ».

Nota: Funciónde asignación para la propiedad ` labelBrush`.

Véase también ` labelBrush()`.

void QLegendMarker::setPen(const QPen &pen)

Establece la propiedad ` pen `, utilizada para dibujar el contorno del icono, en ` pen`.

Nota: Funciónde asignación para la propiedad ` pen`.

Véase también ` pen()`.

void QLegendMarker::setVisible(bool visible)

Establece la visibilidad del marcador en « visible ».

Nota: Funciónde asignación para la propiedad visible.

Véase también ` isVisible()`.

[pure virtual] QLegendMarker::LegendMarkerType QLegendMarker::type()

Devuelve el tipo del marcador de leyenda correspondiente a la serie, la porción de gráfico circular o el conjunto de barras en cuestión.

Véase también LegendMarkerType.

[signal] void QLegendMarker::visibleChanged()

Esta señal se emite cuando cambia la visibilidad del marcador de la leyenda.

Nota: Señalde notificador para la propiedad « visible ».

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