QScatter3DSeries Class
La clase QScatter3DSeries representa una serie de datos en un gráfico de dispersión en 3D. Más información...
| Encabezado: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Scatter3DSeries |
| Heredado de: | QAbstract3DSeries |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- QScatter3DSeries forma parte de las clases C++ deQt Graphs para 3D.
Propiedades
|
Funciones públicas
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() override |
| QValue3DAxis * | axisX() const |
| QValue3DAxis * | axisY() const |
| QValue3DAxis * | axisZ() const |
| void | clearArray() |
| void | clearScaleArray() |
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| void | resetAxisX() |
| void | resetAxisY() |
| void | resetAxisZ() |
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| qsizetype | selectedItem() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | setAxisY(QValue3DAxis *axis) |
| void | setAxisZ(QValue3DAxis *axis) |
| void | setDataArray(const QScatterDataArray &newDataArray) |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
| void | setSelectedItem(qsizetype index) |
Señales
| void | axisXChanged(QValue3DAxis *axis) |
| void | axisYChanged(QValue3DAxis *axis) |
| void | axisZChanged(QValue3DAxis *axis) |
| void | dataArrayChanged(const QScatterDataArray &array) |
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
| void | selectedItemChanged(qsizetype index) |
Miembros públicos estáticos
| qsizetype | invalidSelectionIndex() |
Descripción detallada
Esta clase gestiona los elementos visuales específicos de la serie, así como los datos de la serie (a través de un proxy de datos).
En cuanto a la relación entre el proxy y la serie, es fundamental destacar un par de puntos clave. En este contexto, los datos se almacenan en series y los usuarios pueden acceder al conjunto de datos a través de las series. Esta serie está controlada o representada por un objeto proxy. Por lo tanto, el proxy puede utilizarse para gestionar diversas operaciones sobre los datos y actualizar el conjunto de datos real. Sin embargo, es necesario crear una serie asociada a este proxy para editar el conjunto de datos.
Si no se establece explícitamente ningún proxy de datos para la serie, esta crea un proxy por defecto. Establecer otro proxy destruirá el proxy existente y todos los datos añadidos a la serie.
QScatter3DSeries admite las siguientes etiquetas de formato para QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Título del eje x |
| @yTitle | Título del eje y |
| @zTitle | Título del eje z |
| @xLabel | Valor del elemento formateado según el formato del eje x. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @yLabel | Valor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @zLabel | Valor del elemento formateado según el formato del eje z. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @seriesName | Nombre de la serie |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));Véase también Qt Graphs Manejo de datos en 3D.
Documentación de propiedades
[since 6.11] axisX : QValue3DAxis*
Incluye un eje X adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | resetAxisX() |
Señal de notificación:
| void | axisXChanged(QValue3DAxis *axis) |
[since 6.11] axisY : QValue3DAxis*
Incluye un eje Y adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
| void | resetAxisY() |
Señal de notificación:
| void | axisYChanged(QValue3DAxis *axis) |
[since 6.11] axisZ : QValue3DAxis*
Incluye un eje Z adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisZ() const |
| void | setAxisZ(QValue3DAxis *axis) |
| void | resetAxisZ() |
Señal de notificador:
| void | axisZChanged(QValue3DAxis *axis) |
dataArray : QScatterDataArray
Matriz de datos de la serie.
Contiene la referencia al conjunto de datos.
La señal «dataArrayChanged» se emite cuando se establece el matriz de datos, a menos que « newDataArray » sea idéntico al anterior.
Nota: Antes de realizar cualquier acción relacionada con el matriz de datos, se debe crear una serie para el proxy correspondiente.
Funciones de acceso:
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| void | setDataArray(const QScatterDataArray &newDataArray) |
Señal del notificador:
| void | dataArrayChanged(const QScatterDataArray &array) |
Véase también ` clearArray()`.
dataProxy : QScatterDataProxy*
Esta propiedad contiene el proxy de datos activo.
Establece el proxy de datos activo de la serie en proxy. La serie asume la propiedad de cualquier proxy que se le asigne y elimina cualquier proxy establecido anteriormente cuando se añade uno nuevo. El argumento proxy no puede ser nulo ni estar asignado a otra serie.
Funciones de acceso:
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Señal de notificación:
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
Tamaño del artículo para la serie.
El tamaño debe estar comprendido entre 0.0f y 1.0f. Si se establece el tamaño en 0.0f, el tamaño de los elementos se ajustará automáticamente en función del número total de elementos de todas las series del gráfico.
El valor predeterminado es 0.0f.
Funciones de acceso:
| float | itemSize() const |
| void | setItemSize(float size) |
Señal de notificación:
| void | itemSizeChanged(float size) |
scaleArray : QList<QVector3D>
Matriz de escalas para la serie.
Contiene la referencia al array de escala.
La señal «scaleArrayChanged» se emite cuando se establece el matriz de escala, a menos que « newScaleArray » sea idéntico al anterior.
Nota: Antes de realizar cualquier acción relacionada con el array de escala, debe crearse una serie para el proxy correspondiente.
Nota: Si no se especifica una escala para los datos, se utilizará un valor por defecto de (1,0; 1,0; 1,0).
Funciones de acceso:
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
Señal de notificación:
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
Véase también ` clearScaleArray()`.
selectedItem : qsizetype
Esta propiedad contiene el elemento seleccionado en la serie.
Selecciona el elemento situado en el índice index en la matriz de datos de la serie. Solo se puede seleccionar un elemento a la vez.
Para borrar la selección de esta serie, se establece invalidSelectionIndex() como index. Si esta serie se añade a un gráfico, este puede ajustar la selección en función de la interacción del usuario o si deja de ser válida. Seleccionar un elemento de otra serie añadida también borrará la selección.
Si se eliminan elementos de la serie o se insertan elementos antes del elemento seleccionado, la selección se ajustará de modo que dicho elemento siga seleccionado.
Funciones de Access:
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Señal de notificación:
| void | selectedItemChanged(qsizetype index) |
Véase también Q3DGraphsWidgetItem::clearSelection().
Documentación de funciones de miembro
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Crea una serie de dispersión en 3D con el elemento principal « parent ».
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Crea una serie de dispersión en 3D con el proxy de datos dataProxy y el elemento principal parent.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Elimina la serie 3D de puntos dispersos.
void QScatter3DSeries::clearArray()
Borra la matriz de datos.
void QScatter3DSeries::clearScaleArray()
Borra la matriz «scale».
[static] qsizetype QScatter3DSeries::invalidSelectionIndex()
Devuelve un índice no válido para la selección. Este índice se asigna a la propiedad selectedItem para borrar la selección de esta serie.
Véase también Q3DGraphsWidgetItem::clearSelection().
© 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.