QSvgRenderer Class

成员函数文档

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

使用给定的parent 构建一个新的渲染器。

QSvgRenderer::QSvgRenderer(QXmlStreamReader *contents, QObject *parent = nullptr)

使用给定的parent 构建一个新的渲染器，并使用contents 指定的流读取器加载SVG数据。

QSvgRenderer::QSvgRenderer(const QByteArray &contents, QObject *parent = nullptr)

使用给定的parent 创建一个新的渲染器，并从contents 指定的字节数组中加载SVG数据。

QSvgRenderer::QSvgRenderer(const QString &filename, QObject *parent = nullptr)

使用给定的parent 创建一个新的渲染器，并加载指定filename 的SVG文件内容。

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

销毁渲染器。

bool QSvgRenderer::animated() const

如果当前文档中包含动画元素，则返回 true；否则返回 false。

另请参阅 framesPerSecond()。

QRectF QSvgRenderer::boundsOnElement(const QString &id) const

返回该项在给定id 下的边界矩形。父元素的变换矩阵不会影响该元素的边界。

另请参阅 transformForElement()。

QSize QSvgRenderer::defaultSize() const

返回文档内容的默认大小。

bool QSvgRenderer::elementExists(const QString &id) const

如果当前正在解析的 SVG 文件中存在具有给定 `id ` 的元素，且该元素是可渲染的，则返回 true。

注意：此方法仅对可渲染的元素返回 true。这意味着被视为填充/描边样式属性组成部分的元素（例如 radialGradients），即使标有“id”属性，也不会被此方法检出。

bool QSvgRenderer::isValid() const

如果存在有效的当前文档，则返回 true；否则返回 false。

[slot] bool QSvgRenderer::load(QXmlStreamReader *contents)

将指定的 SVG 文件加载到 `contents` 中，如果内容解析成功则返回 `true`；否则返回 `false`。

将从当前位置开始使用该阅读器。如果contents 为null ，则行为未定义。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QXmlStreamReader *contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QByteArray &contents)

加载指定的SVG格式contents ，如果内容解析成功则返回true；否则返回false。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QByteArray &contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QString &filename)

加载由 `filename` 指定的 SVG 文件，如果内容解析成功，则返回 true；否则返回 false。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QString &filename) { receiver->load(filename); });

[slot] void QSvgRenderer::render(QPainter *painter)

使用给定的painter 渲染当前文档，或动画文档的当前帧。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter) { receiver->render(painter); });

[slot] void QSvgRenderer::render(QPainter *painter, const QRectF &bounds)

使用给定的painter 在绘图器中的指定bounds 上渲染当前文档或动画文档的当前帧。如果bounds 不为空，输出将被缩放以填满该区域，并忽略SVG中隐含的任何宽高比。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QRectF &bounds) { receiver->render(painter, bounds); });

[slot] void QSvgRenderer::render(QPainter *painter, const QString &elementId, const QRectF &bounds = QRectF())

使用给定的painter 在指定的bounds 上，通过elementId 渲染给定的元素。如果未指定边界矩形，则将SVG元素映射到整个绘图设备上。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QString &elementId, const QRectF &bounds) { receiver->render(painter, elementId, bounds); });

[signal] void QSvgRenderer::repaintNeeded()

每当需要更新文档的渲染效果时，就会发出此信号，通常是为了实现动画效果。

[static, since 6.8] void QSvgRenderer::setDefaultOptions(QtSvg::Options flags)

将渲染器创建时使用的选项标志设置为flags 。默认情况下，不设置任何标志。

在运行时，可以通过 QT_SVG_DEFAULT_OPTIONS 环境变量覆盖此设置。

该函数自 Qt 6.8 起引入。

QTransform QSvgRenderer::transformForElement(const QString &id) const

返回具有给定id 的元素的变换矩阵。该矩阵是该元素父元素变换的乘积。不包含该元素自身的变换。

若要在逻辑坐标系中求得该元素的边界矩形，可将该变换矩阵应用于由 `boundsOnElement()` 函数返回的矩形。

另请参阅 boundsOnElement()。

QRect QSvgRenderer::viewBox() const

返回viewBoxF().toRect()。

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