VectorImage QML Type
加载矢量图像文件并将其显示在Qt Quick 场景中。更多
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
属性
- fillMode : enumeration
- preferredRendererType : enumeration
- source : url
详细说明
VectorImage 可用于加载矢量图像文件，并将其显示为Qt Quick 场景中的一个项目。它目前支持SVG 文件格式。
注： 这与通过Image 元素加载矢量图像文件的方法相辅相成：Image 按要求的尺寸创建图像的光栅版本。VectorImage 会创建一个代表图像的Qt Quick 场景。这意味着生成的项目可以缩放和旋转而不会降低质量，而且通常比光栅化版本消耗更少的内存。
属性文档
fillMode : enumeration |
该属性定义了如果VectorImage 的宽度和高度与其内容的隐含大小不同时会发生的情况。
| 常量 | 说明 |
|---|---|
VectorImage.NoResize | 内容仍按输入提供的尺寸渲染。 |
VectorImage.Stretch | 内容按比例缩放，以匹配VectorImage 的宽度和高度（这是默认值）。 |
VectorImage.PreserveAspectFit | 缩放内容以适应VectorImage 的边界，同时保持宽高比。内容的实际边界矩形有时会小于VectorImage 项目。 |
VectorImage.PreserveAspectCrop | 内容按比例填充VectorImage 项目，同时保持宽高比。内容的实际边界有时会大于VectorImage 项目。 |
preferredRendererType : enumeration |
请求使用特定的后端来渲染VectorImage 中的形状。
| 常量 | 描述 |
|---|---|
VectorImage.GeometryRenderer | 等同于 Shape.GeometryRenderer。该后端会平整曲线并对结果进行三角化处理。除非启用多重取样功能，否则它将生成有别名的结果，并且在缩放项目时可能会看到曲线扁平化。 |
VectorImage.CurveRenderer | 等同于 Shape.CurveRenderer。使用此后端，曲线将在 GPU 上渲染，并内置抗锯齿功能。通常会带来更好的视觉效果，但会对性能造成一定的影响。 |
默认值为VectorImage.GeometryRenderer 。
source : url |
该属性包含要加载的矢量图像文件的 URL。
VectorImage 目前仅支持 文件格式。SVG
© 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.
