QQmlSA::ElementPass Class
class QQmlSA::ElementPassClase base para todas las pasadas de análisis estático de elementos. Más información...
| Encabezado: | #include <qqmlsa.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS QmlCompiler) target_link_libraries(mytarget PRIVATE Qt6::QmlCompiler) |
| Heredado de: | QQmlSA::GenericPass |
| Estado: | Versión preliminar |
Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Funciones públicas
| ElementPass(QQmlSA::PassManager *manager) | |
| virtual void | run(const QQmlSA::Element &element) = 0 |
| virtual bool | shouldRun(const QQmlSA::Element &element) |
Descripción detallada
ElementPass es la más sencilla de las dos pasadas de análisis. Tendrá en cuenta todos los elementos de un archivo. El método shouldRun() se puede utilizar para filtrar los elementos irrelevantes, y el método run() se encarga del trabajo inicial.
Las tareas habituales adecuadas para un ElementPass son
- comprobar que las propiedades de un elemento no se combinen de forma ilógica
- validar los valores de las propiedades (por ejemplo, que una propiedad solo admita determinados valores de enumeración)
- comprobar el comportamiento en función del elemento padre de un Element (por ejemplo, no utilizar Item::width cuando el elemento padre sea un
Layout).
Como se muestra en el fragmento de código siguiente, se recomienda realizar la resolución de tipos necesaria en el constructor del ElementPass y almacenarla en caché en miembros locales, así como implementar algún filtrado mediante ` shouldRun()` para mantener el rendimiento del análisis estático.
using namespace QQmlSA;
class MyElementPass : public ElementPass
{
Element myType;
public:
MyElementPass(QQmlSA::PassManager *manager)
: myType(resolveType("MyModule", "MyType")) {}
bool shouldRun(const Element &element) override
{
return element.inherits(myType);
}
void run(const Element &element) override
{
// actual pass logic
}
}Los ElementPass tienen una visión limitada de cómo se utilizan las propiedades de un elemento. Si necesitas esa información, plantéate utilizar un PropertyPass en su lugar.
Nota: ElementPass solo tendrá en cuenta los tipos instanciables. Por lo tanto, no es adecuado para analizar tipos adjuntos ni singletons. Estos deben gestionarse mediante un ` PropertyPass`.
Documentación de las funciones de miembro
ElementPass::ElementPass(QQmlSA::PassManager *manager)
Crea un objeto `ElementPass` y utiliza ` manager ` para hacer referencia al gestor de pases.
[pure virtual] void ElementPass::run(const QQmlSA::Element &element)
Se ejecuta si « shouldRun() » devuelve « true ». Realiza el cálculo real de la pasada en « element ». Este método está pensado para ser sobrescrito. No es necesario llamar al método base.
[virtual] bool ElementPass::shouldRun(const QQmlSA::Element &element)
Determina si se debe ejecutar la función ` run() ` sobre el objeto ` element` indicado. Las subclases pueden sobrescribir este método para mejorar el rendimiento del análisis filtrando los elementos que no sean relevantes.
La implementación por defecto devuelve incondicionalmente ` true`.
© 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.