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 |
- Lista de todos los miembros, incluidos los heredados
- QSvgGenerator forma parte de las clases de pintura.
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.
| Constante | Valor | Descripción |
|---|---|---|
QSvgGenerator::SvgVersion::SvgTiny12 | 0 | El documento generado cumple con la especificación SVG Tiny 1.2. |
QSvgGenerator::SvgVersion::Svg11 | 1 | El 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) |
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.