QSvgWidget 类
QSvgWidget 类提供了一个用于显示可伸缩矢量图形 (SVG) 文件内容的控件。更多...
头文件 | #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) | |
虚函数 | ~QSvgWidget() |
(自 6.7) QtSvg::Options | options() const |
QSvgRenderer * | renderer() const |
(自 6.7) void | setOptions(QtSvg::Options options) |
重写的公共函数
虚拟函数 | sizeHint() const override |
公共槽函数
重写的受保护函数
虚拟函数 | paintEvent(QPaintEvent *event) override |
详细描述
此类使开发者能够在标准控件旁边显示 SVG 绘图,其使用方法与 QLabel 类似,用于显示文本和位图图像。
由于 QSvgWidget 是 QWidget 的子类,SVG 绘图将使用显示属性进行渲染。可以通过 QSvgRenderer 类执行更多渲染过程的控制,因为可以使用它将绘制到其他绘图设备上,例如 QImage 和 QGLWidget。使用 renderer() 函数可以检索到控件使用的渲染器。
每个 QSvgWidget 可以用 SVG 文件的文件名来构造,或者它们可以被构造而没有特定要渲染的文件,稍后可以提供。load() 函数提供两种不同的方法来加载 SVG 文件:它们可以接受 SVG 文件的文件名或包含 SVG 文件序列化 XML 表示的 QByteArray。
默认情况下,小部件提供一个大小提示以反映它所显示的绘图大小。如果没有加载数据,该小部件则提供默认的 QWidget 大小提示。如果您需要自定义此行为,可以继承此类并重新实现 sizeHint()。
另请参阅 QSvgRenderer、Qt 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 公司以及全球其他国家和地区的商标。所有其他商标均为各自所有者的财产。