PySide6.QtSvg.QSvgGenerator

class QSvgGenerator

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

PySide6.QtSvg.QSvgGenerator 的继承图

概要

属性

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

此绘图设备表示可缩放矢量图形（SVG）绘图。与QPrinter类似，它被设计为一种只写设备，生成特定格式的输出。

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

generator = QSvgGenerator()
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 对象在此类的实例上进行绘制：

painter = QPainter()
painter.begin(generator)            ...

painter.end()

绘画的执行方式与任何其他绘画设备相同。然而，必须使用QPainter::begin()和end()来显式地开始和结束在设备上的绘画。

class SvgVersion

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

常量

描述

QSvgGenerator.SvgVersion.SvgTiny12

生成的文档遵循SVG Tiny 1.2规范。

QSvgGenerator.SvgVersion.Svg11

生成的文档遵循SVG 1.1规范。

在6.5版本中添加。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property descriptionᅟ: str

此属性保存生成的SVG绘图的描述。

另请参阅

title

Access functions:
property fileNameᅟ: str

此属性保存生成的SVG绘图的目标文件名。

另请参阅

outputDevice

Access functions:
property outputDeviceᅟ: QIODevice

此属性保存生成的SVG绘图的输出设备。

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

另请参阅

fileName

Access functions:
property resolutionᅟ: int

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

分辨率以每英寸点数指定，用于计算SVG绘图的物理尺寸。

另请参阅

size viewBox

Access functions:
property sizeᅟ: QSize

此属性保存生成的SVG绘图的大小。

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

注意

当生成器上有活动的 QPainter 时，无法更改此属性。

另请参阅

viewBox resolution

Access functions:
property titleᅟ: str

此属性保存生成的SVG绘图的标题。

另请参阅

描述

Access functions:
property viewBoxᅟ: QRectF

此属性保存生成的SVG绘图的viewBox。

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

注意

当生成器上有活动的 QPainter 时，无法更改此属性。

另请参阅

viewBox() size resolution

Access functions:
__init__()

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

__init__(version)
Parameters:

版本 – SvgVersion

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

description()
Return type:

字符串

另请参阅

setDescription()

属性 descriptionᅟ 的获取器。

fileName()
Return type:

字符串

另请参阅

setFileName()

属性 fileNameᅟ 的获取器。

outputDevice()
Return type:

QIODevice

另请参阅

setOutputDevice()

属性 outputDeviceᅟ 的获取器。

resolution()
Return type:

整数

另请参阅

setResolution()

属性 resolutionᅟ 的获取器。

setDescription(description)
Parameters:

描述 – str

另请参阅

description()

属性 descriptionᅟ 的设置器。

setFileName(fileName)
Parameters:

fileName – str

另请参阅

fileName()

属性 fileNameᅟ 的设置器。

setOutputDevice(outputDevice)
Parameters:

outputDevice – QIODevice

另请参阅

outputDevice()

属性 outputDeviceᅟ 的设置器。

setResolution(dpi)
Parameters:

dpi – int

另请参阅

resolution()

属性 resolutionᅟ 的设置器。

setSize(size)
Parameters:

大小 – QSize

另请参阅

size()

属性 sizeᅟ 的设置器。

setTitle(title)
Parameters:

标题 – str

另请参阅

title()

属性 titleᅟ 的设置器。

setViewBox(viewBox)
Parameters:

viewBox – QRect

另请参阅

viewBox()

setViewBox(viewBox)
Parameters:

viewBox – QRectF

属性 viewBoxᅟ 的设置器。

size()
Return type:

QSize

另请参阅

setSize()

属性 sizeᅟ 的获取器。

svgVersion()
Return type:

SvgVersion

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

title()
Return type:

字符串

另请参阅

setTitle()

属性 titleᅟ 的获取器。

viewBox()
Return type:

QRect

返回 viewBoxF() .toRect()。

另请参阅

setViewBox() viewBoxF()

viewBoxF()
Return type:

QRectF

属性 viewBoxᅟ 的获取器。