QSvgWidget 类

QSvgWidget 类提供了一个用于显示可伸缩矢量图形 (SVG) 文件内容的控件。更多...

头文件 #include <QSvgWidget>
CMakefind_package(Qt6 REQUIRED COMPONENTS SvgWidgets)
target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets)
qmakeQT += svgwidgets
继承自 QWidget

公共函数

QSvgWidget(QWidget *parent = nullptr)
QSvgWidget(const QString &file, QWidget *parent = nullptr)
虚函数~QSvgWidget()
(自 6.7) QtSvg::Optionsoptions() const
QSvgRenderer *renderer() const
(自 6.7) voidsetOptions(QtSvg::Options options)

重写的公共函数

虚拟函数sizeHint() const override

公共槽函数

voidload(const QString &file)
voidload(const QByteArray &contents)

重写的受保护函数

虚拟函数paintEvent(QPaintEvent *event) override

详细描述

此类使开发者能够在标准控件旁边显示 SVG 绘图,其使用方法与 QLabel 类似,用于显示文本和位图图像。

由于 QSvgWidget 是 QWidget 的子类,SVG 绘图将使用显示属性进行渲染。可以通过 QSvgRenderer 类执行更多渲染过程的控制,因为可以使用它将绘制到其他绘图设备上,例如 QImage 和 QGLWidget。使用 renderer() 函数可以检索到控件使用的渲染器。

每个 QSvgWidget 可以用 SVG 文件的文件名来构造,或者它们可以被构造而没有特定要渲染的文件,稍后可以提供。load() 函数提供两种不同的方法来加载 SVG 文件:它们可以接受 SVG 文件的文件名或包含 SVG 文件序列化 XML 表示的 QByteArray。

默认情况下,小部件提供一个大小提示以反映它所显示的绘图大小。如果没有加载数据,该小部件则提供默认的 QWidget 大小提示。如果您需要自定义此行为,可以继承此类并重新实现 sizeHint()。

另请参阅 QSvgRendererQt SVG C++ 类QPicture

成员函数文档

QSvgWidget::QSvgWidget(QWidget *parent = nullptr)

使用指定的 parent 创建一个新的 SVG 显示小部件。

QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)

使用指定的 parent 创建一个新的 SVG 显示小部件,并加载指定 file 的内容。

[虚拟 noexcept] QSvgWidget::~QSvgWidget()

销毁小部件。

[槽] void QSvgWidget::load(const QString &file)

加载指定 SVG file 的内容,并更新小部件。

[槽] void QSvgWidget::load(const QByteArray &contents)

加载指定的 SVG 格式 contents 并更新小部件。

[自 6.7] QtSvg::Options QSvgWidget::options() const

返回小部件渲染器的选项。

此函数在 Qt 6.7 中引入。

另请参阅 setOptions

[重写虚保护] void QSvgWidget::paintEvent(QPaintEvent *event)

重写: QWidget::paintEvent(QPaintEvent *event)

QSvgRenderer *QSvgWidget::renderer() const

返回用于显示小部件内容的渲染器。

[自 6.7] void QSvgWidget::setOptions(QtSvg::Options options)

设置小部件渲染器的选项为 options

此属性包含了一组 QtSvg::Option 标志,可用于启用或禁用解析和渲染 SVG 文件的各种功能。必须在调用加载函数之前设置,才能生效。

默认情况下,不设置任何标志。

此函数在 Qt 6.7 中引入。

另请参阅 options

[重写虚拟] QSize QSvgWidget::sizeHint() const

重新实现对属性: QWidget::sizeHint 的访问函数。

© 2024 Qt 公司。本文档中包含的贡献的文档版权属于各自的拥有者。本提供的文档根据由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 条款授权。Qt及其相关标志是芬兰的 Qt 公司以及全球其他国家和地区的商标。所有其他商标均为各自所有者的财产。