QQmlSA::PassManager Class

Member Function Documentation

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

Runs the element passes over root and all its children.

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

Returns bindings by their source location.

std::vector<std::shared_ptr<QQmlSA::ElementPass>> PassManager::elementPasses() const

Returns the list of element passes.

bool PassManager::hasImportedModule(QAnyStringView module) const

Returns true if the module named module has been imported by the QML to be analyzed, false otherwise.

This can be used to skip registering a pass which is specific to a specific module.

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

See also registerPropertyPass() and registerElementPass().

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

Returns true if warnings of category are enabled, false otherwise.

std::multimap<QString, QQmlSA::PropertyPassInfo> PassManager::propertyPasses() const

Returns the list of property passes.

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

Registers a static analysis pass to be run on all elements.

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

Registers a static analysis pass for properties. The pass will be run on every property matching the moduleName, typeName and propertyName.

Omitting the propertyName will register this pass for all properties matching the typeName and moduleName.

Setting allowInheritance to true means that the filtering on the type also accepts types deriving from typeName.

pass is passed as a std::shared_ptr to allow reusing the same pass on multiple elements:

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

Returns true if the pass was successfully added, false otherwise. Adding a pass fails when the Element specified by moduleName and typeName does not exist.

See also PropertyPass.