QQmlAbstractUrlInterceptor Class
te permite controlar la carga de archivos QML. Más información...
| Encabezado: | #include <QQmlAbstractUrlInterceptor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
Tipos públicos
| enum | DataType { QmldirFile, JavaScriptFile, QmlFile, UrlString } |
Funciones públicas
| QQmlAbstractUrlInterceptor() | |
| virtual | ~QQmlAbstractUrlInterceptor() |
| virtual QUrl | intercept(const QUrl &url, QQmlAbstractUrlInterceptor::DataType type) = 0 |
Descripción detallada
QQmlAbstractUrlInterceptor es una interfaz que se puede utilizar para modificar las URL antes de que sean utilizadas por el motor QML. Esto resulta especialmente útil para cambiar las URL de archivos por otras, como por ejemplo al seleccionar diferentes recursos gráficos para la plataforma actual.
Las URL relativas se interceptan tras resolverse en función de la ruta de archivo del contexto QML actual. La interceptación de URL también se produce tras establecer la ruta base para un archivo QML cargado. Esto significa que el contenido cargado para ese archivo QML utiliza la URL interceptada, pero dentro del archivo se utiliza la URL preinterceptada para resolver las rutas relativas. Esto permite la interceptación de la carga de archivos .qml sin necesidad de que todas las rutas (o tipos locales) dentro del contenido interceptado incluyan una ruta relativa diferente.
En comparación con `setNetworkAccessManagerFactory`, `QQmlAbstractUrlInterceptor` afecta a todas las URL y rutas, incluidos los archivos locales y los archivos de recursos incrustados. QQmlAbstractUrlInterceptor es síncrono y, para los archivos asíncronos, debe devolver una URL con un esquema asíncrono (como http o un esquema personalizado gestionado por tu propio QNetworkAccessManager). Puedes utilizar un QQmlAbstractUrlInterceptor para convertir las URL de los archivos en URL de red gestionadas por tu propio QNetworkAccessManager.
Para implementar la compatibilidad con un esquema de red personalizado, consulta setNetworkAccessManagerFactory.
Documentación sobre los tipos de miembros
enum QQmlAbstractUrlInterceptor::DataType
Especifica dónde se lleva a cabo la interceptación de la URL.
Dado que QML carga archivos qmldir para localizar tipos, hay dos URL implicadas en la carga de un tipo QML. La URL del qmldir (posiblemente implícito) utilizado para localizar el tipo y la URL del archivo que define el tipo. La interceptación de ambas da lugar a una sustitución compleja de la URL o a una doble sustitución de la URL para el mismo archivo.
| Constante | Valor | Descripción |
|---|---|---|
QQmlAbstractUrlInterceptor::QmldirFile | 2 | La URL que se está interceptando corresponde a un archivo qmldir. Al interceptar esta, pero no el QmlFile, se permite sustituir subárboles completos. |
QQmlAbstractUrlInterceptor::JavaScriptFile | 1 | La URL interceptada corresponde a una importación de un archivo JavaScript. |
QQmlAbstractUrlInterceptor::QmlFile | 0 | La URL interceptada corresponde a un archivo Qml. Al interceptarla —pero no el archivo Qmldir—, se mantiene intacto el directorio base del archivo QML y el efecto es similar a sustituir el archivo por otro. |
QQmlAbstractUrlInterceptor::UrlString | 0x1000 | La URL que se está interceptando es una propiedad «url» en un archivo QML y no se está utilizando para cargar un archivo a través del motor. |
Documentación de funciones de miembro
[constexpr noexcept default] QQmlAbstractUrlInterceptor::QQmlAbstractUrlInterceptor()
Constructor de QQmlAbstractUrlInterceptor.
[virtual constexpr noexcept default] QQmlAbstractUrlInterceptor::~QQmlAbstractUrlInterceptor()
Destructor para « QQmlAbstractUrlInterceptor ».
[pure virtual] QUrl QQmlAbstractUrlInterceptor::intercept(const QUrl &url, QQmlAbstractUrlInterceptor::DataType type)
Una función virtual pura que permite interceptar la función ` url`. El valor devuelto se toma como el nuevo valor de la URL. El tipo de URL que se intercepta viene determinado por la variable ` type `.
Tu implementación de esta función debe ser segura para subprocesos, ya que puede ser llamada desde varios subprocesos al mismo tiempo.
© 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.