QCustomSeriesCanvasRenderer Class
La clase `QCustomSeriesCanvasRenderer` permite implementar un renderizado personalizado para un ` QCustomSeries ` cuando se utiliza el backend de pintura de lienzo de alto rendimiento. Más información...
| Encabezado: | #include <QCustomSeriesCanvasRenderer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| Desde: | Qt 6.12 |
Funciones públicas
| QCustomSeriesCanvasRenderer() | |
| virtual void | canvasPrePaint(QCanvasPainter *p) |
| virtual void | initializeResources(QCustomSeries *series, QCanvasPainter *p) |
| virtual void | synchronizeData(QCustomSeries *series, QCanvasPainterItem *item) |
Descripción detallada
Implementa canvasPaint() para dibujar un ` QCustomSeries`. Establece el renderizador en la serie mediante ` QCustomSeries::setCustomSeriesPainter()`, que la serie expone a continuación a través de `QCustomSeries::customSeriesPainter()`.
canvasPaint() y canvasPrePaint() se invocan desde el hilo de renderizado del grafo de escena deQt Quick y, a diferencia de initializeResources() y synchronizeData(), no reciben el QCustomSeries al que pertenecen. Copia todo lo que necesite canvasPaint() en la instancia del renderizador en synchronizeData(), que se ejecuta mientras el hilo de la interfaz gráfica de usuario está bloqueado y es el único lugar donde es seguro leer datos del hilo de la interfaz gráfica de usuario.
Véase también QCustomSeries y QCustomSeries::setCustomSeriesPainter().
Documentación de funciones de miembro
[constexpr noexcept default] QCustomSeriesCanvasRenderer::QCustomSeriesCanvasRenderer()
Crea por defecto una instancia de ` QCustomSeriesCanvasRenderer`.
[virtual] void QCustomSeriesCanvasRenderer::canvasPrePaint(QCanvasPainter *p)
Reimplementa este método para preparar el renderizado utilizando ` p`, basándote en el estado copiado previamente en esta instancia mediante ` synchronizeData()`. Se invoca inmediatamente antes de `canvasPaint()` para esta misma instancia, desde el hilo de renderizado; no accedas aquí al estado de las series ni de los elementos.
Véase también canvasPaint ().
[virtual] void QCustomSeriesCanvasRenderer::initializeResources(QCustomSeries *series, QCanvasPainter *p)
Reimplementa este método para inicializar los recursos de series utilizando p. Se invoca una vez antes de la primera llamada a synchronizeData() para series.
Véase también QCanvasPainter ::addImage y QCanvasPainter::createCanvas.
[virtual] void QCustomSeriesCanvasRenderer::synchronizeData(QCustomSeries *series, QCanvasPainterItem *item)
Reimplementa este método para copiar los datos necesarios para dibujar series desde item a esta instancia del renderizador. Se llama antes de canvasPaint() cada vez que es necesario volver a dibujar series.
Este método es el único lugar en el que es seguro leer directamente el estado de series o item, propiedad de la interfaz gráfica de usuario, ya que se ejecuta mientras el hilo de la interfaz gráfica de usuario está bloqueado en el punto de sincronización de Qt Quick. No accedas a ese estado desde canvasPaint() ni desde canvasPrePaint().
© 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.