Repeater QML Type

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

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

속성

• count : int
• delegate : Component
• model : var

신호

• itemAdded(int index, Item item)
• itemRemoved(int index, Item item)

방법

• Item itemAt(index)

상세 설명

리피터 유형은 유사한 항목을 많이 만드는 데 사용됩니다. 다른 보기 유형과 마찬가지로 리피터에는 model 및 delegate: 모델의 각 항목에 대해 델리게이트가 모델의 데이터로 시드된 컨텍스트에서 인스턴스화됩니다. 리피터 항목은 일반적으로 Row 또는 Column 같은 포지셔너 유형으로 묶어 리피터에서 만든 여러 델리게이트 항목을 시각적으로 배치합니다.

다음 리피터는 Row 내에 Rectangle 항목의 인스턴스 세 개를 만듭니다:

import QtQuick

Row {
    Repeater {
        model: 3
        Rectangle {
            width: 100; height: 40
            border.width: 1
            color: "yellow"
        }
    }
}

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

리피터에 의해 인스턴스화된 항목은 순서대로 리피터 상위의 하위 항목으로 삽입됩니다. 삽입은 부모 스태킹 목록에서 리피터의 위치 바로 다음부터 시작됩니다. 이렇게 하면 레이아웃 내에서 리피터를 사용할 수 있습니다. 예를 들어, 다음 리피터의 항목은 빨간색 직사각형과 파란색 직사각형 사이에 쌓여 있습니다:

Row {
    Rectangle { width: 10; height: 20; color: "red" }
    Repeater {
        model: 10
        Rectangle { width: 20; height: 20; radius: 10; color: "green" }
    }
    Rectangle { width: 10; height: 20; color: "blue" }
}

리피터 사용 시 고려 사항

리피터 유형은 리피터가 처음 만들어질 때 모든 델리게이트 항목을 만듭니다. 이는 많은 수의 위임 항목이 있고 모든 항목을 동시에 표시할 필요가 없는 경우 비효율적일 수 있습니다. 이 경우에는 ListView (보기로 스크롤할 때만 델리게이트 항목을 만드는 보기 유형)와 같은 다른 보기 유형을 사용하거나 Dynamic Object Creation 메서드를 사용하여 필요한 만큼 항목을 만드는 것이 좋습니다.

또한 Repeater는 Item 기반이며 Item 파생 개체만 반복할 수 있다는 점에 유의하세요. 예를 들어, QtObject를 반복하는 데는 사용할 수 없습니다:

// bad code:
Item {
    // Can't repeat QtObject as it doesn't derive from Item.
    Repeater {
        model: 10
        QtObject {}
    }
}

속성 문서

Column {
    Repeater {
        model: 10
        Text {
            required property int index
            text: "I'm item " + index
        }
    }
}

Column {
    Repeater {
        model: ["apples", "oranges", "pears"]
        Text {
            required property string modelData
            text: "Data: " + modelData
        }
    }
}

신호 문서

메서드 문서