QLegend Class
La clase QLegend muestra la leyenda de un gráfico. Más...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
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 se adjunta al gráfico, pero puede separarse para hacerla independiente del diseño del gráfico. Los objetos de leyenda no se pueden crear ni borrar, pero se puede hacer referencia a ellos a través de la clase QChart.
Véase también QChart.
Documentación de tipos de miembros
enum QLegend::MarkerShape
Este enum describe la forma utilizada al representar los elementos del marcador de leyenda.
| Constante | Valor | Descripción |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | La forma predeterminada determinada por QLegend se utiliza para el marcador. Este valor sólo se admite para elementos individuales de QLegendMarker. |
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 en 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 dispersión, el marcador de leyenda se parece a un punto de dispersión y tiene el mismo tamaño que el punto. En el caso de una serie lineal o spline, el marcador de leyenda se parece a 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, Qt::AlignRight. Si establece más de una bandera, el resultado es indefinido.
Funciones de acceso:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Esta propiedad indica si el fondo de la leyenda es visible.
Funciones de acceso:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Señal del notificador:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Esta propiedad contiene el color de la línea de la leyenda.
Funciones de acceso:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Señal del notificador:
| void | borderColorChanged(QColor color) |
color : QColor
Esta propiedad contiene el color de fondo (pincel) de la leyenda.
Si cambia 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 del notificador:
| void | colorChanged(QColor color) |
font : QFont
Esta propiedad contiene la fuente de los marcadores utilizados por la leyenda.
Funciones de acceso:
| QFont | font() const |
| void | setFont(const QFont &font) |
Señal del notificador:
| void | fontChanged(QFont font) |
labelColor : QColor
Esta propiedad contiene el color del pincel utilizado para dibujar las etiquetas.
Funciones de acceso:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Señal del notificador:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
La forma por defecto de los marcadores de leyenda. El valor por defecto es MarkerShapeRectangle.
Funciones de acceso:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Señal del notificador:
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
Esta propiedad indica si se utiliza el orden inverso para los marcadores de la leyenda.
Esta propiedad es false por defecto.
Funciones de acceso:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Señal del notificador:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Esta propiedad indica si se muestra información sobre herramientas cuando el texto está truncado.
Esta propiedad es false por defecto.
Funciones de acceso:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Señal del notificador:
| void | showToolTipsChanged(bool showToolTips) |
Documentación de funciones miembro
[virtual noexcept] QLegend::~QLegend()
Destruye el objeto leyenda. La leyenda siempre es propiedad de QChart, por lo que una aplicación nunca debería llamar a esta función.
void QLegend::attachToChart()
Adjunta 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 es attached o separada del gráfico.
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ñal notificadora 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ñal notificadora 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ñal notificadora para la propiedad color.
void QLegend::detachFromChart()
Desvincula la leyenda del gráfico. El gráfico ya no ajustará el diseño 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ñal notificadora de la propiedad font.
bool QLegend::isAttachedToChart()
Devuelve true, si la leyenda está adjunta a un gráfico.
bool QLegend::isBackgroundVisible() const
Devuelve la visibilidad del fondo de la leyenda.
Nota: Función Getter para la propiedad backgroundVisible.
[since 6.2] bool QLegend::isInteractive() const
Devuelve si la leyenda puede ser arrastrada o redimensionada usando 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ñal notificadora para la propiedad labelColor.
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Devuelve la lista de marcadores de la leyenda. La lista puede filtrarse especificando la dirección series para la que se devuelven los marcadores.
QPen QLegend::pen() const
Devuelve la pluma utilizada por la leyenda.
Véase también setPen().
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Esta señal se emite cuando se cambia el uso del orden inverso para los marcadores de la leyenda a reverseMarkers.
Nota: Señal notificadora para la propiedad reverseMarkers.
void QLegend::setBackgroundVisible(bool visible = true)
Establece la visibilidad del fondo de la leyenda en visible.
Nota: Función Setter para la propiedad backgroundVisible.
Véase también isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Establece el 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, ésta puede moverse y cambiar de tamaño con el ratón de forma similar a como se hace con una ventana.
La leyenda se adjuntará automáticamente a un borde del gráfico arrastrándola fuera de ese borde. Si hace doble clic en una leyenda adjunta, ésta se desprenderá. Esto es false por defecto.
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 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 un tooltip cuando el ratón pase sobre ellas si la propia etiqueta se muestra elidida. Esto es false por defecto.
Nota: Función Setter para la propiedad showToolTips.
Véase también showToolTips().
bool QLegend::showToolTips() const
Devuelve si se muestran los tooltips para las etiquetas de la leyenda cuando están elididas.
Nota: Función Getter para la propiedad showToolTips.
Véase también setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Esta señal se emite cuando se cambia la visibilidad de la información sobre herramientas a showToolTips.
Nota: Señal notificadora 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.
