En esta página

QQmlSA::PassManager Class

class QQmlSA::PassManager

Permite analizar un elemento y sus elementos secundarios mediante pases de análisis estático. Más información...

Encabezado: #include <qqmlsa.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS QmlCompiler)
target_link_libraries(mytarget PRIVATE Qt6::QmlCompiler)
Estado: Versión preliminar tecnológica

Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

Funciones públicas

void analyze(const QQmlSA::Element &root)
std::unordered_map<quint32, QQmlSA::Binding> bindingsByLocation() const
bool hasImportedModule(QAnyStringView module) const
bool isCategoryEnabled(QQmlSA::LoggerWarningId category) const
void registerElementPass(std::unique_ptr<QQmlSA::ElementPass> pass)
bool registerPropertyPass(std::shared_ptr<QQmlSA::PropertyPass> pass, QAnyStringView moduleName, QAnyStringView typeName, QAnyStringView propertyName = QAnyStringView(), bool allowInheritance = true)

Descripción detallada

Documentación de las funciones de miembro

void PassManager::analyze(const QQmlSA::Element &root)

Recorre el elemento y pasa por root y todos sus elementos secundarios.

std::unordered_map<quint32, QQmlSA::Binding> PassManager::bindingsByLocation() const

Devuelve las enlaces según su ubicación de origen.

bool PassManager::hasImportedModule(QAnyStringView module) const

Devuelve « true » si el módulo denominado « module » ha sido importado por el QML que se va a analizar; en caso contrario, devuelve « false ».

Esto se puede utilizar para omitir el registro de una pasada específica de un módulo concreto.

if (passManager->hasImportedModule("QtPositioning"))
    passManager->registerElementPass(
       std::make_unique<PositioningPass>(passManager)
    );

Véase también registerPropertyPass() y registerElementPass().

bool PassManager::isCategoryEnabled(QQmlSA::LoggerWarningId category) const

Devuelve « true » si están activadas las advertencias de « category »; en caso contrario, devuelve « false ».

void PassManager::registerElementPass(std::unique_ptr<QQmlSA::ElementPass> pass)

Registra un análisis estático pass para que se ejecute en todos los elementos.

bool PassManager::registerPropertyPass(std::shared_ptr<QQmlSA::PropertyPass> pass, QAnyStringView moduleName, QAnyStringView typeName, QAnyStringView propertyName = QAnyStringView(), bool allowInheritance = true)

Registra una pasada de análisis estático para las propiedades. El pass se ejecutará en todas las propiedades que coincidan con las definidas en moduleName, typeName y propertyName.

Si se omite el propertyName, esta pasada se registrará para todas las propiedades que coincidan con typeName y moduleName.

Establecer allowInheritance en true significa que el filtrado por tipo también acepta tipos derivados de typeName.

pass Se pasa como std::shared_ptr para permitir la reutilización de la misma pasada en varios elementos:

auto titleValiadorPass = std::make_shared<TitleValidatorPass>(manager);
manager->registerPropertyPass(titleValidatorPass,
                              "QtQuick", "Window", "title");
manager->registerPropertyPass(titleValidatorPass,
                              "QtQuick.Controls", "Dialog", "title");

Nota: Ejecutar pasadas de análisis en demasiados elementos puede resultar costoso. Por eso, suele ser recomendable filtrar el conjunto de propiedades de una pasada utilizando moduleName, typeName y propertyName.

Devuelve true si la pasada se ha añadido correctamente; false en caso contrario. El añadir una pasada falla cuando el Element especificado por moduleName y typeName no existe.

Véase también PropertyPass.

© 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.