QQmlApplicationEngine Class

멤버 함수 문서

QQmlApplicationEngine::QQmlApplicationEngine(QObject *parent = nullptr)

지정된 ` parent`를 사용하여 새로운 `QQmlApplicationEngine`을 생성합니다. 나중에 QML 파일을 불러오려면 ` load()`를 호출해야 합니다.

QQmlApplicationEngine::QQmlApplicationEngine(const QString &filePath, QObject *parent = nullptr)

새로운 QQmlApplicationEngine을 생성하고, 지정된 filePath 위치에 있는 QML 파일을 불러옵니다. 이 경로는 로컬 파일이나 qrc 경로여야 합니다. 상대 경로가 지정된 경우, 해당 경로는 애플리케이션의 작업 디렉터리를 기준으로 해석됩니다.

이 기능은 편의성을 위해 제공되며, 빈 생성자를 사용한 후 load를 호출하는 것과 동일합니다.

QQmlApplicationEngine::QQmlApplicationEngine(const QUrl &url, QObject *parent = nullptr)

새로운 QQmlApplicationEngine을 생성하고, 지정된 url 경로의 QML 파일을 불러옵니다. 이는 편의상 제공되는 기능으로, 빈 생성자를 사용한 후 load를 호출하는 것과 동일합니다.

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

새로운 QQmlApplicationEngine을 생성하고, uri 및 typeName 에서 지정된 QML 유형을 로드합니다. 이는 편의성을 위해 제공되는 기능이며, 빈 생성자를 사용한 후 loadFromModule 를 호출하는 것과 동일합니다.

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

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

QQmlApplicationEngine 와 해당 객체가 로드한 모든 QML 객체를 삭제합니다.

[slot] void QQmlApplicationEngine::load(const QString &filePath)

filePath 에 위치한 루트 QML 파일을 불러옵니다. ` filePath `는 로컬 파일의 경로이거나 리소스 파일 시스템 내 파일의 경로여야 합니다. ` filePath `가 상대 경로인 경우, 애플리케이션의 작업 디렉터리를 기준으로 한 상대 경로로 간주됩니다. 해당 파일에 정의된 객체 트리는 즉시 인스턴스화됩니다.

오류가 발생하면 qWarning 을 통해 오류 메시지가 출력됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        qmlApplicationEngine, qOverload(&QQmlApplicationEngine::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        qmlApplicationEngine, [receiver = qmlApplicationEngine](const QString &filePath) { receiver->load(filePath); });

[slot] void QQmlApplicationEngine::load(const QUrl &url)

url 에 위치한 루트 QML 파일을 불러옵니다. 로컬 파일 URL의 경우, 해당 파일에 정의된 객체 트리가 즉시 생성됩니다. 원격 URL은 비동기적으로 불러오며, 객체 트리가 준비되었는지 확인하려면 objectCreated 신호를 수신 대기해야 합니다.

오류가 발생하면 objectCreated 신호가 null 포인터를 매개변수로 하여 발산되며, qWarning 를 통해 오류 메시지가 출력됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        qmlApplicationEngine, qOverload(&QQmlApplicationEngine::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        qmlApplicationEngine, [receiver = qmlApplicationEngine](const QUrl &url) { receiver->load(url); });

[slot] void QQmlApplicationEngine::loadData(const QByteArray &data, const QUrl &url = QUrl())

data 에 명시된 QML을 불러옵니다. data 에 정의된 객체 트리가 즉시 인스턴스화됩니다.

url 가 지정된 경우, 해당 URL이 컴포넌트의 기본 URL로 사용됩니다. 이는 데이터 및 오류 메시지 내의 상대 경로에 영향을 미칩니다.

오류가 발생하면 qWarning 를 사용하여 오류 메시지가 출력됩니다.

[slot, since 6.5] void QQmlApplicationEngine::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

uri 로 지정된 모듈에서 QML 타입 typeName 를 불러옵니다. 타입이 원격 URL에 위치한 QML 파일에서 유래한 경우, 해당 타입은 비동기적으로 불러옵니다. 객체 트리가 준비되었는지 확인하려면 objectCreated 신호를 수신해야 합니다.

오류가 발생하면 objectCreated 신호가 null 포인터를 매개변수로 하여 발산되며, qWarning 를 통해 오류 메시지가 출력됩니다.

QQmlApplicationEngine engine;
engine.loadFromModule("QtQuick", "Rectangle");

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

QQmlComponent::loadFromModule도 참조하십시오 .

[signal] void QQmlApplicationEngine::objectCreated(QObject *object, const QUrl &url)

이 신호는 객체의 로딩이 완료되었을 때 발생합니다. 로딩이 성공하면 ` object `에는 로딩된 객체에 대한 포인터가 포함되며, 그렇지 않은 경우 포인터는 `NULL`입니다.

또한 ` object `가 유래한 컴포넌트에 대한 ` url `도 제공됩니다.

[signal, since 6.4] void QQmlApplicationEngine::objectCreationFailed(const QUrl &url)

이 신호는 오류가 발생하여 로딩이 완료되었을 때 발생합니다.

로드에 실패한 컴포넌트의 url 가 인자로 제공됩니다.

QGuiApplication app(argc, argv);
QQmlApplicationEngine engine;

// exit on error
QObject::connect(&engine, &QQmlApplicationEngine::objectCreationFailed,
    &app, []() { QCoreApplication::exit(-1); }, Qt::QueuedConnection);
engine.load(QUrl());
return app.exec();

이 신호와 함께(생성이 실패했더라도) 발송되는 QQmlApplicationEngine::objectCreated 도 참조하십시오.

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

QList<QObject *> QQmlApplicationEngine::rootObjects() const

QQmlApplicationEngine 에 의해 인스턴스화된 모든 루트 객체의 목록을 반환합니다. 이 목록에는 load() 또는 편의 생성자를 통해 로드된 객체만 포함됩니다.

[slot, since 6.0] void QQmlApplicationEngine::setExtraFileSelectors(const QStringList &extraFileSelectors)

로컬 파일의 URL을 해결하는 데 사용되는 내부 ` QQmlFileSelector `에 전달될 ` extraFileSelectors `을 설정합니다. ` extraFileSelectors `은 첫 번째 QML 파일이 로드될 때 적용됩니다. 그 이후에 설정해도 아무런 효과가 없습니다.

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

QQmlFileSelector 및 QFileSelector::setExtraSelectors도 참조하십시오 .

[slot] void QQmlApplicationEngine::setInitialProperties(const QVariantMap &initialProperties)

QML 컴포넌트가 로드된 후 초기화될 때 사용되는 initialProperties 를 설정합니다.

QQmlApplicationEngine engine;

EventDatabase eventDatabase;
EventMonitor eventMonitor;

engine.setInitialProperties({
    { "eventDatabase", QVariant::fromValue(&eventDatabase) },
    { "eventMonitor", QVariant::fromValue(&eventMonitor) }
});

QQmlComponent::setInitialProperties, QQmlApplicationEngine::load 및 QQmlApplicationEngine::loadData도 참조하십시오 .