En esta página

QGraphicsSvgItem Class

La clase `QGraphicsSvgItem` es un objeto de tipo « QGraphicsItem » que se puede utilizar para representar el contenido de archivos SVG. Más información...

Encabezado: #include <qgraphicssvgitem.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)
target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets)
qmake: QT += svgwidgets
Heredado de: QGraphicsObject

Propiedades

Funciones públicas

QGraphicsSvgItem(QGraphicsItem *parent = nullptr)
QGraphicsSvgItem(const QString &fileName, QGraphicsItem *parent = nullptr)
QString elementId() const
QSize maximumCacheSize() const
QSvgRenderer *renderer() const
void setElementId(const QString &id)
void setMaximumCacheSize(const QSize &size)
void setSharedRenderer(QSvgRenderer *renderer)

Funciones públicas reimplementadas

virtual QRectF boundingRect() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override
virtual int type() const override

Descripción detallada

QGraphicsSvgItem permite renderizar archivos SVG en un objeto ` QGraphicsView`. QGraphicsSvgItem se puede crear pasando el archivo SVG que se va a renderizar a su constructor o estableciendo explícitamente un ` QSvgRenderer ` compartido en él.

Ten en cuenta que establecer ` QSvgRenderer ` en un `QGraphicsSvgItem` no hace que el elemento adquiera la propiedad del renderizador; por lo tanto, si se utiliza el método ` setSharedRenderer()`, hay que asegurarse de que el tiempo de vida del objeto ` QSvgRenderer ` sea, como mínimo, igual de largo que el del `QGraphicsSvgItem`.

QGraphicsSvgItem ofrece la posibilidad de renderizar solo partes de los archivos SVG mediante la función setElementId. Si se invoca el método setElementId(), solo se renderizará el elemento SVG (y sus hijos) con el identificador (id) pasado. Esto proporciona una forma cómoda de renderizar de forma selectiva archivos SVG de gran tamaño que contienen varios elementos independientes. Por ejemplo, el siguiente código representa únicamente los comodines de un archivo SVG que contiene una baraja completa:

QSvgRenderer *renderer = new QSvgRenderer(QLatin1String("SvgCardDeck.svg"));
QGraphicsSvgItem *black = new QGraphicsSvgItem();
QGraphicsSvgItem *red   = new QGraphicsSvgItem();

black->setSharedRenderer(renderer);
black->setElementId(QLatin1String("black_joker"));

red->setSharedRenderer(renderer);
red->setElementId(QLatin1String("red_joker"));

El tamaño del elemento se puede ajustar manipulando directamente su matriz de transformación.

Por defecto, la representación SVG se almacena en caché utilizando el modo « QGraphicsItem::DeviceCoordinateCache » para acelerar la visualización de los elementos. El almacenamiento en caché se puede desactivar pasando ` QGraphicsItem::NoCache ` al método ` QGraphicsItem::setCacheMode()`.

Véase también QSvgWidget, Qt SVG C++ Classes, QGraphicsItem y QGraphicsView.

Documentación de propiedades

elementId : QString

Esta propiedad contiene el identificador XML del elemento.

Funciones de acceso:

QString elementId() const
void setElementId(const QString &id)

maximumCacheSize : QSize

Esta propiedad indica el tamaño máximo de la caché de coordenadas del dispositivo para este elemento.

Funciones de acceso:

QSize maximumCacheSize() const
void setMaximumCacheSize(const QSize &size)

Documentación de funciones de miembro

QGraphicsSvgItem::QGraphicsSvgItem(QGraphicsItem *parent = nullptr)

Crea un nuevo elemento SVG con el ` parent` indicado.

QGraphicsSvgItem::QGraphicsSvgItem(const QString &fileName, QGraphicsItem *parent = nullptr)

Crea un nuevo elemento con el ` parent ` indicado y carga el contenido del archivo SVG con el ` fileName` especificado.

[override virtual] QRectF QGraphicsSvgItem::boundingRect() const

Reimplementa: ` QGraphicsItem::boundingRect()` const.

Devuelve el rectángulo delimitador de este elemento.

QString QGraphicsSvgItem::elementId() const

Devuelve el identificador XML del elemento que se está representando en ese momento. Devuelve una cadena vacía si se está representando el archivo completo.

Nota: Funcióngetter para la propiedad elementId.

Véase también setElementId().

QSize QGraphicsSvgItem::maximumCacheSize() const

Devuelve el tamaño máximo actual de la caché de coordenadas del dispositivo para este elemento. Si el elemento se almacena en caché utilizando el modo « QGraphicsItem::DeviceCoordinateCache », se omite el almacenamiento en caché si la extensión del elemento en coordenadas del dispositivo es mayor que el tamaño máximo.

El tamaño máximo predeterminado de la caché es 1024x768. La función ` QPixmapCache::cacheLimit()` proporciona los límites acumulados de toda la caché, mientras que `maximumCacheSize()` se refiere al tamaño máximo de la caché para este elemento en concreto.

Nota: Funcióngetter para la propiedad maximumCacheSize.

Véase también setMaximumCacheSize() y QGraphicsItem::cacheMode().

[override virtual] void QGraphicsSvgItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Reimplementa: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

QSvgRenderer *QGraphicsSvgItem::renderer() const

Devuelve el ` QSvgRenderer` que se está utilizando actualmente.

void QGraphicsSvgItem::setElementId(const QString &id)

Establece el ID XML del elemento en « id ».

Nota: Funciónde asignación para la propiedad elementId.

Véase también elementId().

void QGraphicsSvgItem::setMaximumCacheSize(const QSize &size)

Establece el tamaño máximo de la caché de coordenadas del dispositivo del elemento en size. Si el elemento se almacena en caché utilizando el modo QGraphicsItem::DeviceCoordinateCache, el almacenamiento en caché se omite si la extensión del elemento en coordenadas del dispositivo es mayor que size.

La caché corresponde a QPixmap, que se utiliza para almacenar en caché los resultados del renderizado. Utiliza QPixmapCache::setCacheLimit() para establecer limitaciones en toda la caché y utiliza setMaximumCacheSize() al establecer el tamaño de la caché para elementos individuales.

Nota: Funciónsetter para la propiedad maximumCacheSize.

Véase también maximumCacheSize() y QGraphicsItem::cacheMode().

void QGraphicsSvgItem::setSharedRenderer(QSvgRenderer *renderer)

Establece ` renderer ` como un ` QSvgRenderer ` compartido en el elemento. Al utilizar este método, se puede compartir el mismo ` QSvgRenderer ` en varios elementos. Esto significa que el archivo SVG solo se analizará una vez. El ` QSvgRenderer ` pasado a este método debe existir mientras se utilice este elemento.

[override virtual] int QGraphicsSvgItem::type() const

Reimplementa: QGraphicsItem::type() const.

© 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.