Cómo ocultar y mostrar las leyendas

Nota: Esto forma parte del ejemplo «Galería de gráficos con widgets ».

Por defecto, el gráfico dibuja la leyenda dentro de la misma vista gráfica en la que se encuentra el gráfico. En algunos casos, es posible que el usuario desee dibujar la leyenda en otro lugar. Para que esto sea posible, la leyenda se puede separar del gráfico. Separarla significa que la leyenda ya no está fijada a un borde del gráfico, y que este ya no controla su disposición. En su lugar, el usuario controla la geometría de la leyenda, lo que permite controlar libremente su ubicación y tamaño. Puede flotar sobre el contenido del gráfico o incluso dibujarse en una escena gráfica diferente. El comportamiento de la leyenda se puede comprobar ejecutando este ejemplo.

En este ejemplo mostramos una serie de barras, que permite añadir o eliminar conjuntos de barras de forma interactiva. La leyenda refleja los cambios en la serie a medida que se añaden o se eliminan conjuntos de barras. La unión de la leyenda, su alineación y la posibilidad de moverla y cambiar su tamaño se pueden controlar mediante los métodos de QLegend.

Cuando la leyenda está separada, se puede cambiar su tamaño y colocarla libremente. Si la función interactiva de la leyenda está activada, el usuario puede arrastrarla y cambiar su tamaño libremente. Si el usuario arrastra la leyenda fuera de cualquier lado del gráfico, se volverá a acoplar automáticamente a ese lado del gráfico.

Captura de pantalla en la que se muestra un ejemplo de cómo separar la leyenda de un gráfico de barras, junto con diferentes opciones para configurar el gráfico

Captura de pantalla en la que se muestra otro ejemplo de separación de la leyenda en un gráfico de barras, con diferentes opciones para configurar el gráfico

Aquí hacemos visible la leyenda y configuramos su alineación en la parte inferior del gráfico.

m_chart->legend()->setVisible(true);
m_chart->legend()->setAlignment(Qt::AlignBottom);

Este fragmento de código muestra cómo separar la leyenda del gráfico.

legend->detachFromChart();

Aquí volvemos a acoplar la leyenda al gráfico. El fondo se vuelve invisible.

legend->attachToChart();

Aquí nos conectamos a la señal emitida cuando la leyenda se separa o se vuelve a acoplar, activando su fondo cuando está separada y desactivándolo cuando está acoplada. Esto facilita ver cómo están dispuestos los elementos dentro de la leyenda cuando está separada.

connect(legend, &QLegend::attachedToChartChanged, [legend, this](bool attachedToChart) {
    m_toggleAttachedButton->setChecked(attachedToChart);
    legend->setBackgroundVisible(!attachedToChart);
    m_geometrySettings->setDisabled(attachedToChart);
});

Esto muestra cómo hacer que la leyenda sea interactiva para el usuario mediante un dispositivo señalador, como un ratón.

legend->setInteractive(true);

Aquí se muestra cómo configuramos las dimensiones de la leyenda separada si esta no es interactiva. Tras establecer los nuevos valores, llamamos a la función «update» para mostrar los cambios en pantalla.

    QRectF geom = m_chart->legend()->geometry();
    if (qFuzzyCompare(geom.x(), m_legendPosX->value())
            && qFuzzyCompare(geom.y(), m_legendPosY->value())
            && qFuzzyCompare(geom.width(), m_legendWidth->value())
            && qFuzzyCompare(geom.height(), m_legendHeight->value()))
        return;

    m_chart->legend()->setGeometry(QRectF(m_legendPosX->value(),
                                          m_legendPosY->value(),
                                          m_legendWidth->value(),
                                          m_legendHeight->value()));
    m_chart->legend()->update();

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