Gráfico de dispersión sencillo
Uso de « Scatter3D » en una aplicación QML.
«Gráfico de dispersión sencillo» muestra cómo crear una visualización sencilla de un gráfico de dispersión utilizando Scatter3D y QML.
Para obtener instrucciones sobre cómo interactuar con el gráfico, consulta esta página.
Para obtener instrucciones sobre cómo crear tu propia aplicación de Qt Quick, consulta la ayuda de Qt Creator.

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.
Configuración del diseño
Antes de adentrarse en el código QML, main.cpp configura la aplicación. El archivo main.qml se lee desde el recurso (qrc:)
viewer.setSource(QUrl("qrc:/qml/scatter/main.qml"));Este archivo ` main.qml ` es el punto de partida para el código QML de la aplicación. En primer lugar, importa todos los módulos QML necesarios:
import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
import QtGraphsA continuación, crea un elemento « Data », que será el que contenga los datos del gráfico.
Data {
id: seriesData
}A continuación, crea dos elementos « GraphsTheme » que definan dos temas diferentes para el gráfico: un tema «Qt Green» y un tema «Qt Neon Green».
GraphsTheme {
id: themeQt
theme: GraphsTheme.Theme.QtGreen
labelFont.pointSize: 40
}
GraphsTheme {
id: themeQtNeonGreen
theme: GraphsTheme.Theme.QtGreenNeon
colorScheme: GraphsTheme.ColorScheme.Dark
}El diseño de esta aplicación constará de cinco botones diferentes para activar y desactivar distintas opciones visuales del gráfico y, por supuesto, del propio gráfico. Hay muchas formas de organizarlos; una de ellas es utilizar un elemento « GridLayout » que contenga cuatro botones —el « Graph » y el quinto botón—, todos ellos dentro de un elemento « ColumnLayout ».
ColumnLayout {
id: mainLayout
anchors.fill: parent
anchors.margins: margin
spacing: spacingEl GridLayout es responsivo. Esto significa que el número de columnas utilizadas depende del ancho de la ventana de la aplicación. Esto se consigue asignando a la propiedad columns un operador ternario, cuyo valor es 1, 2 o 4, dependiendo del ancho de la ventana.
GridLayout {
Layout.fillWidth: true
rowSpacing: spacing
columnSpacing: spacing
columns: mainView.width < mainView.buttonMinWidth * 2 + mainView.spacing + mainView.margin * 2 // width of 2 buttons
? 1
: (mainView.width < mainView.buttonMinWidth * 4 + mainView.spacing * 3 + mainView.margin * 2 // width of 4 buttons
? 2
: 4)En este « GridLayout », se instancian cuatro « RoundButton». Uno para activar o desactivar las sombras, otro para suavizar la malla, otro para la posición de la cámara y, por último, otro para cambiar el fondo del gráfico. Todos los botones siguen la misma estructura. En lugar de redefinir esta estructura para todos los botones, se puede crear un componente personalizado.
component CustomButton : RoundButton {
id: buttonRootCustomButtom extends the RoundButton type, but adds a few additions. Se establecen propiedades como Layout.minimumWidth, Layout.FillWidth, radius y background. Estas definen el estilo y el diseño del botón.
property alias source: iconImage.source
Layout.minimumWidth: buttonMinWidth
Layout.fillWidth: true
radius: mainView.radius
background: Rectangle {
radius: mainView.radius
color: "white"
border.color: "black"
}Por su parte, la propiedad « contentItem » define el contenido del botón; en este caso, un objeto de tipo « Row » que contiene un icono y algo de texto. El icono se importa utilizando un tipo « Image » y configurando la propiedad « source ». El texto se crea utilizando un tipo « Label » y se configura mediante su propiedad « text ». Se crean dos alias para estas dos propiedades en la parte superior del componente personalizado, lo que permitirá configurarlas cuando se cree una instancia de « CustomButton ».
contentItem: Row {
id: content
Image {
id: iconImage
}
Label {
text: buttonRoot.text
horizontalAlignment: Text.AlignLeft
anchors.verticalCenter: parent.verticalCenter
}
}En el ` GridLayout`, se crean cuatro ` CustomButton`. Es necesario establecer tres propiedades: los dos alias para la imagen del icono y el texto, y la señal ` onClicked`.
CustomButton {
id: shadowButton
text: graph.shadowQuality === Graphs3D.ShadowQuality.None ?
qsTr("Show Shadows") : qsTr("Hide Shadows")
source: graph.shadowQuality === Graphs3D.ShadowQuality.None ?
"qrc:/images/shadow.svg" : "qrc:/images/shadow_hide.svg"
onClicked: {
graph.shadowQuality = graph.shadowQuality === Graphs3D.ShadowQuality.None ?
Graphs3D.ShadowQuality.High :
Graphs3D.ShadowQuality.None
}
}Por ejemplo, el botón «sombra» configura la señal onClicked para activar y desactivar la sombra.
Configuración del gráfico
A continuación en el diseño se encuentra el « Graph », que se define en su propio archivo QML « Graph.qml » y se instancia de la siguiente manera:
Graph {
id: graph
Layout.fillWidth: true
Layout.fillHeight: true
}Si observamos su implementación en Graph.qml, el gráfico es de tipo Scatter3D, anidado dentro de un tipo Item.
Scatter3D {
id: scatterGraphAntes de definir los conjuntos de datos, se configuran algunas de las propiedades de los ejes.
axisX.segmentCount: 3
axisX.subSegmentCount: 2
axisX.labelFormat: "%.2f"
axisZ.segmentCount: 2
axisZ.subSegmentCount: 2
axisZ.labelFormat: "%.2f"
axisY.segmentCount: 2
axisY.subSegmentCount: 2
axisY.labelFormat: "%.2f"Configuración de los datos
El gráfico muestra tres conjuntos de datos, que representan los datos proporcionados en Data.qml. Los conjuntos de datos se almacenan en tipos ListModel
ListModel {
id: dataModel
ListElement{ xPos: -10.0; yPos: 5.0; zPos: -5.0 }
...
ListElement{ xPos: -7.54 ; yPos: 2.8 ; zPos: -3.68 }
}
ListModel {
id: dataModelTwo
ListElement{ xPos: 2.25 ; yPos: 1.36 ; zPos: -1.3 }
...
ListElement{ xPos: -3.4 ; yPos: 0.6 ; zPos: 0.9 }
}
ListModel {
id: dataModelThree
ListElement{ xPos: 8.0; yPos: -2.0; zPos: 4.0 }
...
ListElement{ xPos: 5.66 ; yPos: -4.98 ; zPos: 3.72 }
}y se exponen a los demás archivos mediante property aliases
property alias model: dataModel
property alias modelTwo: dataModelTwo
property alias modelThree: dataModelThreeAntes de utilizar estos alias, cree un tipo « Scatter3DSeries » que contenga un elemento « ItemModelScatterDataProxy ».
Scatter3DSeries {
id: scatterSeries
itemLabelFormat: "Series 1: X:@xLabel Y:@yLabel Z:@zLabel"
ItemModelScatterDataProxy {
itemModel: seriesData.model
xPosRole: "xPos"
yPosRole: "yPos"
zPosRole: "zPos"
}
}Este proxy de datos hace referencia a los conjuntos de datos en Data.qml mediante su propiedad itemModel. Se accede a los alias mencionados anteriormente a través de la id del tipo Data instanciado en main.qml, seriesData.
itemModel: seriesData.modelRepite este proceso con los dos conjuntos de datos restantes.
Scatter3DSeries {
id: scatterSeriesTwo
...
ItemModelScatterDataProxy {
itemModel: seriesData.modelTwo
...
}
}
Scatter3DSeries {
id: scatterSeriesThree
...
ItemModelScatterDataProxy {
itemModel: seriesData.modelThree
...
}
}Genial, el gráfico de dispersión ahora apunta a los tres conjuntos de datos.
Lo único que queda por hacer es añadir el botón restante, el « theme button », a nuestro « ColumnLayout ». La única diferencia con este botón es que está situado en el lado izquierdo del diseño. Esto se configura definiendo la propiedad « Layout.alignment » como « Qt.AlignLeft » y « Layout.fillWidth » como « false ».
CustomButton {
id: themeButton
Layout.alignment: Qt.AlignLeft
Layout.fillWidth: falseContenido del ejemplo
© 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.