En esta página

Configuración de puntos seleccionados

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

Captura de pantalla en la que se muestra un gráfico de líneas en el que se puede seleccionar un punto concreto y configurarlo con un nombre, un tamaño y un color

Funcionalidades mostradas

Aquí aprenderás a:

  • Seleccionar puntos de una serie haciendo clic sobre ellos.
  • Anular la configuración individual de puntos específicos, configurando:
    • Color
    • Tamaño
    • Visibilidad de la etiqueta
    • Formato de texto de la etiqueta

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Subclase de QMainWindow

Empezamos creando una subclase de QMainWindow que contendrá el gráfico y los controles. Y proporcionamos el código básico para la implementación del constructor:

PointConfigurationWidget::PointConfigurationWidget(QWidget *parent)
    : ContentWidget(parent)
{

Crear una serie de líneas

A continuación, creamos una QLineSeries, le asignamos un nombre, hacemos que los puntos sean visibles y le proporcionamos algunos puntos para trazar.

m_series = new QLineSeries;
m_series->setPointsVisible(true);
m_series->append({QPointF(0, 7),  QPointF(2, 4),
                  QPointF(3, 5),  QPointF(7, 4),
                  QPointF(10, 5), QPointF(11, 1),
                  QPointF(13, 3), QPointF(17, 6),
                  QPointF(18, 3), QPointF(20, 2)});

Crear los controles de configuración de los puntos

Ahora creamos algunos controles para configurar el color, el tamaño, la visibilidad de la etiqueta y la propia etiqueta. Creamos una etiqueta asociada para cada control, de modo que el usuario sepa para qué sirve cada uno.

Para el color y el tamaño, utilizamos un ` QComboBox`, al que le asignamos una variedad de opciones de color y tamaño.

A continuación, creamos los dos controles finales. Una casilla de verificación controla la visibilidad del punto seleccionado. El otro control es un cuadro de texto ( QLineEdit ) que permite al usuario introducir una etiqueta personalizada para el punto.

Ten en cuenta que no establecemos valores iniciales para ninguno de los controles, ya que siempre se seleccionará un punto que muestre su configuración actual.

auto selectedPointIndexLabel = new QLabel(tr("Selected Point: "), this);
m_selectedPointIndexLineEdit = new QLineEdit(this);
m_selectedPointIndexLineEdit->setReadOnly(true);

auto colorLabel = new QLabel(tr("Color: "), this);
m_colorCombobox = new QComboBox(this);
QStringList colorStrings = {"red", "orange", "yellow", "green", "blue",
                            "indigo", "violet", "black"};
QStringList trColorStrings = {tr("red"), tr("orange"), tr("yellow"),
                              tr("green"), tr("blue"), tr("indigo"),
                              tr("violet"), tr("black")};
for (int i = 0; i < colorStrings.size(); i++)
    m_colorCombobox->addItem(QIcon(), trColorStrings[i], QColor(colorStrings[i]));

auto sizeLabel = new QLabel(tr("Size: "), this);
m_sizeCombobox = new QComboBox(this);
for (auto size : { 2, 3, 4, 6, 8, 10, 12, 15 })
    m_sizeCombobox->addItem(QIcon(), QString::number(size), size);

auto labelVisibilityLabel = new QLabel(tr("Label Visibility: "), this);
m_labelVisibilityCheckbox = new QCheckBox(this);

auto customLabelLabel = new QLabel(tr("Custom Label: "), this);
m_customLabelLineEdit = new QLineEdit(this);

Rellenar los controles al seleccionar un punto

Ahora que ya tenemos los controles, debemos implementar la lógica que establezca los valores actuales de los controles para el punto seleccionado. Tenga en cuenta que se utiliza el valor de toda la serie si no hay ninguna personalización para el punto seleccionado. En este caso, si la serie está configurada para mostrar puntos azules, se mostrará un valor de color azul en el cuadro combinado de colores.

Al hacer clic en la serie de líneas, buscamos el punto en el que se ha hecho clic, eliminamos la selección de punto anterior y, a continuación, seleccionamos el punto en el que se ha hecho clic. Esto indica visualmente el punto seleccionado en el gráfico, haciendo que el punto se agrande para indicar su selección. El índice del punto seleccionado actualmente y su « PointConfigurations » se guardan en una variable miembro para su uso posterior.

Se consultan los « PointConfigurations » y se buscan los valores coincidentes en los cuadros combinados. A continuación, se establecen los índices actuales de los cuadros combinados en consecuencia. Del mismo modo, para la casilla de selección y el campo de texto, se buscan los valores en el « PointConfigurations » y se configuran los controles para que coincidan con ellos.

QObject::connect(m_series, &QXYSeries::clicked, m_series, [&](const QPointF &point) {
    int index = m_series->points().indexOf(point.toPoint());
    if (index != -1) {
        m_series->deselectAllPoints();
        m_series->selectPoint(index);
        m_selectedPointIndex = index;
        m_selectedPointConfig = m_series->pointConfiguration(index);
        const QPointF selectedPoint(m_series->at(index));
        m_selectedPointIndexLineEdit->setText("(" + QString::number(selectedPoint.x()) + ", " +
                                              QString::number(selectedPoint.y()) + ")");
        PointConfigurations config = m_series->pointConfiguration(index);

        QVariant colorVar = config[QXYSeries::PointConfiguration::Color];
        QColor color = colorVar.isValid() ? colorVar.value<QColor>() : m_series->color();
        if (m_colorCombobox->findData(color) < 0)
            m_colorCombobox->addItem(color.name(), color);
        m_colorCombobox->setCurrentIndex(m_colorCombobox->findData(color));

        QVariant sizeVar = config[QXYSeries::PointConfiguration::Size];
        qreal size = sizeVar.isValid() ? sizeVar.toReal() : m_series->markerSize();
        if (m_sizeCombobox->findData(size) < 0)
            m_sizeCombobox->addItem(QString::number(size), size);
        m_sizeCombobox->setCurrentIndex(m_sizeCombobox->findData(size));

        QVariant labelVisibilityVar = config[QXYSeries::PointConfiguration::LabelVisibility];
        bool labelVisibility = labelVisibilityVar.isValid() ? labelVisibilityVar.toBool() :
                                                              m_series->pointLabelsVisible();
        m_labelVisibilityCheckbox->setChecked(labelVisibility);

        QVariant customLabelVar = config[QXYSeries::PointConfiguration::LabelFormat];
        QString customLabel = customLabelVar.isValid() ? customLabelVar.toString() : "";
        m_customLabelLineEdit->setText(customLabel);
    }
});

Proporcionar la lógica para configurar el punto seleccionado

Ahora que los controles se han rellenado con la configuración actual, tenemos que hacer que realicen alguna acción. Conectamos sus señales a la lógica que se encargará de configurar el punto seleccionado con el ajuste elegido. Basta con establecer el valor de « QXYSeries::PointConfiguration » asociado al control en la variable miembro « PointConfigurations » de « m_selectedPointConfig » y llamar a « QXYSeries::setPointConfiguration ».

QObject::connect(m_colorCombobox, &QComboBox::activated, m_series, [&](const int) {
    m_selectedPointConfig[QXYSeries::PointConfiguration::Color] = m_colorCombobox->currentData();
    m_series->setPointConfiguration(m_selectedPointIndex, m_selectedPointConfig);
});
QObject::connect(m_sizeCombobox, &QComboBox::activated, m_series, [&](const int) {
    m_selectedPointConfig[QXYSeries::PointConfiguration::Size] = m_sizeCombobox->currentData();
    m_series->setPointConfiguration(m_selectedPointIndex, m_selectedPointConfig);
});
QObject::connect(m_labelVisibilityCheckbox, &QAbstractButton::clicked, m_series, [&](const bool checked) {
    m_selectedPointConfig[QXYSeries::PointConfiguration::LabelVisibility] = checked;
    m_series->setPointConfiguration(m_selectedPointIndex, m_selectedPointConfig);
});
QObject::connect(m_customLabelLineEdit, &QLineEdit::editingFinished, m_series, [&]() {
    m_selectedPointConfig[QXYSeries::PointConfiguration::LabelFormat] = m_customLabelLineEdit->text();
    m_series->setPointConfiguration(m_selectedPointIndex, m_selectedPointConfig);
});

Crear el gráfico y distribuir los controles

Por último, creamos el gráfico y su vista, añadimos las series al gráfico y diseñamos la disposición de la ventana. Como parte de este proceso, nos conectamos a la señal « geometryChanged » para detectar la señal cuando se dibuja el gráfico por primera vez. De este modo, podemos obtener los valores correctos para el punto seleccionado inicialmente. Si lo hacemos antes, los valores de los puntos son incorrectos. Esta conexión se desconecta tras la primera vez que se activa.

auto chart = new QChart;
chart->addSeries(m_series);
chart->createDefaultAxes();
chart->setTitle("Select points with mouse click");
chart->layout()->setContentsMargins(0, 0, 0, 0);
chart->legend()->setVisible(false);

m_selectInitialPointConnection = QObject::connect(chart, &QChart::geometryChanged, chart, [&]() {
    m_series->selectPoint(4);
    m_series->clicked(m_series->at(m_series->selectedPoints()[0]));
    disconnect(m_selectInitialPointConnection);
});

auto chartView = new QChartView(chart, this);
chartView->setRenderHint(QPainter::Antialiasing);

auto controlWidget = new QWidget(this);
auto controlLayout = new QGridLayout(controlWidget);
controlLayout->setColumnStretch(1, 1);

controlLayout->addWidget(selectedPointIndexLabel, 0, 0);
controlLayout->addWidget(m_selectedPointIndexLineEdit, 0, 1);

controlLayout->addWidget(colorLabel, 1, 0);
controlLayout->addWidget(m_colorCombobox, 1, 1);

controlLayout->addWidget(sizeLabel, 2, 0);
controlLayout->addWidget(m_sizeCombobox, 2, 1);

controlLayout->addWidget(labelVisibilityLabel, 3, 0);
controlLayout->addWidget(m_labelVisibilityCheckbox, 3, 1, 1, 2);

controlLayout->addWidget(customLabelLabel, 4, 0);
controlLayout->addWidget(m_customLabelLineEdit, 4, 1);

auto mainLayout = new QHBoxLayout(this);
mainLayout->addWidget(chartView);
mainLayout->setStretch(0, 1);
mainLayout->addWidget(controlWidget);

Ahora disponemos de una aplicación totalmente operativa que muestra cómo personalizar cada uno de los puntos del gráfico.

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