Gráficos 2D en Qt Widgets
Uso de gráficos 2D en una aplicación basada en widgets.
Los gráficos 2D solo son compatibles con aplicaciones de tipo « Qt Quick ». Este ejemplo muestra cómo mostrar un sencillo gráfico circular 2D en una aplicación de tipo « Qt Widgets » utilizando un QQuickWidget.

Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en « Examples ». Para obtener más información, consulta «Qt Creator »: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Vista principal
- La clase `
PieWidget` implementa la vista principal de la aplicación de demostración. En la clase `PieWidget`, instancie los widgets utilizados para implementar el diseño de la aplicación y los elementos de la interfaz de usuario.m_quickWidget = new QQuickWidget; m_widget = new QWidget; m_vLayout = new QVBoxLayout(m_widget); m_hLayout = new QHBoxLayout; ... - La clase `
PieGraph` se utiliza para gestionar la lógica de añadir y eliminar porciones, además de ofrecer otras funcionalidades.m_pieGraph = new PieGraph; ... - Inicializa los botones y añádelos al diseño.
void PieWidget::initializeButtons() { QPushButton *addButton = new QPushButton("Add Slice"); QPushButton *removeButton = new QPushButton("Remove Slice"); QPushButton *explodeButton = new QPushButton("Explode All"); QPushButton *clearButton = new QPushButton("Clear Series"); m_hLayout->addWidget(addButton); m_hLayout->addWidget(removeButton); m_hLayout->addWidget(explodeButton); m_hLayout->addWidget(clearButton); QObject::connect(addButton, &QPushButton::clicked, m_pieGraph, &PieGraph::onAddSlice); QObject::connect(removeButton, &QPushButton::clicked, m_pieGraph, &PieGraph::onRemoveSlice); QObject::connect(explodeButton, &QPushButton::clicked, m_pieGraph, &PieGraph::onExplode); QObject::connect(clearButton, &QPushButton::clicked, m_pieGraph, &PieGraph::onClearSeries); }
Manipulación de datos de Graph
La clase ` PieGraph ` implementa toda la lógica para manipular datos del gráfico en este ejemplo.
- En la clase `
PieGraph`, declara una propiedad `pieSeries`.... Q_PROPERTY(QPieSeries *pieSeries READ pieSeries WRITE setPieSeries NOTIFY pieSeriesChanged FINAL) ... - Crea funciones para añadir, eliminar, expandir porciones y borrar series de gráficos circulares.
... public: ... void appendSlice(); void removeSlice(); void explodeSlices(); void clearSeries(); void fillSliceInfo(); public Q_SLOTS: void onAddSlice(); void onRemoveSlice(); void onExplode(); void onClearSeries(); ... - Instancia una serie de gráfico circular y añade varias porciones en tu constructor.
... m_pieSeries = new QPieSeries; fillSliceInfo(); for (int i = 1; i < 5; ++i) { QPieSlice *slice = new QPieSlice; slice->setValue(m_sliceInfo.value.at(QRandomGenerator::global()->bounded(0, 6))); slice->setLabel(m_sliceInfo.label.at(QRandomGenerator::global()->bounded(0, 6))); slice->setLabelColor(m_sliceInfo.color.at(QRandomGenerator::global()->bounded(0, 6))); m_pieSeries->append(slice); } m_pieSeries->setLabelsVisible(true); ... - La función `
appendSlice` crea un ` QPieSlice`, establece algunas de sus propiedades y, a continuación, lo añade a la serie circular.Ten en cuenta que, aunque hayas establecido la visibilidad de las etiquetas en «
true», esto no funciona en los sectores añadidos posteriormente a la serie de gráficos circulares. Debes establecer la visibilidad en «true» al crear cada sector que añadas.QPieSlice *slice = new QPieSlice; slice->setValue(m_sliceInfo.value.at(QRandomGenerator::global()->bounded(0, 6))); slice->setLabel(m_sliceInfo.label.at(QRandomGenerator::global()->bounded(0, 6))); slice->setLabelColor(m_sliceInfo.color.at(QRandomGenerator::global()->bounded(0, 6))); slice->setLabelVisible(true); m_pieSeries->append(slice); - En la función «
removeSlice», llama a « QPieSeries::remove()». - En la función «
explodeSlices», recorre todas las porciones y establece « QPieSlice::setExploded()» en «true» o «false», según el estado actual. - En la función «
clearSeries», llama a « QPieSeries::clear()». Esto eliminará todas las porciones de tu serie circular. Ten en cuenta que esta función no elimina la serie circular en sí.
Inicialización de GraphsView
Para personalizar el tema de GraphsView, crea un archivo QGraphsTheme personalizado.
auto theme = new QGraphsTheme(m_quickWidget);
theme->setTheme(QGraphsTheme::Theme::BlueSeries);
theme->setLabelBorderVisible(true);
theme->setLabelBackgroundVisible(true);
theme->setBackgroundColor(Qt::black);Utiliza QQuickWidget::loadFromModule() para cargar el GraphsView. Inicializa sus propiedades theme y seriesList pasando los valores QGraphsTheme y QPieSeries a QQuickWidget::setInitialProperties().
m_quickWidget->setResizeMode(QQuickWidget::SizeRootObjectToView);
m_quickWidget->resize(1280, 720);
m_quickWidget->setInitialProperties({
{"theme", QVariant::fromValue(theme) },
{"seriesList", QVariant::fromValue(m_pieGraph->pieSeries()) }
});
m_quickWidget->loadFromModule("QtGraphs", "GraphsView");© 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.