Instantiator QML Type

개체를 동적으로 생성합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• active : bool
• asynchronous : bool
• count : int
• delegate : QtQml::Component
• delegateModelAccess : enumeration (since 6.10)
• model : variant
• object : QtObject

신호

• objectAdded(int index, QtObject object)
• objectRemoved(int index, QtObject object)

방법

• QtObject objectAt(int index)

상세 설명

인스턴티베이터는 객체의 동적 생성을 제어하거나 템플릿에서 여러 객체를 동적으로 생성하는 데 사용할 수 있습니다.

인스턴스화 요소는 생성하는 객체를 관리합니다. 이러한 객체는 인스턴시레이터의 부모가 되며 인스턴시레이터의 속성이 변경되면 인스턴시레이터에 의해 삭제될 수도 있습니다. 객체는 다른 수단을 통해 동적으로 파괴할 수도 있으며, 인스턴시터의 속성이 변경되지 않는 한 인스턴시터는 객체를 다시 생성하지 않습니다.

속성 문서

active : bool

active가 true이고 델리게이트 컴포넌트가 준비되면 인스턴스화기는 모델에 따라 객체를 생성합니다. active가 false이면 오브젝트가 생성되지 않으며 이전에 생성된 모든 오브젝트가 소멸됩니다.

기본값은 참입니다.

asynchronous : bool

비동기가 참이면 인스턴티베이터는 객체를 비동기적으로 생성하려고 시도합니다. 즉, 활성화가 true로 설정되어 있어도 개체를 즉시 사용할 수 없을 수 있습니다.

objectAdded 신호를 사용하여 생성 중인 항목에 응답할 수 있습니다.

기본값은 false입니다.

count : int [read-only]

인스턴스화자가 현재 관리하고 있는 오브젝트 수입니다.

delegate : QtQml::Component [default]

모든 객체를 생성하는 데 사용되는 컴포넌트입니다.

델리게이트의 인스턴스 내부에서 추가 변수인 index를 사용할 수 있습니다. 이 변수는 인스턴시터 내부의 인스턴스 인덱스를 참조하며, 인스턴시터의 objectAt 메서드를 통해 객체를 가져오는 데 사용할 수 있습니다.

이 속성을 변경하면 이전 델리게이트를 사용하는 모든 인스턴스가 소멸되고 새 델리게이트를 사용하여 새 인스턴스가 생성됩니다.

delegateModelAccess : enumeration [since 6.10]

이 속성은 델리게이트가 모델에 액세스할 수 있는 방법을 결정합니다.

기본값은 DelegateModel.Qt5ReadWrite 입니다.

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

Qt Quick#모델데이터 변경하기의모델 및 뷰도참조하세요 .

model : variant

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

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

모델 유형은 delegate 에 노출되는 프로퍼티에 영향을 줍니다.

기본값은 1로, 단일 델리게이트 인스턴스를 만듭니다.

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

object : QtObject [read-only]

이것은 처음 생성된 객체에 대한 참조로, 객체가 하나만 생성된 경우의 편의를 위한 것입니다.

신호 문서

objectAdded(int index, QtObject object)

이 신호는 객체가 인스턴티베이터에 추가될 때 발생합니다. index 파라미터는 객체에 부여된 인덱스를, object 파라미터는 추가된 QtObject 을 보유합니다.

objectRemoved(int index, QtObject object)

이 신호는 인스턴시에이터에서 객체가 제거될 때 발생합니다. index 파라미터는 객체에 부여된 인덱스를, object 파라미터는 제거된 QtObject 을 보유합니다.

이 인스턴티에이터에 의해 생성된 object 참조는 신호가 처리된 직후 삭제되므로 유지하지 마세요.

메서드 문서

QtObject objectAt(int index)

주어진 index 을 사용하여 객체에 대한 참조를 반환합니다.