Back to Qt.io
Contact Us Blog Download Qt

QSvgGenerator Class

QSvgGenerator 类提供了一个用于创建 SVG 图形的绘制设备。更多

头文件 #include <QSvgGenerator>
CMake： find_package(Qt6 REQUIRED COMPONENTS Svg)
target_link_libraries(mytarget PRIVATE Qt6::Svg)
qmake： QT += svg
继承： QPaintDevice

注意：该类中的所有函数都是可重入的。

公共类型

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

属性

公共函数

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

重新实现的受保护函数

virtual int metric(QPaintDevice::PaintDeviceMetric metric) const override
virtual QPaintEngine *paintEngine() const override

详细说明

该绘图设备表示可扩展矢量图形（SVG）绘图。与 QPrinter 一样，它被设计为只写设备，以特定格式生成输出。

要写入 SVG 文件，首先需要通过设置fileName 或outputDevice 属性来配置输出。通常需要通过设置size 属性来指定图纸的大小，在某些情况下，如果图纸将包含在另一个图纸中，还需要设置viewBox 属性。

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

其他元数据可通过设置title 、description 和resolution 属性来指定。

与其他QPaintDevice 子类一样，QPainter 对象用于绘制到该类的实例上：

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

绘制方式与其他绘制设备相同。不过，有必要使用QPainter::begin() 和end() 来明确开始和结束设备上的绘制。

另请参阅 QSvgRenderer,QSvgWidget, 和 Qt SVG C++ Classes.

成员类型文档

[since 6.5] enum class QSvgGenerator::SvgVersion

该枚举描述生成器输出 SVG 的版本。

常量值说明
QSvgGenerator::SvgVersion::SvgTiny120生成的文档遵循 SVG Tiny 1.2 规范。
QSvgGenerator::SvgVersion::Svg111生成的文档遵循 SVG 1.1 规范。

该枚举在 Qt 6.5 中引入。

属性文档

description : QString

此属性用于保存生成的 SVG 图形的说明

访问功能：

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

另请参阅 title 。

fileName : QString

此属性用于保存生成的 SVG 图形的目标文件名

访问功能：

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

另请参阅 outputDevice 。

outputDevice : QIODevice*

该属性用于保存生成 SVG 图形的输出设备。

如果同时指定了输出设备和文件名，则输出设备优先。

访问功能：

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

另请参阅 fileName 。

resolution : int

此属性用于保存生成输出的分辨率

分辨率以每英寸点数为单位，用于计算 SVG 图形的物理尺寸。

访问功能：

int resolution() const
void setResolution(int dpi)

另请参阅 size 和viewBox 。

size : QSize

该属性表示生成的 SVG 图形的尺寸。

默认情况下，该属性设置为QSize(-1, -1) ，表示生成器不应输出<svg> 元素的宽度和高度属性。

注意： 当QPainter 在生成器上激活时，无法更改此属性。

访问功能：

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

另请参阅 viewBox 和resolution 。

title : QString

此属性用于保存生成的 SVG 图形的标题

访问功能：

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

另请参阅 description 。

viewBox : QRectF

该属性用于保存生成的 SVG 图形的视框。

默认情况下，该属性设置为QRect(0, 0, -1, -1) ，表示生成器不应输出<svg> 元素的 viewBox 属性。

注意： 当QPainter 在生成器上激活时，无法更改此属性。

访问功能：

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

另请参阅 viewBox(),size, 和resolution 。

成员函数文档

QSvgGenerator::QSvgGenerator()

使用 SVG Tiny 1.2 配置文件构建新的生成器。

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

构造一个使用 SVG 版本version 的新生成器。

该函数在 Qt 6.5 中引入。

[virtual noexcept] QSvgGenerator::~QSvgGenerator()

摧毁发电机。

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

重实现：QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const.

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

重实现：QPaintDevice::paintEngine() 常量。

返回用于渲染将转换为 SVG 格式信息的图形的绘制引擎。

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

返回此生成器正在生成的 SVG 文档的版本。

此函数在 Qt 6.5 中引入。

QRect QSvgGenerator::viewBox() const

返回viewBoxF().toRect().

另请参阅 setViewBox() 和viewBoxF()。

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