QQmlListReference Class

QQmlListReference ref1(object, "children");

QQmlProperty ref2(object, "children");
QQmlListReference ref2 = qvariant_cast<QQmlListReference>(ref2.read());

멤버 함수 문서

QQmlListReference::QQmlListReference()

잘못된 인스턴스를 생성합니다.

[explicit, since 6.1] QQmlListReference::QQmlListReference(const QVariant &variant)

QQmlListProperty 을 포함하는 QVariant variant 에서 QQmlListReference 를 생성합니다. variant 에 목록 속성이 포함되어 있지 않으면 잘못된 QQmlListReference가 생성됩니다. 참조가 생성된 후 목록 속성을 소유한 객체가 소멸되면 자동으로 무효화됩니다. 즉, 객체가 삭제된 후에도 QQmlListReference 인스턴스를 보유해도 안전합니다.

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

QQmlListReference::QQmlListReference(QObject *object, const char *property)

object 의 property 에 대한 QQmlListReference 를 구축합니다. property 이 리스트 프로퍼티가 아닌 경우, 잘못된 QQmlListReference가 생성됩니다. 참조가 생성된 후 object 가 소멸되면 자동으로 유효하지 않게 됩니다. 즉, object 가 삭제된 후에도 QQmlListReference 인스턴스를 보유하는 것이 안전합니다.

bool QQmlListReference::append(QObject *object) const

object 을 목록에 추가합니다. 작업이 성공하면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

canAppend()도 참조하세요 .

QObject *QQmlListReference::at(qsizetype index) const

index 에서 목록 요소를 반환하거나 작업이 실패한 경우 0을 반환합니다.

canAt()도 참조하세요 .

bool QQmlListReference::canAppend() const

목록 속성을 추가할 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

append()도 참조하세요 .

bool QQmlListReference::canAt() const

목록 속성을 인덱스로 쿼리할 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

at()도 참조하세요 .

bool QQmlListReference::canClear() const

목록 속성을 지울 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

clear()도 참조하세요 .

bool QQmlListReference::canCount() const

목록 속성의 요소 수를 쿼리할 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

count()도 참조하세요 .

bool QQmlListReference::canRemoveLast() const

목록 속성에서 마지막 항목을 제거할 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

removeLast()도 참조하세요 .

bool QQmlListReference::canReplace() const

목록 속성의 항목을 바꿀 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 참조가 유효하지 않으면 false를 반환합니다.

replace()도 참조하세요 .

bool QQmlListReference::clear() const

목록을 지웁니다. 작업이 성공하면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

canClear()도 참조하세요 .

qsizetype QQmlListReference::count() const

목록에 있는 객체의 수를 반환하거나 연산에 실패한 경우 0을 반환합니다.

bool QQmlListReference::isManipulable() const

at(), count(), append(), clear() 또는 removeLast()가 구현되어 목록을 조작할 수 있는 경우 참을 반환합니다.

replace() 및 removeLast()는 모든 항목을 숨기고 clear() 및 append()를 사용하여 목록을 다시 작성하여 에뮬레이션할 수 있습니다. 따라서 목록을 조작할 수 있어야 하는 것은 아닙니다. 또한 clear()는 removeLast()를 사용하여 에뮬레이션할 수 있습니다.

isReadable(), at(), count(), append(), clear(), replace(), removeLast()도 참조하세요 .

bool QQmlListReference::isReadable() const

at() 및 count()이 구현되어 요소에 액세스할 수 있으면 true를 반환합니다.

isManipulable(), at() 및 count()도 참조하세요 .

bool QQmlListReference::isValid() const

인스턴스가 유효한 목록 속성을 참조하면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

const QMetaObject *QQmlListReference::listElementType() const

목록 속성에 저장된 요소에 대해 QMetaObject 또는 참조가 유효하지 않은 경우 nullptr 을 반환합니다.

QMetaObject 을 미리 사용하여 주어진 인스턴스를 목록에 추가할 수 있는지 여부를 확인할 수 있습니다. 생성 시 엔진을 전달하지 않은 경우 nullptr을 반환할 수 있습니다.

QObject *QQmlListReference::object() const

목록 속성의 객체를 반환합니다. 참조가 유효하지 않으면 nullptr 을 반환합니다.

bool QQmlListReference::removeLast() const

목록의 마지막 항목을 제거합니다. 작업이 성공하면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

canRemoveLast()도 참조하세요 .

bool QQmlListReference::replace(qsizetype index, QObject *object) const

목록의 index 항목을 object 으로 바꿉니다. 작업이 성공하면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

canReplace()도 참조하세요 .

[since 6.2] qsizetype QQmlListReference::size() const

목록에 있는 객체의 수를 반환하거나, 연산에 실패하면 0을 반환합니다.

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

bool QQmlListReference::operator==(const QQmlListReference &other) const

QQmlListReference 과 other 을 비교하여 같으면 true 을 반환합니다. 둘은 복사 할당 또는 복사 구성을 통해 한 쪽이 다른 쪽에서 생성된 경우에만 동일한 것으로 간주됩니다.