Repeater QML Type

提供されたモデルを使用して、いくつかのItemベースのコンポーネントをインスタンス化します。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

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

シグナル

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

メソッド

• Item itemAt(index)

詳細説明

Repeaterタイプは、多数の類似したアイテムを作成するために使用されます。model delegateモデルの各エントリに対して、デリゲートはモデルからのデータでシードされたコンテキストでインスタンス化されます。リピータによって作成される複数のデリゲート項目を視覚的に配置するために、リピータ項目は通常、Row やColumn などのポジショナ型で囲まれます。

次のリピータは、Row 内にRectangle アイテムのインスタンスを 3 つ作成します：

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
        }
    }
}

シグナル・ドキュメント

メソッドのドキュメント