Back to Qt.io
Contact Us Blog Download Qt

Repeater3D QML Type

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

Import Statement: import QtQuick3D
Inherits:

Node

Inherited By:

InstanceRepeater

속성

신호

방법

상세 설명

Repeater3D 유형은 유사한 항목을 많이 생성하는 데 사용됩니다. 다른 보기 유형과 마찬가지로 Repeater3D에는 모델의 각 항목에 대해 model 및 delegate: 델리게이트가 모델의 데이터로 시드된 컨텍스트에서 인스턴스화됩니다.

리피터의 model 는 지원되는 데이터 모델 중 어느 것이든 될 수 있습니다. 또한 다른 보기의 델리게이트와 마찬가지로 리피터 델리게이트는 리피터 내의 인덱스와 해당 델리게이트와 관련된 모델 데이터에 액세스할 수 있습니다. 자세한 내용은 delegate 속성 설명서를 참조하세요.

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

참고: Repeater3D는 Node 기반이며 Node 파생 객체만 반복할 수 있습니다.

속성 문서

count : int [read-only]

이 속성은 모델에 있는 항목 수를 보유합니다.

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


delegate : Component [default]

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

대리인은 리피터 내에서 대리인의 인덱스를 나타내는 읽기 전용 index 프로퍼티에 노출됩니다.

model 이 모델 객체(예: ListModel)인 경우 델리게이트는 ListView 과 같은 뷰 클래스에 대해 델리게이트가 하는 것과 동일한 방식으로 모든 모델 역할에 명명된 프로퍼티로 액세스할 수 있습니다.

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


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


© 2025 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.