QQmlContext Class

멤버 함수 문서

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

주어진 ` parentContext`와 ` QObject `( parent)를 사용하여 새로운 `QQmlContext`를 생성합니다.

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

engine 의 루트 컨텍스트 아래에 새로운 QQmlContext를 생성하고, QObject parent 를 설정합니다.

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

QQmlContext 를 파기합니다.

이 컨텍스트에 의존하는 모든 표현식이나 하위 컨텍스트는 무효화되지만, 삭제되지는 않습니다( QQmlContext 객체의 자식인 경우는 제외).

QUrl QQmlContext::baseUrl() const

컴포넌트의 기본 URL을 반환하며, 기본 URL이 설정되어 있지 않은 경우에는 해당 컴포넌트를 감싸고 있는 상위 컴포넌트를 반환합니다.

setBaseUrl()도 참조하십시오 .

[since 6.11] QList<QQmlContext *> QQmlContext::childContexts() const

컨텍스트의 직계 자식 QQmlContexts를 반환합니다.

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

parentContext(), findObjectRecursively() 및 findObjectsRecursively()도 참조하십시오 .

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 `를 반환합니다.

[since 6.11] QObject *QQmlContext::findObjectRecursively(const QString &id) const

이 컨텍스트와 그 하위 컨텍스트를 재귀적으로 검색하여 ID가 id 인 객체를 찾습니다. 해당 객체가 발견되면 그 객체를 반환합니다. 그렇지 않은 경우 nullptr 를 반환합니다.

주어진 컨텍스트 내에서 지정된 id 을 가진 객체는 단 하나만 존재할 수 있지만, 하나의 문서 내에서 뷰(views)나 델리게이트(delegates) 등을 통해 여러 개의 컨텍스트를 생성할 수 있습니다. 이러한 각 컨텍스트는 지정된 id 을 가진 객체를 포함할 수 있습니다. 여기서는 가장 먼저 발견된 객체만 반환됩니다. 검색은 폭우선 탐색(breadth-first search) 방식으로 수행됩니다.

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

findObjectsRecursively(), objectForName(), childContexts()도 참조하십시오 .

[since 6.11] QList<QObject *> QQmlContext::findObjectsRecursively(const QString &id) const

이 컨텍스트와 그 자식 노드를 재귀적으로 검색하여 ID가 id 인 객체를 찾습니다. 해당 객체들의 목록을 반환합니다.

주어진 컨텍스트 내에서는 지정된 id 를 가진 객체가 하나만 존재할 수 있지만, 예를 들어 뷰(views)나 델리게이트(delegates)를 통해 하나의 문서 내에 여러 개의 컨텍스트를 생성할 수 있습니다. 이러한 각 컨텍스트는 지정된 id 를 가진 객체를 포함할 수 있습니다.

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

findObjectRecursively(), objectForName(), childContexts()도 참조하십시오 .

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로 생성된 컨텍스트의 경우 ID를 통해 지정됩니다. contextProperty()와 달리, 이 메서드는 컨텍스트 계층 구조를 탐색하지 않습니다. 현재 컨텍스트에서 이름을 찾을 수 없는 경우 nullptr이 반환됩니다.

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

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

QQmlContext *QQmlContext::parentContext() const

컨텍스트의 상위 객체 QQmlContext 를 반환하거나, 해당 컨텍스트에 상위 객체가 없거나 상위 객체가 소멸된 경우에는 nullptr 를 반환합니다.

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

src URL을 해당 컴포넌트의 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 `을 설정합니다.