QSvgRenderer 类

成员函数文档

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

根据给定的parent构造新的渲染器。

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

根据给定的parent构造新的渲染器，并加载指定filename的SVG文件内容。

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

根据给定的parent构造新的渲染器，并从指定的字节序列contents中加载SVG数据。

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

根据给定的parent构造新的渲染器，并使用指定的流读取器contents加载数据。

[虚 不可抛出] 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

如果给定 id 的元素存在于当前解析的 SVG 文件中且是一个可渲染的元素，则返回 true。

注意：此方法仅对可渲染的元素返回 true。这意味着即使是被认为是填充/描边样式属性的一部分的元素，例如径向渐变，即使用 "id" 属性标记，也不会被此方法找到。

bool QSvgRenderer::isValid() const

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

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

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

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

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

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

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

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

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

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

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

使用给定的 painter 在指定 bounds 内渲染当前文档，或动态文档的当前帧。如果 bounds 不为空，输出将按比例缩放以填满它，忽略 SVG 所隐含的任何纵横比。

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

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

[信号] void QSvgRenderer::repaintNeeded()

当需要更新文档的渲染时（通常用于动画目的）会发出此信号。

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

返回给定 id 的元素的变换矩阵。该矩阵是元素的父级变换的结果。元素的自身变换不包含在内。

为了找到元素在逻辑坐标中的边界矩形，可以将矩阵应用于从 boundsOnElement() 返回的矩形。

另请参阅 boundsOnElement().

QRect QSvgRenderer::viewBox() const

返回viewBoxF().toRect().

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