누락된 속성

이 경고 범주의 철자는 [missing-property] 입니다.

존재하지 않는 기본 속성에 할당할 수 없습니다.

무슨 일이 있었나요?

존재하지 않는 기본 속성에 개체를 할당했습니다.

이것이 왜 나쁜가요?

QML 엔진이 런타임에 이 개체를 할당할 수 없습니다.

예제

import QtQuick

Item {
    component MyType: QtObject { property Item myItem; }

    MyType {
        Item {}
    }
}

이 경고를 해결하려면 바인딩하려는 속성을 지정하거나 해당 유형의 작성자인 경우 속성을 기본값으로 표시하세요:

import QtQuick

Item {
    component MyType: QtObject { property Item myItem; }

    MyType {
        myItem: Item {}
    }

    component AlternativeMyType: QtObject { default property Item myItem; }

    AlternativeMyType {
        Item {} // bound to myItem via default property
    }
}

속성이 존재하지 않습니다.

무슨 일이 있었나요?

존재하지 않는 프로퍼티에 표현식을 할당했습니다.

이것이 왜 나쁜가요?

QML 엔진이 런타임에 이 표현식을 할당할 수 없기 때문입니다.

예제

import QtQuick

Item {
    property int myInt
    myItn: 42
}

이 경고를 해결하려면 바인딩을 제거하거나 가능한 오타를 수정하세요:

import QtQuick

Item {
    property int myInt
    myInt: 42
}

유형에서 멤버를 찾을 수 없음

무슨 일이 있었나요?

QML 도구에서 찾을 수 없는 필드 멤버 표현식의 멤버에 액세스했습니다. 필드 멤버 표현식은 someId.someProperty 형식의 표현식입니다.

예를 들어 오타가 있는 경우 멤버가 전혀 존재하지 않을 수 있습니다. 또는 런타임에는 존재하지만(항상 존재하는 특정 하위 유형에는 존재하기 때문에) 정적으로 선언된 유형에는 존재하지 않을 수도 있습니다.

이것이 왜 나쁜가요?

QML 도구에서 이 멤버를 찾을 수 없으므로 정의로 이동 및 자동 완성 같은 기능이 작동하지 않습니다. 런타임에 오류가 발생하거나 멤버가 실제로 존재하지 않는 경우 잘못된 결과를 얻을 수 있습니다. 멤버가 런타임에 실제로 항상 존재하는 경우에는 오류가 발생하지 않지만 이 경우에도 최적화 누락으로 인해 성능 비용이 발생할 수 있습니다.

예시

속성이 실제로 존재하지 않음

import QtQuick

Item {
    id: self
    property int myInt
    property int myInt2: 1 + self.myItn
}

이 경고를 수정하려면 바인딩을 제거하거나 가능한 오타를 수정하세요:

import QtQuick

Item {
    id: self
    property int myInt
    property int myInt2: 1 + self.myInt
}

속성이 존재하지만 유형이 충분히 정확하지 않습니다.

import QtQuick
import QtQuick.Controls.Basic

Item {
  component Message : Item {
    required property string sender
    required property string text
  }
  ListView {
    id: messageView
    delegate: Message {}
  }

  Button {
    text: "Reply to %1".arg(messageView.currentItem.sender) // not ok
  }
}

이 경고를 해결하려면 읽은 객체를 보다 구체적인 유형으로 형변환하세요:

import QtQuick
import QtQuick.Controls.Basic

Item {
  component Message : Item {
    required property string sender
    required property string text
  }
  ListView {
    id: messageView
    delegate: Message {}
  }

  Button {
    text: "Reply to %1".arg((messageView.currentItem as Message).sender) // now ok
  }
}

예제에서 messageView 의 currentItem 속성의 선언된 유형은 Item 이며 sender 속성은 없습니다. sender 는 Message 에만 정의되어 있습니다. 그러나 currentItem 에는 항상 Message 이 포함되어 있으므로 유형 어설션을 사용하여 currentItem 을 Message 로 캐스팅할 수 있습니다.

누락된 열거형 항목 누락된 유형

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