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)

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

阅读器将在当前位置使用。如果contents 是null ，则行为未定义。

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

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

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

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

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

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

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

在绘制器中指定的bounds 上使用给定的painter 渲染当前文档或动画文档的当前帧。如果bounds 不为空，输出将按比例填充，忽略 SVG 暗示的任何纵横比。

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

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

[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()。