QQmlContext Class

멤버 함수 문서

QQmlContext::QQmlContext(QQmlContext *parentContext, QObject *parent = nullptr)

주어진 parentContext 과 QObject parent 을 사용하여 새 QQmlContext를 생성합니다.

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

engine 의 루트 컨텍스트와 QObject parent 의 하위 컨텍스트로서 새 QQmlContext를 생성합니다.

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

QQmlContext 를 파괴합니다.

이 컨텍스트에 종속된 모든 표현식 또는 하위 컨텍스트는 무효화되지만 파괴되지는 않습니다( QQmlContext 객체에 대한 부모가 아닌 경우).

QUrl QQmlContext::baseUrl() const

컴포넌트의 기본 URL을 반환하거나 설정된 것이 없는 경우 포함된 컴포넌트를 반환합니다.

setBaseUrl()도 참조하세요 .

QObject *QQmlContext::contextObject() const

컨텍스트 객체를 반환하거나 컨텍스트 객체가 없는 경우 nullptr 을 반환합니다.

setContextObject()도 참조하세요 .

QVariant QQmlContext::contextProperty(const QString &name) const

이 컨텍스트에 대한 name 속성 값을 QVariant 으로 반환합니다. 찾고자 하는 속성이 현재 컨텍스트에서 QML ID를 사용하여 할당된 QObject 인 경우 objectForName()를 사용하는 것이 더 편리하고 빠릅니다. objectForName () 및 nameForObject()와 달리 이 메서드는 컨텍스트 계층 구조를 통과하여 현재 컨텍스트에서 name 을 찾을 수 없는 경우 상위 컨텍스트에서 검색합니다. 또한 사용자가 설정했을 수 있는 contextObject()도 고려합니다.

setContextProperty(), objectForName(), nameForObject() 및 contextObject()도 참조하세요 .

QQmlEngine *QQmlContext::engine() const

컨텍스트의 QQmlEngine 또는 컨텍스트에 QQmlEngine 이 없거나 QQmlEngine 이 파괴된 경우 nullptr 을 반환합니다.

bool QQmlContext::isValid() const

컨텍스트가 유효한지 여부를 반환합니다.

컨텍스트가 유효하려면 엔진이 있어야 하며, 엔진이 있는 경우 contextObject()이 삭제되지 않아야 합니다.

QString QQmlContext::nameForObject(const QObject *object) const

이 컨텍스트에서 object 의 이름을 반환하거나 컨텍스트에 object 이름이 없는 경우 빈 문자열을 반환합니다. 개체의 이름은 setContextProperty() 또는 컨텍스트 개체의 속성으로 지정하거나 QML로 만든 컨텍스트의 경우 id로 지정합니다.

객체에 이름이 여러 개 있는 경우 첫 번째 이름이 반환됩니다.

contextProperty()와 달리 이 메서드는 컨텍스트 계층 구조를 통과하지 않습니다. 현재 컨텍스트에서 이름을 찾을 수 없는 경우 빈 문자열이 반환됩니다.

contextProperty() 및 objectForName()도 참조하세요 .

[since 6.2] QObject *QQmlContext::objectForName(const QString &name) const

이 컨텍스트에서 주어진 name 에 대한 객체를 반환합니다. 컨텍스트에서 name 을 사용할 수 없거나 name 과 연결된 값이 QObject 이 아닌 경우 nullptr을 반환합니다. 객체의 이름은 setContextProperty(), 컨텍스트 객체의 속성 또는 QML 생성 컨텍스트의 경우 ids로 지정됩니다. contextProperty ()와 달리 이 메서드는 컨텍스트 계층 구조를 통과하지 않습니다. 현재 컨텍스트에서 이름을 찾을 수 없으면 nullptr이 반환됩니다.

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

contextProperty() 및 nameForObject()도 참조하십시오 .

QQmlContext *QQmlContext::parentContext() const

컨텍스트의 부모 QQmlContext 또는 이 컨텍스트에 부모가 없거나 부모가 파괴된 경우 nullptr 을 반환합니다.

QUrl QQmlContext::resolvedUrl(const QUrl &src) const

포함된 컴포넌트의 URL을 기준으로 src URL을 확인합니다.

QQmlEngine::baseUrl() 및 setBaseUrl()도 참조하세요 .

void QQmlContext::setBaseUrl(const QUrl &baseUrl)

resolvedUrl()가 baseUrl 에 대한 상대 참조에 사용할 URL을 명시적으로 설정합니다.

이 함수를 호출하면 기본적으로 사용되는 포함 컴포넌트의 URL이 재정의됩니다.

baseUrl() 및 resolvedUrl()도 참조하세요 .

void QQmlContext::setContextObject(QObject *object)

컨텍스트 설정 object.

contextObject()도 참조하세요 .

void QQmlContext::setContextProperties(const QList<QQmlContext::PropertyPair> &properties)

이 컨텍스트에서 일괄적으로 properties 을 설정합니다.

모든 속성을 한 번에 설정하면 불필요한 새로 고침 표현식을 피할 수 있으므로 각 개별 속성마다 setContextProperty()를 호출하는 대신 이 방법을 사용하는 것이 좋습니다.

QQmlContext::setContextProperty()도 참조하세요 .

void QQmlContext::setContextProperty(const QString &name, QObject *value)

이 컨텍스트에서 name 속성의 value 을 설정합니다.

QQmlContext 는 value 의 소유권을 갖지 않습니다.

contextProperty()도 참조하세요 .

void QQmlContext::setContextProperty(const QString &name, const QVariant &value)

이 컨텍스트에 name 속성의 value 을 설정합니다.