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 DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Scatter3DSeries |
| Heredado de: | QAbstract3DSeries |
| Estado: | Obsoleta |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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 misma (a través de un proxy de datos).
Si no se establece explícitamente ningún proxy de datos para la serie, esta crea un proxy por defecto. Al establecer otro proxy, se eliminará el proxy existente y todos los datos añadidos al mismo.
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::setLabelFormat(). |
| @yLabel | Valor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::setLabelFormat(). |
| @zLabel | Valor del elemento con el formato del eje z. Para obtener más información, consulta QValue3DAxis::setLabelFormat(). |
| @seriesName | Nombre de la serie |
Por ejemplo:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Véase también «Manejo de datos»en Qt Data Visualization .
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 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) |
selectedItem : int
Esta propiedad contiene el elemento seleccionado en la serie.
Funciones de acceso:
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Señal de notificación:
| void | selectedItemChanged(int index) |
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 dato proxy dataProxy y el elemento principal parent.
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Elimina la serie 3D de datos dispersos.
[static] int 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 QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
Establece el proxy de datos activo de la serie en proxy. La serie asume la titularidad 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.
Nota: Funciónde asignación para la propiedad dataProxy.
Véase también dataProxy().
void QScatter3DSeries::setSelectedItem(int index)
Selecciona el elemento con 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 o se insertan elementos en la serie antes del elemento seleccionado, la selección se ajustará de modo que ese mismo elemento permanezca seleccionado.
Nota: Funciónde configuración 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.