En esta página

VectorImage QML Type

Carga un archivo de imagen vectorial y lo muestra en una escena de « Qt Quick ». Más...

Import Statement: import QtQuick.VectorImage
Since: Qt 6.8
Inherits:

Item

Propiedades

Descripción detallada

VectorImage se puede utilizar para cargar un archivo de imagen vectorial y mostrarlo como un elemento en una escena de Qt Quick.

Actualmente es compatible con el formato de archivo « SVG ». Además, se puede habilitar la compatibilidad con Lottie estableciendo la propiedad « assumeTrustedSource » en «true» e incluyendo el complemento desde el Qt Lottie Animation módulo.

Nota: Esto complementa el método de cargar el archivo de imagen vectorial a través de un elemento « Image »: « Image » crea una versión rasterizada de la imagen con el tamaño solicitado. «VectorImage» genera una escena « Qt Quick » que representa la imagen. Esto significa que el elemento resultante se puede escalar y rotar sin perder calidad y, por lo general, consumirá menos memoria que la versión rasterizada.

Documentación de propiedades

animations group

animations.loops : int [since 6.10]

animations.paused : bool [since 6.10]

Estas propiedades se pueden utilizar para controlar las animaciones de la imagen, si es que contiene alguna.

La propiedad « paused » se puede establecer en «true» para pausar temporalmente todas las animaciones. Cuando la propiedad se restablece a « false », las animaciones se reanudarán donde se habían quedado. Por defecto, esta propiedad está establecida en « false ».

La propiedad ` loops ` define el número de veces que se repetirán las animaciones del documento. Por defecto, esta propiedad es `1`. Las animaciones de la imagen original que estén configuradas para repetirse indefinidamente no se verán afectadas por esta propiedad. Para que todas las animaciones del documento se repitan indefinidamente, la propiedad ` loops ` puede establecerse en ` Animation.Infinite`.

Estas propiedades se introdujeron en Qt 6.10.

assumeTrustedSource : bool [since 6.10]

Al establecer este valor en «true» al cargar archivos de fuentes de confianza, se amplía la compatibilidad con algunas funciones que podrían resultar inseguras en un entorno no controlado. En el caso concreto de SVG, esto se corresponde con la opción « AssumeTrustedSource option ».

Cuando se establece en «true», VectorImage también intentará cargar la imagen utilizando el complemento de formato Lottie, si está disponible. Consulta Qt Lottie Animation para obtener más información.

Por defecto, esta propiedad es « false ».

Esta propiedad se introdujo en Qt 6.10.

Véanse también svgtoqml y lottietoqml.

asynchronous : bool [since 6.12]

Esta propiedad determina si la imagen se cargará de forma asíncrona. Cuando se establece en « true », la interfaz de usuario seguirá siendo interactiva mientras se carga la imagen. La propiedad « status » se puede utilizar para comprobar el progreso actual.

Por defecto, esta propiedad tiene el valor « false ».

Esta propiedad se introdujo en Qt 6.12.

Véase también « asynchronousShapes » y « status ».

asynchronousShapes : bool [since 6.11]

Esta propiedad controla la propiedad {QtQuick.Shapes::Shape::asynchronous}{asynchronous} de los elementos « Shape » de la escena «Quick» que VectorImage genera para representar la imagen.

Al establecer esta propiedad en « true », la parte del procesamiento de renderizado de las formas que recae en la CPU se descargará a subprocesos de trabajo independientes. Esto puede mejorar la utilización de la CPU y la capacidad de respuesta de la interfaz de usuario.

Por defecto, esta propiedad está establecida en « false ».

Esta propiedad se introdujo en Qt 6.11.

Véase también « asynchronous ».

fillMode : enumeration

Esta propiedad define qué ocurre si la anchura y la altura del « VectorImage » difieren del tamaño implícito de su contenido.

ConstanteDescripción
VectorImage.NoResizeEl contenido se sigue representando con el tamaño proporcionado por la entrada.
VectorImage.StretchEl contenido se escala para ajustarse a la anchura y altura del VectorImage. (Este es el valor predeterminado.)
VectorImage.PreserveAspectFitEl contenido se escala para ajustarse a los límites del elemento « VectorImage », conservando la relación de aspecto. En ocasiones, el rectángulo delimitador real del contenido será más pequeño que el elemento « VectorImage ».
VectorImage.PreserveAspectCropEl contenido se escala para ocupar todo el elemento VectorImage, conservando la relación de aspecto. Los límites reales del contenido serán, en ocasiones, mayores que los del elemento VectorImage.

generatedItem : Item [read-only, since 6.12]

Cuando se carga un archivo de imagen vectorial, esta propiedad contiene el elemento de nivel superior de la escena generada en « Qt Quick ». Si no se carga ningún archivo, esta propiedad es « null ».

Esta propiedad se introdujo en Qt 6.12.

preferredRendererType : enumeration

Solicita un backend específico que se utilizará para renderizar formas en el ` VectorImage`.

ConstanteDescripción
VectorImage.GeometryRendererEquivalente a Shape.GeometryRenderer. Este backend aplana las curvas y triangula el resultado. Proporcionará resultados con alias a menos que se habilite el multimuestreo, y el aplanamiento de las curvas puede ser visible cuando se escala el elemento.
VectorImage.CurveRendererEquivalente a Shape.CurveRenderer. Con este backend, las curvas se renderizan en la GPU y el suavizado está integrado. Normalmente ofrece mejores resultados visuales, pero a costa de un ligero descenso del rendimiento.

El valor predeterminado es « VectorImage.GeometryRenderer ».

retainWhileLoading : bool [since 6.12]

Esta propiedad define el comportamiento cuando se modifica la propiedad « source » y la carga se realiza de forma asíncrona. Este es el caso cuando la propiedad « asynchronous » se establece en « true ».

Si retainWhileLoading es false (el valor predeterminado), la imagen antigua se descarta inmediatamente y el componente se vacía mientras se carga la nueva imagen. Si se establece en true, la imagen antigua se conserva y permanece visible hasta que la nueva esté lista.

Habilitar esta propiedad puede evitar el parpadeo en los casos en los que la carga de la nueva imagen tarde mucho tiempo. Esto conlleva un mayor consumo de memoria mientras se carga la nueva imagen.

Esta propiedad se introdujo en Qt 6.12.

Véase también asynchronous.

source : url

Esta propiedad contiene la URL del archivo de imagen vectorial que se va a cargar.

VectorImage Actualmente es compatible con el formato de archivo SVG. Además, se puede habilitar la compatibilidad con Lottie estableciendo la propiedad assumeTrustedSource en «true» e incluyendo el complemento desde el Qt Lottie Animation módulo.

status : enumeration [since 6.12]

Esta propiedad indica el estado de la carga de una imagen vectorial. Puede adoptar uno de los siguientes valores:

ConstanteDescripción
VectorImage.NullNo se ha establecido ninguna imagen vectorial
VectorImage.ReadyLa imagen vectorial se ha cargado
VectorImage.LoadingLa imagen vectorial se está cargando actualmente
VectorImage.ErrorSe ha producido un error al cargar la imagen vectorial

Esta propiedad se introdujo en 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.