En esta página

Q3DScatterWidgetItem Class

La clase Q3DScatterWidgetItem ofrece métodos para representar gráficos de dispersión en 3D. Más información...

Encabezado: #include <Q3DScatterWidgetItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS GraphsWidgets)
target_link_libraries(mytarget PRIVATE Qt6::GraphsWidgets)
qmake: QT += graphswidgets
Heredado de: Q3DGraphsWidgetItem

Propiedades

Funciones públicas

Q3DScatterWidgetItem(QObject *parent = nullptr)
virtual ~Q3DScatterWidgetItem() override
void addAxis(QValue3DAxis *axis)
void addSeries(QScatter3DSeries *series)
QList<QValue3DAxis *> axes() const
QValue3DAxis *axisX() const
QValue3DAxis *axisY() const
QValue3DAxis *axisZ() const
void releaseAxis(QValue3DAxis *axis)
void removeSeries(QScatter3DSeries *series)
QScatter3DSeries *selectedSeries() const
QList<QScatter3DSeries *> seriesList() const

Ranuras públicas

void setAxisX(QValue3DAxis *axis)
void setAxisY(QValue3DAxis *axis)
void setAxisZ(QValue3DAxis *axis)

Señales

void axisXChanged(QValue3DAxis *axis)
void axisYChanged(QValue3DAxis *axis)
void axisZChanged(QValue3DAxis *axis)
void selectedSeriesChanged(QScatter3DSeries *series)

Descripción detallada

Esta clase permite a los desarrolladores generar gráficos de dispersión en 3D y visualizarlos girando libremente la escena. La rotación se realiza manteniendo pulsado el botón derecho del ratón y moviendo el ratón, mientras que el zoom se controla mediante la rueda del ratón. Si está habilitada, la selección se realiza con el botón izquierdo del ratón. La escena se puede restablecer a la vista predeterminada de la cámara haciendo clic con la rueda del ratón. En dispositivos táctiles, la rotación se realiza tocando y desplazando el dedo, la selección tocando y manteniendo pulsado, y el zoom pellizcando con los dedos.

Si no se definen ejes de forma explícita en Q3DScatterWidgetItem, se crean ejes predeterminados temporales sin etiquetas. Estos ejes predeterminados pueden modificarse mediante los accesores de ejes, pero tan pronto como se defina explícitamente un eje para una orientación, el eje predeterminado para esa orientación se elimina.

Q3DScatterWidgetItem admite que haya más de una serie visible al mismo tiempo.

Q3DScatterWidgetItem admite la transparencia. Esta característica permite ajustar la opacidad de los puntos del gráfico de dispersión, haciéndolos parcialmente transparentes, totalmente transparentes u opacos.

Cómo crear un gráfico Q3DScatterWidgetItem mínimo

En primer lugar, crea un objeto `Q3DScatterWidgetItem`. Dado que en este ejemplo vamos a ejecutar el gráfico como ventana de nivel superior, debemos desactivar el indicador ` Qt::FramelessWindowHint `, que está activado por defecto:

QQuickWidget quickWidget;
Q3DScatterWidgetItem scatter;
scatter.setWidget(&quickWidget);
scatter.widget()->setMinimumSize(QSize(256, 256));

Ahora Q3DScatterWidgetItem está listo para recibir los datos que se van a representar. Añade una serie de tres elementos « QVector3D »:

Nota: En la nueva relación de serie proxy, los datos se almacenan en series. Por lo tanto, para que el proxy pueda añadir, eliminar o editar los datos, es imprescindible crear primero una serie.

QScatter3DSeries series;
QScatterDataArray data;
data << QScatterDataItem(0.5f, 0.5f, 0.5f) << QScatterDataItem(-0.3f, -0.5f, -0.4f)
     << QScatterDataItem(0.0f, -0.3f, 0.2f);
series.dataProxy()->addItems(data);
scatter.addSeries(&series);

Por último, tendrás que configurarlo como visible:

scatter.widget()->show();

El código completo necesario para crear y mostrar este gráfico es:

#include <QtGraphs>
#include <QtGraphsWidgets/q3dscatterwidgetitem.h>
#include <QtWidgets/qapplication.h>

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QQuickWidget quickWidget;
    Q3DScatterWidgetItem scatter;
    scatter.setWidget(&quickWidget);
    scatter.widget()->setMinimumSize(QSize(256, 256));
    QScatter3DSeries series;
    QScatterDataArray data;
    data << QScatterDataItem(0.5f, 0.5f, 0.5f) << QScatterDataItem(-0.3f, -0.5f, -0.4f)
         << QScatterDataItem(0.0f, -0.3f, 0.2f);
    series.dataProxy()->addItems(data);
    scatter.addSeries(&series);
    scatter.widget()->show();

    return app.exec();
}

Y esto es lo que producen esas pocas líneas de código:

Gráfico de dispersión en 3D con esferas verdes

La escena se puede girar, ampliar y se puede seleccionar un elemento para ver su posición, pero este ejemplo de código mínimo no incluye otras interacciones. Puedes obtener más información familiarizándote con los ejemplos proporcionados, como el «Gráfico de dispersión simple».

Véase también Q3DBarsWidgetItem, Q3DSurfaceWidgetItem y Qt Graphs : clases de C++ para 3D.

Documentación de propiedades

axisX : QValue3DAxis*

Esta propiedad indica el eje X activo.

Establece axis como el eje X activo. Llama implícitamente a addAxis() para transferir la propiedad del eje a este gráfico.

Si axis es nulo, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

Funciones de acceso:

QValue3DAxis *axisX() const
void setAxisX(QValue3DAxis *axis)

Señal de notificación:

void axisXChanged(QValue3DAxis *axis)

Véase también addAxis() y releaseAxis().

axisY : QValue3DAxis*

Esta propiedad indica el eje Y activo.

Establece ` axis ` como el eje Y activo. Llama implícitamente a ` addAxis()` para transferir la propiedad del eje a este gráfico.

Si axis es nulo, se crea un eje predeterminado temporal sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

Funciones de acceso:

QValue3DAxis *axisY() const
void setAxisY(QValue3DAxis *axis)

Señal de notificador:

void axisYChanged(QValue3DAxis *axis)

Véase también addAxis() y releaseAxis().

axisZ : QValue3DAxis*

Esta propiedad indica el eje Z activo.

Establece axis como el eje Z activo. Llama implícitamente a addAxis() para transferir la propiedad del eje a este gráfico.

Si axis es nulo, se crea un eje predeterminado temporal sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

Funciones de acceso:

QValue3DAxis *axisZ() const
void setAxisZ(QValue3DAxis *axis)

Señal de notificación:

void axisZChanged(QValue3DAxis *axis)

Véase también addAxis() y releaseAxis().

[read-only] selectedSeries : QScatter3DSeries*

Esta propiedad contiene la serie seleccionada o el valor nulo.

Funciones de acceso:

QScatter3DSeries *selectedSeries() const

Señal de notificación:

void selectedSeriesChanged(QScatter3DSeries *series)

Documentación de funciones de miembro

[explicit] Q3DScatterWidgetItem::Q3DScatterWidgetItem(QObject *parent = nullptr)

Crea un nuevo gráfico de dispersión en 3D con la opción « parent ».

[override virtual noexcept] Q3DScatterWidgetItem::~Q3DScatterWidgetItem()

Elimina el gráfico de dispersión en 3D.

void Q3DScatterWidgetItem::addAxis(QValue3DAxis *axis)

Añade axis al gráfico. Los ejes añadidos mediante addAxis aún no se consideran en uso; addAxis se utiliza simplemente para asignar la propiedad de axis al gráfico. axis no debe ser nulo ni estar añadido a otro gráfico.

Véase también releaseAxis(), setAxisX(), setAxisY() y setAxisZ().

void Q3DScatterWidgetItem::addSeries(QScatter3DSeries *series)

Añade la serie « series » al gráfico. Un gráfico puede contener varias series, pero solo tiene un conjunto de ejes. Si la serie recién añadida tiene un elemento seleccionado, este se resaltará y se anulará cualquier selección existente. Solo una de las series añadidas puede tener una selección activa.

Véase también Q3DGraphsWidgetItem::hasSeries().

QList<QValue3DAxis *> Q3DScatterWidgetItem::axes() const

Devuelve la lista de todos los ejes añadidos.

Véase también addAxis().

void Q3DScatterWidgetItem::releaseAxis(QValue3DAxis *axis)

Devuelve la propiedad del « axis » al llamante, si se ha añadido a este gráfico. Si el « axis » liberado está en uso, se creará un nuevo eje predeterminado y se activará.

Si el eje predeterminado se libera y se vuelve a añadir más tarde, se comportará como cualquier otro eje.

Véase también « addAxis()», « setAxisX()», « setAxisY()» y « setAxisZ()».

void Q3DScatterWidgetItem::removeSeries(QScatter3DSeries *series)

Elimina el « series » del gráfico.

Véase también Q3DGraphsWidgetItem::hasSeries().

QList<QScatter3DSeries *> Q3DScatterWidgetItem::seriesList() const

Devuelve la lista de series añadidas a este gráfico.

Véase también Q3DGraphsWidgetItem::hasSeries().

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