QQmlComponent Class

멤버 함수 문서

QQmlComponent::QQmlComponent(QQmlEngine *engine, QObject *parent = nullptr)

데이터가 없는 QQml 컴포넌트를 생성하고 지정된 engine 및 parent 을 제공합니다. setData ()로 데이터를 설정합니다.

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QString &fileName, QObject *parent = nullptr)

주어진 fileName 에서 QQml 컴포넌트를 생성하고 지정된 parent 및 engine 을 지정합니다.

loadUrl()도 참조하세요 .

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QUrl &url, QObject *parent = nullptr)

주어진 url 에서 QQml 컴포넌트를 생성하고 지정된 parent 및 engine 을 지정합니다.

특히 로컬 파일 시스템에서 파일을 로드할 때는 QUrl::fromLocalFile()를 사용하여 제공된 URL이 완전하고 올바른지 확인하세요.

상대 경로는 지정하지 않는 한 현재 작업 디렉터리인 QQmlEngine::baseUrl()를 기준으로 확인됩니다.

loadUrl()도 참조하세요 .

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QString &fileName, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

주어진 fileName 에서 QQmlComponent를 생성하고 지정된 parent 및 engine 을 지정합니다. mode 이 Asynchronous 인 경우 컴포넌트는 비동기적으로 로드 및 컴파일됩니다.

loadUrl()도 참조하세요 .

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QUrl &url, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

주어진 url 에서 QQml 컴포넌트를 생성하고 지정된 parent 과 engine 을 지정합니다. mode 이 Asynchronous 인 경우 컴포넌트는 비동기적으로 로드 및 컴파일됩니다.

특히 로컬 파일 시스템에서 파일을 로드할 때는 QUrl::fromLocalFile()를 사용하는 등 제공된 URL이 완전하고 올바른지 확인하세요.

상대 경로는 지정하지 않는 한 현재 작업 디렉터리인 QQmlEngine::baseUrl()를 기준으로 확인됩니다.

loadUrl()도 참조하세요 .

[explicit, since 6.5] QQmlComponent::QQmlComponent(QQmlEngine *engine, QAnyStringView uri, QAnyStringView typeName, QObject *parent = nullptr)

주어진 uri 및 typeName 에서 QQmlComponent를 생성하고 지정된 parent 및 engine 을 지정합니다. 가능하면 컴포넌트가 동기식으로 로드됩니다.

이것은 오버로드된 함수입니다.

이 함수는 Qt 6.5에 도입되었습니다.

loadFromModule()도 참조하십시오 .

[explicit, since 6.5] QQmlComponent::QQmlComponent(QQmlEngine *engine, QAnyStringView uri, QAnyStringView typeName, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

주어진 uri 및 typeName 에서 QQmlComponent를 생성하고 지정된 parent 및 engine 을 지정합니다. mode 이 Asynchronous 인 경우 컴포넌트는 비동기적으로 로드 및 컴파일됩니다.

이것은 오버로드된 함수입니다.

이 함수는 Qt 6.5에 도입되었습니다.

loadFromModule()도 참조하십시오 .

[override virtual noexcept] QQmlComponent::~QQmlComponent()

QQmlComponent 을 파괴합니다.

[virtual] QObject *QQmlComponent::beginCreate(QQmlContext *context)

지정된 context 내에서 이 컴포넌트에서 객체 인스턴스를 생성합니다. 생성에 실패하면 nullptr 을 반환합니다.

QQmlComponent 이 인스턴스를 생성할 때는 세 단계로 이루어집니다:

1. 객체 계층 구조가 생성되고 상수 값이 할당됩니다.
2. 속성 바인딩이 처음으로 평가됩니다.
3. 해당되는 경우 객체에서 QQmlParserStatus::componentComplete()가 호출됩니다.

QQmlComponent::beginCreate()는 1단계만 수행한다는 점에서 QQmlComponent::create()와 다릅니다. 2단계와 3단계를 완료하려면 QQmlComponent::completeCreate()를 호출해야 합니다.

이 중단점은 속성 바인딩이 적용되기 전에 초기 값을 구성할 수 있기 때문에 연결된 속성을 사용하여 인스턴스화된 컴포넌트에 정보를 전달할 때 유용할 때가 있습니다.

반환된 객체 인스턴스의 소유권은 호출자에게 이전됩니다.

completeCreate() 및 QQmlEngine::ObjectOwnership 을참조하세요 .

[virtual] void QQmlComponent::completeCreate()

이 메서드는 컴포넌트 인스턴스 생성에 대한 고급 제어 기능을 제공합니다. 일반적으로 프로그래머는 컴포넌트를 생성할 때 QQmlComponent::create()를 사용해야 합니다.

이 함수는 QQmlComponent::beginCreate()로 시작된 컴포넌트 생성을 완료하며 이후 반드시 호출해야 합니다.

beginCreate()도 참조하세요 .

[virtual] QObject *QQmlComponent::create(QQmlContext *context = nullptr)

지정된 context 내에서 이 컴포넌트에서 객체 인스턴스를 생성합니다. 생성에 실패하면 nullptr 을 반환합니다.

context 가 nullptr (기본값)인 경우 엔진의 root context 에 인스턴스를 생성합니다.

반환된 객체 인스턴스의 소유권은 호출자에게 이전됩니다.

이 컴포넌트에서 생성되는 객체가 시각적 항목인 경우 QQuickItem::setParentItem()를 호출하여 설정할 수 있는 시각적 부모가 있어야 합니다. 자세한 내용은 Qt Quick 의 개념 - 시각적 부모를 참조하세요.

QQmlEngine::ObjectOwnership 를참조하세요 .

void QQmlComponent::create(QQmlIncubator &incubator, QQmlContext *context = nullptr, QQmlContext *forContext = nullptr)

제공된 incubator 을 사용하여 이 컴포넌트에서 객체 인스턴스를 생성합니다. context 은 객체 인스턴스를 생성할 컨텍스트를 지정합니다.

context 가 nullptr (기본값)인 경우 엔진의 root context 에 인스턴스를 생성합니다.

forContext 는 이 객체 생성이 의존하는 컨텍스트를 지정합니다. forContext 이 비동기적으로 생성되고 QQmlIncubator::IncubationMode 이 QQmlIncubator::AsynchronousIfNested 인 경우 이 객체도 비동기적으로 생성됩니다. forContext 가 nullptr (기본값)인 경우 context 가 이 결정에 사용됩니다.

생성된 객체와 생성 상태는 incubator 에서 확인할 수 있습니다.

QQmlIncubator도 참조하세요 .

QObject *QQmlComponent::createWithInitialProperties(const QVariantMap &initialProperties, QQmlContext *context = nullptr)

지정된 context 내에 이 컴포넌트의 객체 인스턴스를 생성하고 최상위 프로퍼티를 initialProperties 으로 초기화합니다.

initialProperties 중 하나라도 설정할 수 없으면 경고가 표시됩니다. 설정되지 않은 필수 속성이 있는 경우 객체 생성이 실패하고 nullptr 을 반환하며, 이 경우 isError()은 true 을 반환합니다.

QQmlComponent::create도 참조하세요 .

QQmlContext *QQmlComponent::creationContext() const

컴포넌트가 생성된 QQmlContext 을 반환합니다. 이 함수는 QML에서 직접 생성된 컴포넌트에만 유효합니다.

QQmlEngine *QQmlComponent::engine() const

이 컴포넌트의 QQmlEngine 를 반환합니다.

QList<QQmlError> QQmlComponent::errors() const

마지막 컴파일 또는 생성 작업 중에 발생한 오류 목록을 반환합니다. isError ()가 설정되지 않은 경우 빈 목록이 반환됩니다.

[since 6.5] bool QQmlComponent::isBound() const

컴포넌트가 pragma ComponentBehavior: Bound 을 지정하는 QML 파일에서 생성된 경우 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

이 함수는 Qt 6.5에 도입되었습니다.

bool QQmlComponent::isError() const

status() == QQmlComponent::Error 이면 참을 반환합니다.

bool QQmlComponent::isLoading() const

status() == QQmlComponent::Loading 이면 참을 반환합니다.

bool QQmlComponent::isNull() const

status() == QQmlComponent::Null 이면 참을 반환합니다.

bool QQmlComponent::isReady() const

status() == QQmlComponent::Ready 이면 참을 반환합니다.

[slot, since 6.5] void QQmlComponent::loadFromModule(QAnyStringView uri, QAnyStringView typeName, QQmlComponent::CompilationMode mode = PreferSynchronous)

uri 모듈에서 typeName 에 대한 QQmlComponent 을 로드합니다. 유형이 QML 파일을 통해 구현된 경우 mode 을 사용하여 로드합니다. C++로 지원되는 타입은 항상 동기식으로 로드됩니다.

QQmlEngine engine;
QQmlComponent component(&engine);
component.loadFromModule("QtQuick", "Item");
// once the component is ready
std::unique_ptr<QObject> item(component.create());
Q_ASSERT(item->metaObject() == &QQuickItem::staticMetaObject);

이 함수는 Qt 6.5에 도입되었습니다.

loadUrl()도 참조하십시오 .

[slot] void QQmlComponent::loadUrl(const QUrl &url)

제공된 url 에서 QQmlComponent 을 로드합니다.

특히 로컬 파일 시스템에서 파일을 로드할 때는 QUrl::fromLocalFile()를 사용하는 등 제공된 URL이 완전하고 올바른지 확인하세요.

상대 경로는 지정하지 않는 한 현재 작업 디렉터리인 QQmlEngine::baseUrl()를 기준으로 확인됩니다.

[slot] void QQmlComponent::loadUrl(const QUrl &url, QQmlComponent::CompilationMode mode)

제공된 url 에서 QQmlComponent 을 로드합니다. mode 이 Asynchronous 인 경우 컴포넌트가 비동기적으로 로드되고 컴파일됩니다.

특히 로컬 파일 시스템에서 파일을 로드할 때는 QUrl::fromLocalFile()를 사용하는 등 제공된 URL이 완전하고 올바른지 확인하세요.

상대 경로는 지정되지 않는 한 현재 작업 디렉터리인 QQmlEngine::baseUrl()를 기준으로 확인됩니다.

[signal] void QQmlComponent::progressChanged(qreal progress)

컴포넌트의 로딩 진행률이 변경될 때마다 발생합니다. progress 현재 진행률은 0.0(아무것도 로드되지 않음)에서 1.0(완료) 사이입니다.

[slot] void QQmlComponent::setData(const QByteArray &data, const QUrl &url)

주어진 QML data 을 사용하도록 QQmlComponent 을 설정합니다. url 이 제공되면 컴포넌트 이름을 설정하고 이 컴포넌트에서 확인되는 항목의 기본 경로를 제공하는 데 사용됩니다.

void QQmlComponent::setInitialProperties(QObject *object, const QVariantMap &properties)

QQmlComponent 에서 생성된 object 의 최상위 수준 properties 을 설정합니다.

이 방법은 컴포넌트 인스턴스 생성에 대한 고급 제어 기능을 제공합니다. 일반적으로 프로그래머는 컴포넌트에서 객체 인스턴스를 생성할 때 QQmlComponent::createWithInitialProperties 을 사용해야 합니다.

beginCreate 이후 completeCreate 이 호출되기 전에 이 메서드를 사용하세요. 제공된 프로퍼티가 존재하지 않으면 경고가 표시됩니다.

이 메서드에서는 초기 중첩 프로퍼티를 직접 설정할 수 없습니다. 대신 중첩된 속성이 있는 값 유형 속성의 초기값을 설정하려면 해당 값 유형을 생성하고 중첩된 속성을 지정한 다음 생성할 객체의 초기 속성으로 값 유형을 전달할 수 있습니다.

예를 들어 fond.bold를 설정하려면 QFont 를 생성하고 가중치를 굵게로 설정한 다음 글꼴을 초기 속성으로 전달하면 됩니다.

[signal] void QQmlComponent::statusChanged(QQmlComponent::Status status)

컴포넌트의 상태가 변경될 때마다 발생하며 status 이 새 상태가 됩니다.