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 DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Scatter3DSeries |
| Hereda: | QAbstract3DSeries |
Propiedades
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
Funciones públicas
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| int | selectedItem() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(int index) |
Señales
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(int index) |
Miembros públicos estáticos
| int | 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).
Si no se establece ningún proxy de datos explícitamente para la serie, la serie crea un proxy por defecto. Establecer otro proxy destruirá el proxy existente y todos los datos añadidos a él.
QScatter3DSeries soporta 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::setLabelFormat(). |
| @yEtiqueta | Valor del elemento formateado utilizando el formato del eje y. Para más información, consulte QValue3DAxis::setLabelFormat(). |
| @zEtiqueta | Valor del elemento formateado utilizando el formato del eje z. Para más información, véase QValue3DAxis::setLabelFormat(). |
| @nombreSerie | Nombre de la serie. |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Véase también Qt Data Visualization Manejo de datos.
Documentación de propiedades
dataProxy : QScatterDataProxy*
Esta propiedad contiene el proxy de datos activo.
Funciones de acceso:
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Señal del notificador:
| 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) |
selectedItem : int
Esta propiedad contiene el elemento seleccionado en la serie.
Funciones de acceso:
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Señal del notificador:
| void | selectedItemChanged(int index) |
Documentación de la función miembro
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Construye una serie 3D de dispersión 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.
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Borra la serie 3D de dispersión.
[static] int QScatter3DSeries::invalidSelectionIndex()
Devuelve un índice no vá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 QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
Establece el proxy de datos activo para la serie en proxy. La serie asume la propiedad de cualquier proxy establecido para ella y elimina cualquier proxy establecido previamente cuando se añade uno nuevo. El argumento proxy no puede ser nulo ni asignarse a otra serie.
Nota: Función Setter para la propiedad dataProxy.
Véase también dataProxy().
void QScatter3DSeries::setSelectedItem(int index)
Selecciona el elemento del í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 forma que el mismo elemento permanecerá seleccionado.
Nota: Función Setter para la propiedad selectedItem.
Véase también selectedItem() y QAbstract3DGraph::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.
