QQmlSA::ElementPass Class

Description détaillée

ElementPass est la plus simple des deux passes d'analyse. Elle prend en compte tous les éléments d'un fichier. La méthode shouldRun() peut être utilisée pour filtrer les éléments non pertinents, et la méthode run() effectue le travail initial.

Les tâches courantes qui se prêtent à une analyse ElementPass sont les suivantes

• vérifier que les propriétés d'un élément ne sont pas combinées de manière absurde
• valider les valeurs des propriétés (par exemple, qu'une propriété ne prend que certaines valeurs d'énumération)
• vérifier le comportement dépendant du parent d'un élément (par exemple, ne pas utiliser Item::width lorsque l'élément parent est un Layout).

Comme le montre l'extrait ci-dessous, il est recommandé d'effectuer la résolution de type nécessaire dans le constructeur de l'ElementPass et de la mettre en cache dans les membres locaux, et d'implémenter un certain filtrage via shouldRun() pour que l'analyse statique reste performante.

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
        }
}

Les ElementPass ont une vision limitée de la manière dont les propriétés d'un élément sont utilisées. Si vous avez besoin de ces informations, envisagez plutôt d'utiliser PropertyPass.