shadow.qdoc

Go to the documentation of this file.

// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
 
/*!
\page qmllint-warnings-and-errors-shadow.html
\ingroup qmllint-warnings-and-errors
 
\title Shadow
\brief [shadow] A member shadows another member.
 
\qmllintwarningcategory shadow
 
\section1 Signal or method already exists in base type
 
\section2 What happened?
A member in the current component has the same name as a signal or method from a base class.
 
Note that properties shadowing other properties are handled by the \l{Property override} category.
 
\section2 Why is that bad?
The shadowed signal or method can't be used anymore. It makes the code more difficult to read
and may cause confusion.
 
\section2 Example
\qml
import QtQuick
 
Item {
    component Base: Item { signal f(); }
    Base {
        property int f: 42
    }
}
\endqml
 
To fix this warning, rename the signal \c{f} or the shadowing \c{int} property.
 
\qml
import QtQuick
 
Item {
    component Base: Item { signal f(); }
    Base {
        property int notF: 42
    }
}
\endqml
*/