QSvgWidget Class
QSvgWidget 类提供了一个用于显示可缩放矢量图形（SVG）文件内容的 widget。更多
| Header： | #include <QSvgWidget> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets) |
| qmake： | QT += svgwidgets |
| 继承： | QWidget |
- 所有成员的列表，包括继承成员
- QSvgWidget 属于绘画类。
公共函数
| QSvgWidget(QWidget *parent = nullptr) | |
| QSvgWidget(const QString &file, QWidget *parent = nullptr) | |
| virtual | ~QSvgWidget() |
(since 6.7) QtSvg::Options | options() const |
| QSvgRenderer * | renderer() const |
(since 6.7) void | setOptions(QtSvg::Options options) |
重新实现的公共函数
| virtual QSize | sizeHint() const override |
公共插槽
重新实现的保护函数
| virtual void | paintEvent(QPaintEvent *event) override |
详细说明
该类使开发人员能够在标准 widget 旁显示 SVG 图形，其使用方式与QLabel 显示文本和位图图像的方式大致相同。
由于 QSvgWidget 是QWidget 的子类，因此 SVG 图形是使用显示属性渲染的。使用QSvgRenderer 类可以对渲染过程进行更多控制，因为该类可用于绘制到其他绘制设备上，如QImage 和 QGLWidget。可通过renderer() 函数获取部件使用的渲染器。
每个 QSvgWidget 都可以用 SVG 文件的文件名来构建，也可以在构建时不指定要渲染的文件，稍后再提供。load() 函数提供了两种不同的加载 SVG 文件的方法：它们接受 SVG 文件的文件名或包含 SVG 文件序列化 XML 表示的QByteArray 。
默认情况下，窗口小部件会提供一个尺寸提示，以反映所显示图形的尺寸。如果没有加载数据，该 widget 默认提供QWidget 大小提示。如果需要自定义此行为，请子类该类并重新实现sizeHint() 。
另请参见 QSvgRenderer 、 Qt SVG C++ Classes和QPicture 。
成员函数文档
QSvgWidget::QSvgWidget(QWidget *parent = nullptr)
用给定的parent 构建一个新的 SVG 显示部件。
QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)
使用给定的parent 构建一个新的 SVG 显示部件，并加载指定file 的内容。
[virtual noexcept] QSvgWidget::~QSvgWidget()
销毁小部件。
[slot] void QSvgWidget::load(const QByteArray &contents)
加载指定的 SVG 格式contents 并更新 widget。
[slot] void QSvgWidget::load(const QString &file)
加载指定 SVGfile 的内容并更新 widget。
[since 6.7] QtSvg::Options QSvgWidget::options() const
返回 widget 渲染器的选项。
此函数在 Qt 6.7 中引入。
另请参阅 setOptions 。
[override virtual protected] void QSvgWidget::paintEvent(QPaintEvent *event)
重实现：QWidget::paintEvent(QPaintEvent *event).
QSvgRenderer *QSvgWidget::renderer() const
返回用于显示 widget 内容的呈现器。
[since 6.7] void QSvgWidget::setOptions(QtSvg::Options options)
将 widget 的渲染器选项设置为options 。
该属性包含一组QtSvg::Option 标志，可用于启用或禁用 SVG 文件解析和渲染的各种功能。必须在调用加载函数前设置该标志才有效。
默认情况下，不设置任何标志。
此函数在 Qt 6.7 中引入。
另请参见 options 。
[override virtual] QSize QSvgWidget::sizeHint() const
重构属性访问函数：QWidget::sizeHint 。
© 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.
