Repeater QML Type

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

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

プロパティ

• 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 アイテムのインスタンスを 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
        }
    }
}

シグナル・ドキュメント

メソッドのドキュメント