VectorImage QML Type
Charge un fichier image vectoriel et l'affiche dans une scène d'Qt Quick. En savoir plus...
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
Propriétés
- 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)
Description détaillée
L'objet VectorImage permet de charger un fichier d'image vectorielle et de l'afficher en tant qu'élément dans une scène Qt Quick.
Il prend actuellement en charge le format de fichier SVG. De plus, la prise en charge de Lottie peut être activée en définissant la propriété assumeTrustedSource sur true et en incluant le plugin à partir du Qt Lottie Animation module.
Remarque : cette méthode vient compléter l’approche consistant à charger le fichier d’image vectorielle via un élément Image: Image crée une version rasterisée de l’image à la taille demandée. VectorImage construit une scène Qt Quick qui représente l’image. Cela signifie que l’élément résultant peut être redimensionné et pivoté sans perte de qualité, et qu’il consommera généralement moins de mémoire que la version rasterisée.
Documentation des propriétés
animations group
Ces propriétés permettent de contrôler les animations présentes dans l'image, le cas échéant.
La propriété « paused » peut être définie sur « true » pour mettre temporairement toutes les animations en pause. Lorsque la propriété est réinitialisée sur « false », les animations reprennent là où elles s'étaient arrêtées. Par défaut, cette propriété est définie sur « false ».
La propriété loops définit le nombre de fois où les animations du document seront répétées. Par défaut, cette propriété est définie sur 1. Les animations configurées pour se répéter indéfiniment dans l'image source ne sont pas affectées par cette propriété. Pour que toutes les animations du document se répètent indéfiniment, la propriété loops peut être définie sur Animation.Infinite.
Ces propriétés ont été introduites dans Qt 6.10.
assumeTrustedSource : bool [since 6.10]
Définir cette option sur « true » lors du chargement de fichiers provenant de sources fiables étend la prise en charge de certaines fonctionnalités pouvant présenter un risque dans un environnement non contrôlé. Pour le format SVG en particulier, cela correspond à l'option « AssumeTrustedSource option ».
Lorsque ce paramètre est défini sur « true », VectorImage tentera également de charger l'image à l'aide du plugin au format Lottie, si celui-ci est disponible. Consultez Qt Lottie Animation pour plus d’informations.
Par défaut, cette propriété est définie sur « false ».
Cette propriété a été introduite dans Qt 6.10.
Voir également svgtoqml et lottietoqml.
asynchronous : bool [since 6.12]
Cette propriété détermine si l'image sera chargée de manière asynchrone. Lorsqu'elle est définie sur « true », l'interface utilisateur reste réactive pendant le chargement de l'image. La propriété « status » permet de vérifier la progression actuelle.
Par défaut, cette propriété est définie sur « false ».
Cette propriété a été introduite dans Qt 6.12.
Voir également « asynchronousShapes » et « status ».
asynchronousShapes : bool [since 6.11]
Cette propriété contrôle la propriété {QtQuick.Shapes::Shape::asynchronous}{asynchronous} des éléments « Shape » de la scène « Quick » que VectorImage génère pour représenter l'image.
Définir cette propriété sur true permet de décharger la partie du traitement de rendu des formes effectuée par le processeur (CPU) vers des threads de travail distincts. Cela peut améliorer l’utilisation du processeur et la réactivité de l’interface utilisateur.
Par défaut, cette propriété est définie sur « false ».
Cette propriété a été introduite dans Qt 6.11.
Voir également « asynchronous ».
fillMode : enumeration
Cette propriété définit ce qui se passe lorsque la largeur et la hauteur de l’ VectorImage t diffèrent de la taille implicite de son contenu.
| Constante | Description |
|---|---|
VectorImage.NoResize | Le contenu est toujours affiché à la taille fournie par l'entrée. |
VectorImage.Stretch | Le contenu est mis à l'échelle pour s'adapter à la largeur et à la hauteur de l'VectorImage. (Il s'agit de la valeur par défaut.) |
VectorImage.PreserveAspectFit | Le contenu est redimensionné pour s’adapter aux limites de l’ VectorImage, tout en conservant son rapport d’aspect. Le rectangle de délimitation réel du contenu sera parfois plus petit que l’élément VectorImage. |
VectorImage.PreserveAspectCrop | Le contenu est redimensionné pour remplir l’élément « VectorImage », tout en conservant le rapport d’aspect. Les limites réelles du contenu peuvent parfois être plus grandes que celles de l’élément « VectorImage ». |
generatedItem : Item [read-only, since 6.12]
Lorsqu'un fichier d'image vectorielle est chargé, cette propriété contient l'élément de niveau supérieur de la scène générée par ` Qt Quick `. Lorsqu'aucun fichier n'est chargé, cette propriété prend la valeur « null ».
Cette propriété a été introduite dans Qt 6.12.
preferredRendererType : enumeration
Demande l'utilisation d'un backend spécifique pour le rendu des formes dans l'VectorImage.
| Constante | Description |
|---|---|
VectorImage.GeometryRenderer | Équivalent à Shape.GeometryRenderer. Ce backend aplatit les courbes et triangule le résultat. Il produira des résultats présentant un aliasing à moins que le multi-échantillonnage ne soit activé, et l'aplatissement des courbes peut être visible lorsque l'élément est mis à l'échelle. |
VectorImage.CurveRenderer | Équivalent à Shape.CurveRenderer. Avec ce backend, les courbes sont rendues sur le GPU et l’anti-aliasing est intégré. Cela donne généralement de meilleurs résultats visuels, mais au prix d’une légère perte de performances. |
La valeur par défaut est « VectorImage.GeometryRenderer ».
retainWhileLoading : bool [since 6.12]
Cette propriété définit le comportement lorsque la propriété « source » est modifiée et que le chargement s'effectue de manière asynchrone. C'est le cas lorsque la propriété « asynchronous » est définie sur « true ».
Si retainWhileLoading est défini sur false (valeur par défaut), l'ancienne image est immédiatement supprimée et le composant est vidé pendant le chargement de la nouvelle image. S'il est défini sur true, l'ancienne image est conservée et reste visible jusqu'à ce que la nouvelle soit prête.
L’activation de cette propriété permet d’éviter le scintillement lorsque le chargement de la nouvelle image prend beaucoup de temps. Cela s’accompagne toutefois d’une consommation supplémentaire de mémoire pendant le chargement de la nouvelle image.
Cette propriété a été introduite dans Qt 6.12.
Voir également asynchronous.
source : url
Cette propriété contient l'URL du fichier d'image vectorielle à charger.
VectorImage Elle prend actuellement en charge le format de fichier SVG. De plus, la prise en charge de Lottie peut être activée en définissant la propriété assumeTrustedSource sur true et en incluant le plugin à partir du Qt Lottie Animation module.
status : enumeration [since 6.12]
Cette propriété indique l'état de chargement d'une image vectorielle. Elle peut prendre l'une des valeurs suivantes :
| Constante | Description |
|---|---|
VectorImage.Null | Aucune image vectorielle n'a été définie |
VectorImage.Ready | L'image vectorielle a été chargée |
VectorImage.Loading | L'image vectorielle est en cours de chargement |
VectorImage.Error | Une erreur s'est produite lors du chargement de l'image vectorielle |
Cette propriété a été introduite dans Qt 6.12.
© 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.
