En esta página

Qt Graphs Migración desde Qt DataVisualization

La API y la funcionalidad entre Qt DataVisualization y Qt Graphs se han mantenido prácticamente sin cambios. Sin embargo, hay algunas diferencias que deben tenerse en cuenta al migrar tu aplicación de Qt DataVisualization a Qt Graphs:

  • Declaración de importación en QML
  • Inclusión del módulo CMake
  • Inclusión del módulo qmake
  • Creación de la aplicación de widgets
  • Requisito de utilizar el backend de OpenGL
  • Clases eliminadas
  • API eliminadas
  • API modificadas

Declaración de importación de QML

La instrucción de importación en Qt DataVisualization:

import QtDataVisualization

se ha cambiado a:

import QtGraphs

para « Qt Graphs ».

Inclusión del módulo CMake

La inclusión en Qt DataVisualization:

find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)

se ha cambiado a:

find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)

para Qt Graphs.

Inclusión del módulo Qmake

La inclusión en Qt DataVisualization:

QT += datavisualization

se cambia a:

QT += graphs

para Qt Graphs.

Creación de una aplicación de widgets

Para crear un gráfico en una aplicación de widget, cambia tu código de:

Q3DBars *barGraph = new Q3DBars();
QWidget *barsWidget = new QWidget();
QWidget *container = QWidget::createWindowContainer(barGraph, barsWidget);

auto *hLayout = new QHBoxLayout(barsWidget);
hLayout->addWidget(container, 1);

por:

QQuickWidget *quickWidget = new QQuickWidget();
Q3DBarsWidgetItem *barGraph = new Q3DBarsWidgetItem();
barGraph->setWidget(quickWidget);

auto *hLayout = new QHBoxLayout(quickWidget);

Requisito para utilizar el backend de OpenGL

Para utilizar « Qt Graphs 3D», ya no es necesario forzar el uso del backend de OpenGL:

// Remove this line
qputenv("QSG_RHI_BACKEND", "opengl");

Qt Graphs utiliza « Qt Quick » 3D para el renderizado y, por lo tanto, es compatible con los backends de renderizado nativos de la plataforma en la que se ejecuta.

Clases eliminadas

  • Q3DCamera
  • Q3DLight
  • Q3DObject
  • Q3DTheme

API eliminadas

  • hasContext
  • shadowsSupported
  • reflection
  • reflectivity

API modificadas

  • optimizaciónSugerencia
  • modo de renderizado
  • renderizar a imagen
  • ColorGradient y ColorGradientStop
  • Color del tema
  • API de datos
  • API de cámara
  • API de temas
  • Enumeraciones

optimizationHint

Legacy es ahora el modo que antes se denominaba « OptimizationDefault » en QtDataVisualization. « Default » utiliza instanciación y debe utilizarse para todos los destinos que la admitan.

renderingMode

RenderDirectToBackground_NoClear se ha eliminado, ya que ya estaba obsoleto en QtDataVisualization en Qt 6.

renderToImage

renderToImage ahora devuelve « QSharedPointer<QQuickItemGrabResult> » en lugar de « QImage », y ya no admite « msaaSamples » como parámetro.

ColorGradient y ColorGradientStop

ColorGradient son ahora ` Gradient ` y ` ColorGradientStop ` ` GradientStop`.

ThemeColor

ThemeColor ahora es Color.

API de datos

Ya no es necesario crear matrices de datos con new. Por ejemplo, cuando se creaban datos para un gráfico de barras en Qt DataVisualization, se hacía así:

// Qt DataVisualization approach.
QBarDataRow *data = new QBarDataRow;
*data << 1.0f << 3.0f << 7.5f << 5.0f << 2.2f;

Ahora se hace así:

// Qt Graphs approach.
QBarDataRow data;
data << 1.0f << 3.0f << 7.5f << 5.0f << 2.2f;
series->dataProxy()->addRow(data);

API de cámara

Dado que se ha eliminado Q3DCamera, las funciones necesarias de la misma se han trasladado. cameraPreset, cameraTargetPosition, cameraXRotation, cameraYRotation, cameraZoomLevel, wrapCameraXRotation, and wrapCameraYRotation ahora forman parte de GraphsItem3D.

API de temas

Dado que se ha eliminado Q3DTheme y se ha unificado la aplicación de temas entre los gráficos 2D y 3D, algunas de las funciones necesarias de esta biblioteca se han trasladado, y el resto se pueden encontrar en su sustituto, GraphsTheme. lightColor, ambientLightStrength, lightStrength, and shadowStrength se implementa ahora en GraphsItem3D.

windowColor Se ha eliminado. backgroundColor realiza ahora lo que antes hacía windowColor, y una nueva función, plotAreaBackgroundColor, sustituye la funcionalidad que antes ofrecía backgroundColor.

La combinación de colores genérica de todo el gráfico se controla ahora mediante la propiedad color scheme, y los colores de las series mediante la propiedad theme. Si no se establece explícitamente una combinación de colores, se seguirá la temática del escritorio (clara/oscura).

Enumeraciones

En Qt Graphs, todas las enumeraciones se implementan como enumeraciones con ámbito; por ejemplo, para la propiedad QAbstract3DGraph::ShadowQualityLow en Qt DataVisualization, la enumeración correspondiente en Qt Graphs es QtGraphs3D::ShadowQuality::Low.

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