ElementPass Class

Detaillierte Beschreibung

ElementPass ist der einfachere der beiden Analysedurchläufe. Es wird jedes Element in einer Datei betrachtet. Die Methode shouldRun() kann verwendet werden, um irrelevante Elemente herauszufiltern, und die Methode run() führt die erste Arbeit aus.

Allgemeine Aufgaben, die sich für einen ElementPass eignen, sind

• Überprüfung, dass die Eigenschaften eines Elements nicht auf unsinnige Weise kombiniert werden
• Validierung von Eigenschaftswerten (z. B. dass eine Eigenschaft nur bestimmte Enum-Werte annimmt)
• Überprüfung des Verhaltens in Abhängigkeit vom übergeordneten Element (z. B. keine Verwendung von Item::width, wenn das übergeordnete Element ein Layout ist).

Wie im folgenden Ausschnitt gezeigt, ist es empfehlenswert, die notwendige Typauflösung im Konstruktor des ElementPasses durchzuführen und sie in lokalen Membern zwischenzuspeichern, sowie eine Filterung über shouldRun() zu implementieren, um die statische Analyse performant zu halten.

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

ElementPasses haben einen begrenzten Einblick in die Verwendung der Eigenschaften eines Elements. Wenn Sie diese Informationen benötigen, sollten Sie stattdessen eine PropertyPass verwenden.