En esta página

QSvgGenerator Class

La clase QSvgGenerator proporciona un dispositivo de dibujo que se utiliza para crear dibujos SVG. Más información...

Encabezado: #include <QSvgGenerator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Svg)
target_link_libraries(mytarget PRIVATE Qt6::Svg)
qmake: QT += svg
Heredado de: QPaintDevice

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

(since 6.5) enum class SvgVersion { SvgTiny12, Svg11 }

Propiedades

Funciones públicas

QSvgGenerator()
(since 6.5) QSvgGenerator(QSvgGenerator::SvgVersion version)
virtual ~QSvgGenerator()
QString description() const
QString fileName() const
QIODevice *outputDevice() const
int resolution() const
void setDescription(const QString &description)
void setFileName(const QString &fileName)
void setOutputDevice(QIODevice *outputDevice)
void setResolution(int dpi)
void setSize(const QSize &size)
void setTitle(const QString &title)
void setViewBox(const QRect &viewBox)
void setViewBox(const QRectF &viewBox)
QSize size() const
(since 6.5) QSvgGenerator::SvgVersion svgVersion() const
QString title() const
QRect viewBox() const
QRectF viewBoxF() const

Funciones protegidas reimplementadas

(since 6.11) virtual void initPainter(QPainter *painter) const override
virtual int metric(QPaintDevice::PaintDeviceMetric metric) const override
virtual QPaintEngine *paintEngine() const override

Descripción detallada

Este dispositivo de dibujo representa un dibujo en formato SVG (Scalable Vector Graphics). Al igual que QPrinter, está diseñado como un dispositivo de solo escritura que genera salida en un formato específico.

Para escribir un archivo SVG, primero hay que configurar la salida estableciendo las propiedades ` fileName ` o ` outputDevice `. Normalmente es necesario especificar el tamaño del dibujo estableciendo la propiedad ` size ` y, en algunos casos en los que el dibujo se vaya a incluir dentro de otro, también hay que establecer la propiedad ` viewBox `.

QSvgGenerator generator;
generator.setFileName(path);
generator.setSize(QSize(200, 200));
generator.setViewBox(QRect(0, 0, 200, 200));
generator.setTitle(tr("SVG Generator Drawing"));
generator.setDescription(tr("An SVG drawing created by the SVG Generator"));

Se pueden especificar otros metadatos configurando las propiedades « title », « description » y « resolution ».

Al igual que con otras subclases de ` QPaintDevice `, se utiliza un objeto ` QPainter ` para dibujar sobre una instancia de esta clase:

QPainter painter;
painter.begin(&generator);
...
painter.end();

El dibujo se realiza de la misma manera que con cualquier otro dispositivo de dibujo. Sin embargo, es necesario utilizar los métodos QPainter::begin() y end() para iniciar y finalizar explícitamente el dibujo en el dispositivo.

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

Documentación sobre tipos de miembro

[since 6.5] enum class QSvgGenerator::SvgVersion

Esta enumeración describe la versión de la salida SVG del generador.

ConstanteValorDescripción
QSvgGenerator::SvgVersion::SvgTiny120El documento generado cumple con la especificación SVG Tiny 1.2.
QSvgGenerator::SvgVersion::Svg111El documento generado cumple con la especificación SVG 1.1.

Esta enumeración se introdujo en Qt 6.5.

Documentación de la propiedad

description : QString

Esta propiedad contiene la descripción del dibujo SVG generado

Funciones de acceso:

QString description() const
void setDescription(const QString &description)

Véase también title.

fileName : QString

Esta propiedad contiene el nombre del archivo de destino para el dibujo SVG generado

Funciones de acceso:

QString fileName() const
void setFileName(const QString &fileName)

Véase también outputDevice.

outputDevice : QIODevice*

Esta propiedad indica el dispositivo de salida para el dibujo SVG generado

Si se especifican tanto el dispositivo de salida como el nombre de archivo, tendrá prioridad el dispositivo de salida.

Funciones de acceso:

QIODevice *outputDevice() const
void setOutputDevice(QIODevice *outputDevice)

Véase también fileName.

resolution : int

Esta propiedad indica la resolución del resultado generado

La resolución se especifica en puntos por pulgada y se utiliza para calcular el tamaño físico de un dibujo SVG.

Funciones de acceso:

int resolution() const
void setResolution(int dpi)

Véase también size y viewBox.

size : QSize

Esta propiedad contiene el tamaño del dibujo SVG generado

Por defecto, esta propiedad está establecida en « QSize(-1, -1) », lo que indica que el generador no debe incluir los atributos «width» y «height» del elemento « <svg> ».

Nota: Noes posible modificar esta propiedad mientras haya una restricción de « QPainter » activa en el generador.

Funciones de acceso:

QSize size() const
void setSize(const QSize &size)

Véase también « viewBox » y « resolution ».

title : QString

Esta propiedad contiene el título del dibujo SVG generado

Funciones de acceso:

QString title() const
void setTitle(const QString &title)

Véase también description.

viewBox : QRectF

Esta propiedad contiene el viewBox del dibujo SVG generado

Por defecto, esta propiedad está establecida en « QRect(0, 0, -1, -1) », lo que indica que el generador no debe generar el atributo «viewBox» del elemento « <svg> ».

Nota: Noes posible modificar esta propiedad mientras haya un « QPainter » activo en el generador.

Funciones de acceso:

QRectF viewBoxF() const
void setViewBox(const QRect &viewBox)
void setViewBox(const QRectF &viewBox)

Véase también viewBox(), size y resolution.

Documentación de las funciones de miembro

QSvgGenerator::QSvgGenerator()

Crea un nuevo generador utilizando el perfil SVG Tiny 1.2.

[explicit, since 6.5] QSvgGenerator::QSvgGenerator(QSvgGenerator::SvgVersion version)

Crea un nuevo generador que utiliza la versión SVG version.

Esta función se introdujo en Qt 6.5.

[virtual noexcept] QSvgGenerator::~QSvgGenerator()

Destruye el generador.

[override virtual protected, since 6.11] void QSvgGenerator::initPainter(QPainter *painter) const

Esta función se introdujo en Qt 6.11.

[override virtual protected] int QSvgGenerator::metric(QPaintDevice::PaintDeviceMetric metric) const

Reimplementa: ` QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const`.

[override virtual protected] QPaintEngine *QSvgGenerator::paintEngine() const

Reimplementa: ` QPaintDevice::paintEngine()` const.

Devuelve información sobre el motor de pintura utilizado para renderizar los gráficos que se van a convertir al formato SVG.

[since 6.5] QSvgGenerator::SvgVersion QSvgGenerator::svgVersion() const

Devuelve la versión del documento SVG que está generando este generador.

Esta función se introdujo en Qt 6.5.

QRect QSvgGenerator::viewBox() const

Devuelve viewBoxF().toRect().

Véase también setViewBox() y viewBoxF().

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