VectorImage QML Type
Lädt eine Vektorgrafikdatei und zeigt sie in einer „ Qt Quick “-Szene an. Mehr...
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
Eigenschaften
- animations
(since 6.10)- animations.loops : int
(since 6.10) - animations.paused : bool
(since 6.10)
- animations.loops : int
- assumeTrustedSource : bool
(since 6.10) - asynchronous : bool
(since 6.12) - asynchronousShapes : bool
(since 6.11) - fillMode : enumeration
- generatedItem : Item
(since 6.12) - preferredRendererType : enumeration
- retainWhileLoading : bool
(since 6.12) - source : url
- status : enumeration
(since 6.12)
Ausführliche Beschreibung
Mit „VectorImage“ kann eine Vektorgrafikdatei geladen und als Element in einer „ Qt Quick “-Szene angezeigt werden.
Derzeit wird das Dateiformat „ SVG “ unterstützt. Darüber hinaus kann die Lottie-Unterstützung aktiviert werden, indem die Eigenschaft „ assumeTrustedSource “ auf „true“ gesetzt und das Plugin aus dem Qt Lottie Animation Moduls einbindet.
Hinweis: Dies ergänzt den Ansatz, die Vektorgrafikdatei über ein „ Image “-Element zu laden: „ Image “ erstellt eine gerasterte Version des Bildes in der gewünschten Größe. „VectorImage“ erstellt eine „ Qt Quick “-Szene, die das Bild darstellt. Das bedeutet, dass das resultierende Element ohne Qualitätsverlust skaliert und gedreht werden kann und in der Regel weniger Speicherplatz beansprucht als die gerasterte Version.
Dokumentation zu den Eigenschaften
animations group
Mit diesen Eigenschaften lassen sich Animationen im Bild steuern, sofern das Bild welche enthält.
Die Eigenschaft „ paused “ kann auf „true“ gesetzt werden, um alle Animationen vorübergehend anzuhalten. Wenn die Eigenschaft wieder auf „ false “ zurückgesetzt wird, werden die Animationen an der Stelle fortgesetzt, an der sie unterbrochen wurden. Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Die Eigenschaft „ loops “ legt fest, wie oft sich die Animationen im Dokument wiederholen sollen. Standardmäßig ist diese Eigenschaft auf „1“ gesetzt. Animationen, die im Quellbild so eingestellt sind, dass sie sich unendlich oft wiederholen, werden von dieser Eigenschaft nicht beeinflusst. Um alle Animationen im Dokument unendlich oft wiederholen zu lassen, kann die Eigenschaft „ loops “ auf „ Animation.Infinite “ gesetzt werden.
Diese Eigenschaften wurden in Qt 6.10 eingeführt.
assumeTrustedSource : bool [since 6.10]
Wird diese Option beim Laden von Dateien aus vertrauenswürdigen Quellen auf „true“ gesetzt, wird die Unterstützung für einige Funktionen erweitert, die in einer unkontrollierten Umgebung möglicherweise unsicher sind. Insbesondere für SVG entspricht dies der Option „ AssumeTrustedSource option “.
Wenn diese Option auf „true“ gesetzt ist, versucht „ VectorImage “ außerdem, das Bild mithilfe des Lottie-Format-Plugins zu laden, sofern dieses verfügbar ist. Weitere Informationen finden Sie Qt Lottie Animation für weitere Informationen.
Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Siehe auch „svgtoqml “ und „lottietoqml“.
asynchronous : bool [since 6.12]
Diese Eigenschaft legt fest, ob das Bild asynchron geladen wird. Bei der Einstellung „ true “ bleibt die Benutzeroberfläche während des Ladens des Bildes reaktiv. Mit der Eigenschaft „ status “ lässt sich der aktuelle Fortschritt überprüfen.
Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
Siehe auch „ asynchronousShapes “ und „ status “.
asynchronousShapes : bool [since 6.11]
Diese Eigenschaft steuert die Eigenschaft {QtQuick.Shapes::Shape::asynchronous}{asynchronous} der Elemente „ Shape “ in der Quick-Szene, die VectorImage zur Darstellung des Bildes erstellt.
Wenn Sie diese Eigenschaft auf „ true “ setzen, wird der CPU-Teil der Rendering-Verarbeitung der Formen auf separate Worker-Threads ausgelagert. Dies kann die CPU-Auslastung und die Reaktionsgeschwindigkeit der Benutzeroberfläche verbessern.
Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
Siehe auch „ asynchronous “.
fillMode : enumeration
Diese Eigenschaft legt fest, was geschieht, wenn die Breite und Höhe des „ VectorImage “ von der impliziten Größe seines Inhalts abweichen.
| Konstante | Beschreibung |
|---|---|
VectorImage.NoResize | Der Inhalt wird weiterhin in der von der Eingabe angegebenen Größe dargestellt. |
VectorImage.Stretch | Der Inhalt wird so skaliert, dass er der Breite und Höhe des „ VectorImage “ entspricht. (Dies ist die Standardeinstellung.) |
VectorImage.PreserveAspectFit | Der Inhalt wird so skaliert, dass er in die Begrenzungsrahmen des „ VectorImage “ passt, wobei das Seitenverhältnis beibehalten wird. Der tatsächliche Begrenzungsrahmen des Inhalts ist manchmal kleiner als das „ VectorImage “-Element. |
VectorImage.PreserveAspectCrop | Der Inhalt wird so skaliert, dass er das Element „ VectorImage “ ausfüllt, wobei das Seitenverhältnis beibehalten wird. Die tatsächlichen Begrenzungen des Inhalts sind manchmal größer als das Element „ VectorImage “. |
generatedItem : Item [read-only, since 6.12]
Wenn eine Vektorgrafikdatei geladen wird, enthält diese Eigenschaft das oberste Element der generierten „ Qt Quick “-Szene. Wenn keine Datei geladen ist, lautet der Wert dieser Eigenschaft „ null “.
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
preferredRendererType : enumeration
Legt ein bestimmtes Backend fest, das für die Darstellung von Formen in der „ VectorImage “ verwendet werden soll.
| Konstante | Beschreibung |
|---|---|
VectorImage.GeometryRenderer | Entspricht Shape.GeometryRenderer. Dieses Backend glättet Kurven und trianguliert das Ergebnis. Es liefert Ergebnisse mit Treppeneffekten, sofern kein Multi-Sampling aktiviert ist, und die Kurvenglättung kann sichtbar sein, wenn das Element skaliert wird. |
VectorImage.CurveRenderer | Entspricht Shape.CurveRenderer. Bei diesem Backend werden Kurven auf der GPU gerendert, und Anti-Aliasing ist integriert. Dies führt in der Regel zu besseren visuellen Ergebnissen, geht jedoch mit gewissen Leistungseinbußen einher. |
Die Standardeinstellung ist „ VectorImage.GeometryRenderer “.
retainWhileLoading : bool [since 6.12]
Diese Eigenschaft legt das Verhalten fest, wenn die Eigenschaft „ source “ geändert wird und das Laden asynchron erfolgt. Dies ist der Fall, wenn die Eigenschaft „ asynchronous “ auf „ true “ gesetzt ist.
Wenn „ retainWhileLoading “ auf „ false “ gesetzt ist (Standardeinstellung), wird das alte Bild sofort verworfen und die Komponente geleert, während das neue Bild geladen wird. Bei der Einstellung „ true “ bleibt das alte Bild erhalten und sichtbar, bis das neue Bild bereit ist.
Durch Aktivieren dieser Eigenschaft lässt sich Flackern vermeiden, wenn das Laden des neuen Bildes lange dauert. Dies geht jedoch mit einem etwas höheren Speicherverbrauch einher, während das neue Bild geladen wird.
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
Siehe auch „ asynchronous “.
source : url
Diese Eigenschaft enthält die URL der zu ladenden Vektorgrafikdatei.
VectorImage Derzeit wird das Dateiformat „ SVG “ unterstützt. Darüber hinaus kann die Lottie-Unterstützung aktiviert werden, indem die Eigenschaft „ assumeTrustedSource “ auf „true“ gesetzt und das Plugin aus dem Qt Lottie Animation Moduls eingebunden wird.
status : enumeration [since 6.12]
Diese Eigenschaft gibt den Status des Ladens eines Vektorbildes an. Mögliche Werte sind:
| Konstante | Beschreibung |
|---|---|
VectorImage.Null | Es wurde kein Vektorgrafikbild festgelegt |
VectorImage.Ready | Das Vektorgrafikbild wurde geladen |
VectorImage.Loading | Das Vektorgrafikbild wird gerade geladen |
VectorImage.Error | Beim Laden des Vektorgrafiks ist ein Fehler aufgetreten |
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
© 2026 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.
