QScatter3DSeries Class
La clase QScatter3DSeries representa una serie de datos en un gráfico de dispersión 3D. Más...
| Cabecera: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Scatter3DSeries |
| Hereda de: | QAbstract3DSeries |
| Heredado por: |
- Lista de todos los miembros, incluyendo los heredados
- QScatter3DSeries es parte de Qt Graphs C++ Classes for 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 las series, así como los datos de las series (a través de un proxy de datos).
En cuanto a la relación proxy-serie, es crucial 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 la serie. Esta serie está controlada o representada por un objeto proxy. Así, 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, ésta crea un proxy por defecto. Si se establece otro proxy, se destruirá el proxy existente y todos los datos añadidos a la serie.
QScatter3DSeries admite las siguientes etiquetas de formato para QAbstract3DSeries::setItemLabelFormat():
| @xTitulo | Título del eje x |
| @yTitulo | Título del eje y |
| @zTítulo | Título del eje z |
| @etiquetax | Valor del elemento formateado utilizando el formato del eje x. Para obtener más información, consulte QValue3DAxis::labelFormat. |
| @yEtiqueta | Valor del elemento formateado utilizando el formato del eje y. Para más información, consulte QValue3DAxis::labelFormat. |
| @zEtiqueta | Valor del elemento formateado utilizando el formato del eje z. Para más información, consulte QValue3DAxis::labelFormat. |
| @nombreSerie | Nombre de la serie |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));
Véase también Qt Graphs Manejo de datos con 3D.
Documentación de propiedades
[since 6.11] axisX : QValue3DAxis*
Mantiene un eje X adicional para la serie Si se da un eje, la serie se ajustará a los valores mínimo y máximo del eje.
Esta propiedad se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | resetAxisX() |
Señal del notificador:
| void | axisXChanged(QValue3DAxis *axis) |
[since 6.11] axisY : QValue3DAxis*
Mantiene un eje Y adicional para la serie Si se da un eje, la serie se ajustará a los valores mínimo y máximo del eje.
Esta propiedad se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
| void | resetAxisY() |
Señal del notificador:
| void | axisYChanged(QValue3DAxis *axis) |
[since 6.11] axisZ : QValue3DAxis*
Mantiene un eje Z adicional para la serie Si se da un eje, la serie se ajustará a los valores mínimo y máximo del eje.
Esta propiedad se introdujo en Qt 6.11.
Funciones de acceso:
| QValue3DAxis * | axisZ() const |
| void | setAxisZ(QValue3DAxis *axis) |
| void | resetAxisZ() |
Señal del notificador:
| void | axisZChanged(QValue3DAxis *axis) |
dataArray : QScatterDataArray
Matriz de datos para la serie.
Contiene la referencia a la matriz de datos.
La señal dataArrayChanged se emite cuando se establece la matriz de datos, a menos que newDataArray sea idéntica a la anterior.
Nota: Antes de hacer nada con respecto a la matriz de datos, debe crearse una serie para el proxy correspondiente.
Funciones de acceso:
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| void | setDataArray(const QScatterDataArray &newDataArray) |
Señal de 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 para la serie en proxy. La serie asume la propiedad de cualquier proxy establecido para ella y borra cualquier proxy establecido previamente cuando se añade uno nuevo. El argumento proxy no puede ser nulo ni asignarse 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 entre 0.0f y 1.0f. Establecer el tamaño en 0.0f hace que el tamaño del elemento se escale automáticamente basándose en el 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 del notificador:
| void | itemSizeChanged(float size) |
scaleArray : QList<QVector3D>
Matriz de escala para la serie.
Contiene la referencia a la matriz de escala.
La señal scaleArrayChanged se emite cuando se establece la matriz de escala, a menos que newScaleArray sea idéntica a la anterior.
Nota: Antes de hacer nada con respecto a la matriz 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 del notificador:
| 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 en el índice index en la matriz de datos de la serie. Sólo se puede seleccionar un elemento a la vez.
Para borrar la selección de esta serie, invalidSelectionIndex() se establece como index. Si se añade esta serie a un gráfico, éste puede ajustar la selección según la interacción del usuario o si deja de ser válida. La selección de un elemento en otra serie añadida también borrará la selección.
Eliminar elementos de la serie o insertar elementos en ella antes del elemento seleccionado ajustará la selección de modo que el mismo elemento permanecerá seleccionado.
Funciones de acceso:
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Señal de aviso:
| void | selectedItemChanged(qsizetype index) |
Véase también Q3DGraphsWidgetItem::clearSelection().
Documentación de las funciones miembro
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Construye una serie de dispersión 3D con el padre parent.
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Construye una serie 3D de dispersión con el proxy de datos dataProxy y el padre parent.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Borra la serie 3D de dispersión.
void QScatter3DSeries::clearArray()
Borra la matriz de datos.
void QScatter3DSeries::clearScaleArray()
Borra la matriz de escala.
[static] qsizetype QScatter3DSeries::invalidSelectionIndex()
Devuelve un índice inválido para la selección. Este índice se establece en 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.
