Component QML Type

0.0(아무것도 로드되지 않음)에서 1.0(완료)까지의 컴포넌트 로딩 진행률입니다.

이 프로퍼티에는 컴포넌트 로딩 상태가 저장됩니다. 상태는 다음 중 하나일 수 있습니다:

컴포넌트 URL. 컴포넌트를 구성하는 데 사용된 URL입니다.

객체가 인스턴스화된 후에 발생합니다. 전체 QML 환경이 설정된 후 시작 시 스크립트 코드를 실행하는 데 사용할 수 있습니다.

onCompleted 시그널 핸들러는 모든 객체에 선언할 수 있습니다. 핸들러 실행 순서는 정의되지 않습니다.

Rectangle {
    Component.onCompleted: console.log("Completed Running!")
    Rectangle {
        Component.onCompleted: console.log("Nested Completed Running!")
    }
}

개체가 소멸을 시작할 때 발생합니다. 이는 completed() 신호 또는 애플리케이션의 다른 명령형 코드에 대한 응답으로 수행된 작업을 취소하는 데 사용할 수 있습니다.

onDestruction 신호 핸들러는 모든 객체에 선언할 수 있습니다. 핸들러를 실행하는 순서는 정의되지 않습니다.

Rectangle {
    Component.onDestruction: console.log("Destruction Beginning!")
    Rectangle {
        Component.onDestruction: console.log("Nested Destruction Beginning!")
    }
}

또한 Qt Qml.

주어진 parent 및 properties 을 갖는 이 컴포넌트의 객체 인스턴스를 생성하고 반환합니다. properties 인수는 선택 사항입니다. 객체 생성에 실패하면 null을 반환합니다.

객체는 컴포넌트가 생성된 컨텍스트와 동일한 컨텍스트에서 생성됩니다. 이 함수는 QML로 생성되지 않은 컴포넌트에서 호출하면 항상 null을 반환합니다.

부모를 설정하지 않고 객체를 생성하려면 parent 값에 null 을 지정하세요. 반환된 객체를 표시하려면 유효한 parent 값을 제공하거나 반환된 객체의 parent 속성을 설정해야 하며, 그렇지 않으면 객체가 표시되지 않습니다.

createObject()에 parent 을 제공하지 않으면 가비지 수집기에 의해 삭제되지 않도록 반환된 객체에 대한 참조를 보유해야 합니다. 이는 나중에 Item::parent 을 설정했는지 여부와 관계없이 해당되며, 아이템 부모를 설정해도 객체 소유권은 변경되지 않습니다. 그래픽 부모만 변경됩니다.

QtQuick 1.1 에서 이 메서드는 생성된 객체의 초기 속성 값 맵을 지정하는 선택적 properties 인수를 허용합니다. 이 값은 객체 생성이 완료되기 전에 적용됩니다. 이는 객체를 생성한 후에 속성 값을 설정하는 것보다 효율적이며, 특히 대량의 속성 값 집합이 정의된 경우 객체가 생성되기 전에 속성 바인딩을 설정( Qt.binding)할 수 있습니다.

properties 인수는 속성 값 항목의 맵으로 지정됩니다. 예를 들어 아래 코드는 초기값이 각각 100과 100인 x 및 y 개체를 만듭니다:

const component = Qt.createComponent("Button.qml");
if (component.status === Component.Ready) {
    component.createObject(parent, { x: 100, y: 100 });
}

동적으로 생성된 인스턴스는 destroy() 메서드를 사용하여 삭제할 수 있습니다. 자세한 내용은 자바스크립트에서 동적 QML 객체 생성을 참조하세요.

incubateObject()도 참조하세요 .

사람이 읽을 수 있는 오류 설명을 반환합니다.

이 문자열에는 각 오류의 파일, 위치 및 설명이 포함됩니다. 오류가 여러 개 있는 경우 개행 문자로 구분됩니다.

오류가 없으면 빈 문자열이 반환됩니다.

이 컴포넌트의 인스턴스에 대한 인큐베이터를 생성합니다. 인큐베이터를 사용하면 새 컴포넌트 인스턴스를 비동기적으로 인스턴스화할 수 있으며 UI가 멈추지 않습니다.

parent 인수는 생성된 인스턴스가 가질 부모를 지정합니다. 매개변수를 생략하거나 null을 전달하면 부모가 없는 객체가 생성됩니다. 이 경우 생성된 객체가 가비지 수집기에 의해 소멸되지 않도록 객체에 대한 참조를 보유해야 합니다.

properties 인자는 생성된 객체가 생성되는 동안 설정될 속성 값 항목의 맵으로 지정됩니다. mode 은 Qt.Synchronous 또는 Qt.Asynchronous일 수 있으며 인스턴스가 동기 또는 비동기적으로 생성되는지 여부를 제어합니다. 기본값은 비동기입니다. 경우에 따라 Qt.Synchronous가 지정되어 있더라도 인큐베이터가 객체를 비동기적으로 생성할 수 있습니다. 이는 incubateObject()를 호출하는 컴포넌트 자체가 비동기적으로 생성되는 경우 발생합니다.

세 개의 인수는 모두 선택 사항입니다.

성공하면 메서드는 인큐베이터를 반환하고, 그렇지 않으면 null을 반환합니다. 인큐베이터에는 다음과 같은 속성이 있습니다:

• status - 인큐베이터의 상태. 유효한 값은 Component.Ready, Component.Loading 및 Component.Error입니다.
• object - 생성된 객체 인스턴스. 인큐베이터가 준비 상태일 때만 사용할 수 있습니다.
• onStatusChanged - 상태가 변경될 때 호출할 콜백 함수를 지정합니다. 상태는 콜백에 매개변수로 전달됩니다.
• forceCompletion() - 인큐베이션을 동기적으로 완료하려면 호출합니다.

다음 예는 인큐베이터를 사용하는 방법을 보여줍니다:

const component = Qt.createComponent("Button.qml");

const incubator = component.incubateObject(parent, { x: 10, y: 10 });
if (incubator.status !== Component.Ready) {
    incubator.onStatusChanged = function(status) {
        if (status === Component.Ready) {
            print("Object", incubator.object, "is now ready!");
        }
    };
} else {
    print("Object", incubator.object, "is ready immediately!");
}

동적으로 생성된 인스턴스는 destroy() 메서드를 사용하여 삭제할 수 있습니다. 자세한 내용은 자바스크립트에서 동적 QML 객체 생성을 참조하세요.

createObject()도 참조하세요 .