이 페이지에서

Repeater3D QML Type

제공된 모델을 사용하여 여러 Node 기반 컴포넌트를 인스턴스화합니다. 더 보기...

Import Statement: import QtQuick3D
Inherits:

Node

Inherited By:

InstanceRepeater

속성

신호

방법

상세 설명

Repeater3D 유형은 유사한 항목을 대량으로 생성하는 데 사용됩니다. 다른 뷰 유형과 마찬가지로 Repeater3D에는 model 과 delegate 이 있습니다. 모델의 각 항목에 대해, 델리게이트는 모델의 데이터가 초기화된 컨텍스트에서 인스턴스화됩니다.

Repeater의 model 는 지원되는 모든 데이터 모델 중 하나일 수 있습니다. 또한 다른 뷰의 델리게이트와 마찬가지로, Repeater 델리게이트는 Repeater 내의 인덱스는 물론 델리게이트와 관련된 모델 데이터에도 접근할 수 있습니다. 자세한 내용은 delegate 속성 문서를 참조하십시오.

참고: Repeater3D항목은 인스턴스화한 모든 항목을 소유합니다. Repeater3D에 의해 생성된 항목을 제거하거나 동적으로 파기하면 예측할 수 없는 동작이 발생할 수 있습니다.

참고: Repeater3D는 ` Node`을 기반으로 하며, ` Node`에서 파생된 객체만 반복할 수 있습니다.

속성 문서

count : int [read-only]

이 속성은 모델에 포함된 항목의 개수를 나타냅니다.

참고: ` Repeater3D `가 델리게이트를 인스턴스화하는 중이거나 잘못 설정된 경우, `count`가 보고하는 모델 내 항목수는 생성된 델리게이트의 수와 다를 수 있습니다.

delegate : Component [default]

델리게이트는 리피터에 의해 인스턴스화되는 각 객체를 정의하는 템플릿을 제공합니다.

델리게이트에는 리피터 내 델리게이트의 인덱스를 나타내는 읽기 전용 ` index ` 속성이 노출됩니다.

model 가 모델 객체(예: ListModel)인 경우, 델리게이트는 ListView 와 같은 뷰 클래스에 대해 델리게이트가 수행하는 방식과 마찬가지로 모든 모델 역할에 명명된 속성으로 액세스할 수 있습니다.

QML 데이터 모델항목도 참조하십시오 .

delegateModelAccess : enumeration [since 6.10]

이 속성은 델리게이트가 모델에 접근하는 방식을 결정합니다.

상수설명
DelegateModel.ReadOnly델리게이트가 컨텍스트 속성, ` model ` 객체 또는 필수 속성을 통해 모델에 쓰기 작업을 수행하는 것을 금지합니다.
DelegateModel.ReadWrite델리게이트가 컨텍스트 속성, ` model ` 개체 또는 필수 속성을 통해 모델에 쓰기 작업을 수행할 수 있도록 허용합니다.
DelegateModel.Qt5ReadWrite델리게이트가 model 객체 및 컨텍스트 속성을 통해 모델에 쓰기 작업을 수행할 수 있도록 허용하지만, 필수 속성을 통한 쓰기 작업은 허용하지 않습니다.

기본값은 DelegateModel.Qt5ReadWrite 입니다.

이 속성은 Qt 6.10에서 도입되었습니다.

Qt Quick 의 모델 및 뷰 #모델 데이터 변경항목도 참조하십시오 .

model : any

리피터에 데이터를 제공하는 모델입니다.

이 속성은 지원되는 데이터 모델 중 하나로 설정할 수 있습니다:

  • 리피터가 생성할 델리게이트의 수를 나타내는 숫자
  • 모델(예: ListModel 항목 또는 QAbstractItemModel 의 하위 클래스)
  • 문자열 목록
  • 객체 목록

모델의 유형에 따라 delegate 에 노출되는 속성이 달라집니다.

'데이터 모델'항목도 참조하십시오 .

신호 문서

objectAdded(int index, Object3D object)

이 신호는 리피터에 객체가 추가될 때 발생합니다. ` index ` 매개변수는 리피터 내에 객체가 삽입된 인덱스를 나타내며, ` object ` 매개변수는 추가된 ` Object3D ` 객체를 나타냅니다.

이에 해당하는 핸들러는 onObjectAdded 입니다.

참고: 해당 핸들러는 onObjectAdded 입니다.

objectRemoved(int index, Object3D object)

이 신호는 리피터에서 객체가 제거될 때 발생합니다. ` index ` 매개변수는 해당 항목이 리피터에서 제거된 인덱스를, ` object ` 매개변수는 제거된 ` Object3D `를 저장합니다.

이 리피터에 의해 생성된 object 에 대한 참조를 유지하지 마십시오. 이러한 경우 신호가 처리된 직후 해당 객체가 삭제되기 때문입니다.

해당 핸들러는 onObjectRemoved 입니다.

참고: 해당 핸들러는 onObjectRemoved 입니다.

메서드 문서

Object3D objectAt(index)

지정된 index 에 생성된 Object3D 를 반환하거나, index 에 해당 항목이 존재하지 않을 경우 null 를 반환합니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.